Hermes Phone Remote: app and UI for Hermes Agent

Hermes desktop plugin that shows a QR code so you can keep chatting with Hermes from your phone

What Hermes Phone Remote does

The plugin reuses the stock Hermes dashboard instead of adding its own backend. The phone loads the dashboard, started with hermes dashboard --host 0.0.0.0 --port 9119, and chat runs over the dashboard's /api/pty WebSocket. LAN mode opens the PC's address on port 9119 over the same Wi-Fi after a one-time password login. Internet mode starts a Cloudflare quick tunnel through cloudflared and shows a public trycloudflare.com address, which you reach by scanning a one-shot pairing token instead of typing a password.

Internet mode has safety rails: the address is random, the plugin refuses to open a public link unless a dashboard password is set, a two-step confirmation is required, and the tunnel closes itself after two hours unless extended. Pairing QR codes renew when the 10-minute token expires. The README documents dashboard auth pitfalls and notes that the stock dashboard's mobile portrait layout is not adapted, so landscape works better. Version 0.3.0 is described as working and verified end to end. It is MIT licensed.

Key features

Connect phone entry in the Hermes desktop app with a pairing QR code
LAN mode with a one-time dashboard login
Internet mode through a Cloudflare quick tunnel and a one-shot pairing token
Self-closing tunnel after two hours, with a one-click stop
Reuses the stock dashboard, with no separate backend service

When to use it

Continuing a Hermes conversation from your phone while away from the desk
Reaching your home PC's Hermes from mobile data without opening router ports
Pairing a phone quickly by scanning a code instead of typing a password

Who it is for: Hermes Desktop users who want phone access to their local agent without paying for a hosted remote service.

How it fits with Hermes Agent

Built for Hermes Agent as a desktop plugin that reuses the official Hermes dashboard and its /api/pty chat transport.

How to install Hermes Phone Remote

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

python scripts/build_plugin.py --install
scripts\start_dashboard.bat

Requirements: Hermes desktop app, a dashboard reachable from the phone, a dashboard password and cloudflared for internet mode, and an inbound firewall rule for port 9119

FAQ

What is Hermes Phone Remote?

Hermes Phone Remote is a Hermes desktop plugin that shows a QR code so you can open the Hermes dashboard on your phone and keep chatting with your agent. It adds no extra service or custom backend.

How does Hermes Phone Remote connect my phone?

In LAN mode the phone opens the PC's dashboard address on port 9119 over the same Wi-Fi and logs in once. In internet mode it uses a Cloudflare quick tunnel and a one-shot pairing token from the QR code.

How long does an internet tunnel stay open?

The tunnel closes on its own after 2 hours, although you can extend it, and there is a one-click stop. The plugin also refuses to open a public link unless a dashboard password is set.