Mercury

What Mercury does

Mercury connects to an unchanged Hermes Agent backend supplied by hermes dashboard or headless hermes serve. It browses projects and sessions, streams replies token by token over a direct WebSocket with tool activity and reasoning shown inline, and lets you answer tool approvals, clarify questions and secret prompts from the phone. Artifacts and host files the agent produced open natively, and images, PDFs and text can be shared into a session from other apps.

For access it supports native Nous OAuth with system-browser PKCE, cookie-backed username and password auth, and a Mercury Relay option that pairs by QR code for end-to-end encrypted Noise XK chat when a direct server origin is unreachable. Voice features appear only when the server exposes the official /api/audio routes. Android shows a foreground-service notification when a turn finishes, while iOS uses best-effort local notifications. The Android UI adapts to foldables, split screen and DeX.

Key features

• Token-by-token streaming with tool activity and reasoning shown inline
• Tool approvals, clarify questions and secret prompts answered from the phone
• Native rendering of artifacts, images and documents the agent produced
• Share-sheet intake of images, PDFs and text into a session
• Nous OAuth, basic auth and an encrypted QR-paired relay
• Hands-free voice conversation when the server exposes the audio routes

When to use it

• Starting a long agent run, locking the phone and getting notified when it finishes
• Approving a tool request from a phone while away from the desk
• Reaching a self-hosted Hermes server that is not directly reachable, through the relay

Who it is for: Hermes Agent users who want to follow and control their agent sessions from an Android or iOS phone.

How it fits with Hermes Agent

It is a client built for Hermes Agent that uses only the official Hermes interfaces, needing no server changes, custom builds or plugins.

Requirements: A Hermes Agent backend from hermes dashboard or hermes serve, either Hermes Cloud or self-hosted, and an Android device or an iOS build from source.

Note: Mercury is unofficial and not affiliated with or endorsed by Nous Research, and the iOS app has to be built from source.

FAQ