Drive your self-hosted Hermes agent from your iPhone.
Chat with sessions, watch the agent work in real time, and approve or clarify its actions — all from your pocket, while the real runtime stays on your Mac or server.
Native SwiftUI · The Composable Architecture · no agent logic on the phone
Hermes Mobile is a thin remote client for a self-hosted Hermes Agent. The agent keeps running on your machine; the phone is a window into it — so you can step away from your desk and still keep your agent moving.
- Connect once. Enter your server URL and sign in the way your agent is configured:
a static token (loopback/
--insecure), or a username and password when the server runs gated auth. The app detects which methods the server offers and shows the right fields. Credentials live in the iOS Keychain and the app auto-logs-in on launch; if a gated session expires while you're using it, a quick re-auth prompt gets you back in without losing your place. - Find any session. Browse sessions grouped by workspace, search across all of them, pin the ones you care about, rename or archive them, and resume or start a new one.
- Switch profiles. Keep multiple Hermes profiles on one agent and switch between them from a Safari-style header pill — each profile has its own scoped session list, and new chats are created under the selected one. Create custom profiles (with an optional SOUL.md) right from the app.
- Watch it work. Streaming responses render as native Markdown, with tool/skill activity rows (tap for args, results, and diffs), a live "Thinking" indicator with an elapsed timer that collapses into a reviewable reasoning + status disclosure when the turn ends, and a subtle glow on sessions that are actively running.
- Compose hands-free or with files. Dictate a message with voice input (a live waveform while recording; transcribed by your agent), and attach photos, camera captures, PDFs, or any file straight from the composer.
- See how full the context is. A color-coded pill in the composer shows used/max tokens and percent (mirroring the Hermes TUI thresholds); tap it for a breakdown of input/output split, compactions, and estimated cost.
- Copy what you need. Copy a whole message, or just a single code block with a one-tap button and a green-check confirmation.
- Approve from anywhere. The mobile-native payoff: respond to approval, clarify,
and
sudo/secretprompts the moment they arrive. - Stays connected. Automatic reconnect with backoff and a clear connection banner when the link drops. Reopening a session — after navigating away, backgrounding the app, or a cold relaunch — restores its live state: the right model, context usage, full tool/thinking history, and an in-progress turn that keeps streaming with its timer ticking.
You'll need macOS with Xcode 26+, Tuist (brew install tuist), and a running
Hermes Agent reachable from your Mac.
1. Expose Hermes to your network. On the Hermes machine, bind to all interfaces and set a stable token. The trust boundary is your private network (e.g. Tailscale):
hermes ... --host 0.0.0.0 --insecure
export HERMES_DASHBOARD_SESSION_TOKEN=<your-stable-secret>
⚠️ --insecureexposes the dashboard with only token auth — do this only behind a private VPN like Tailscale, never on the open internet.
2. Build and run the app:
make run # builds and launches on a simulator — no signing needed3. Connect. Open the app and enter your server URL (e.g.
http://<tailnet-host>:9119). If your agent runs with --insecure (above), pick
Token and paste the secret from step 1. If it runs gated auth, pick Password and
enter your username and password. That's it — you're in.
To run on a physical device, see docs/development.md.
- Architecture — how the app is structured, the TCA feature tree, dependency clients, and the wire protocol.
- Development — building, running on device, testing, snapshots, and TestFlight distribution.
The MVP is feature-complete and shipping to TestFlight — the full loop (connect, browse/search/resume/create, stream, approve/clarify) is built and covered by unit and SwiftUI snapshot tests. It's a personal tool first, designed to run over a private network.
MIT © Eugene Honcharenko