Wings

From its catalog listing

A private WireGuard network between every Hermes you own and your phone. Two devices are enough: run setup on a computer, scan one code on the phone. Bots and sessions from all your machines in Desktop, the terminal and the Hermes app. Computers link directly when they can. No account, no coordination server, no third party.

Good to know before installing

Wings asks for admin rights once per machine and installs a root helper (/usr/local/libexec/wings-root) with always-on systemd units (wings-sync, wings-watch, wings-relay, wings-address, wings-dns), a WireGuard interface wings0, an nftables table, firewalld/ufw rules, a wings-net system user, a marked /etc/hosts line and a private certificate authority trusted system-wide but limited to .wings names; it may install wireguard-tools and nftables from your package manager and downloads wstunnel 11.1.0 from its official GitHub release (checksum-pinned). It also adds a per-user wings-upkeep timer that runs every minute, installs and starts the Hermes gateway service, and sets webapp.enabled and webapp.public_url in config.yaml. Every device you pair can sign in to Hermes on every machine in your wing net without a password (full dashboard and terminal access), and every joined computer holds the shared wing-net key; turn this off per machine with `hermes wings trust off`. The Wings page lists the bots and recent session titles of every Hermes profile on each of your machines. A hub opens one UDP port (plus TCP 443 for the optional HTTPS relay), and `hermes wings router open` asks your router over UPnP to forward it.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install wings
  2. Said no? Turn it on later:
    hermes plugins enable wings
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Security & privacy
Maintained by
e-shizz (Community)
Needs
No API keys declared
Adds tools
wings_status
Works on
linux
Needs Hermes
0.23.0 or newer
Version
0.3.1
In the catalog
2026-11-14

Known issues (from its catalog listing)

  • Asks for admin rights once per machine to install a root helper. Read plugin/root/wings-root.sh first.
  • Trusts a private certificate authority system-wide, limited to .wings names.
  • Devices connect to the computer you ran setup on (the hub). To reach a hub at home from outside, one UDP port must be forwarded on the router.
  • Computers link directly when their networks allow it and otherwise go through the hub. Phones always do.
  • Phones run one VPN at a time, so the Wings tunnel replaces any other while it is on.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in security & privacy

All security & privacy plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins