What is Hermes-Relay?

Hermes-Relay is a native Android app for Hermes Agent. Chat with your agent, manage sessions, and — in future phases — control your phone via the device bridge and access a remote terminal.

Quick Install

curl -fsSL https://raw.githubusercontent.com/Codename-11/hermes-relay/main/install.sh | bash

This installs the server-side plugin. One command, full features — sessions browser, conversation history, personality picker, command palette, memory management, and the WSS relay for terminal/voice all work out of the box on any standard hermes-agent install. Grab the Android app from GitHub Releases, then either type /hermes-relay-pair in any Hermes chat surface or run hermes-pair from a shell to generate a pairing QR. See Installation & Setup for the full walkthrough.

To uninstall later:

bash ~/.hermes/hermes-relay/uninstall.sh

Or via curl if the clone is already gone:

curl -fsSL https://raw.githubusercontent.com/Codename-11/hermes-relay/main/uninstall.sh | bash

The uninstaller is idempotent and never touches state shared with other Hermes tools. Flags: --dry-run, --keep-clone, --remove-secret.

Connection Model

Phone (HTTP/SSE) → Hermes API Server (:8642)   [chat — direct]
Phone (WSS)      → Relay Server (:8767)          [bridge, terminal — future]

Chat connects directly to the Hermes API Server using the Sessions API with SSE streaming. The relay server handles bridge and terminal channels only.

Current Status — v0.4.0

Feature	Status
Chat (direct API)	Complete
Session management	Complete
Markdown + syntax highlighting	Complete
Reasoning display	Complete
Personality picker + agent name on bubbles	Complete
Command palette + inline autocomplete	Complete
QR code pairing	Complete
Token tracking	Complete
Tool progress cards (Off/Compact/Detailed)	Complete
In-app analytics (Stats for Nerds)	Complete
Animated splash screen	Complete
Terminal (remote shell)	Beta (sideload track)
Bridge (device control)	Beta (sideload track)

Quick Links

• Installation & Setup — Get the app running
• Chat Guide — Using the chat interface
• Sessions — Managing conversations
• Features — All features at a glance
• Architecture — How it works under the hood