What's fixed
The packaged app now honours CLI arguments. --session, --host, --port and --home
were silently ignored whenever the tray icon came up — which is every desktop GUI session.
companion.py only forwarded arguments on the headless fallback path, and the tray entry
point never looked at argv at all. So hermes-companion --session <id> showed the pairing
QR instead of the handoff QR (#1), and --host <vpn-ip> had no effect.
With this release:
hermes-companion --session <session_id>→ the browser console shows the handoff QR
(scanning it pairs the phone and hands over that conversation).hermes-companion --host 100.x.x.x→ binds and advertises that address, for pairing over
a VPN / Tailscale instead of the LAN IP.
One-click Hermes companion apps (no Python needed).
- macOS — open hermes-companion-macos.dmg, drag Hermes Companion
to Applications, then open it from Applications. First launch:
right-click → Open (unsigned app; one-time Gatekeeper approval).
To reinstall: quit the running one first (menu-bar icon → Quit). - Windows — unzip, double-click hermes-companion.exe. If SmartScreen
appears: More info → Run anyway. - Linux — unzip, then run hermes-companion.AppImage
(chmod +xif your browser cleared the executable bit).
The app starts the broker and opens the local browser console automatically;
scan the QR with the Hermes phone app to connect. Runs in the menu bar / tray.