Hermes Atlas
Desktop apps, web UIs & dashboards

Hermes Mobile

goncharik/hermes-mobile

Native SwiftUI iPhone and iPad client for a self-hosted Hermes Agent

In short

Hermes Mobile is a native SwiftUI iPhone and iPad app that works as a thin remote client for a self-hosted Hermes Agent, letting you chat with sessions, watch the agent work and approve or clarify its actions away from your desk.

What Hermes Mobile does

The agent keeps running on your Mac or server, and the app holds no agent logic. You enter the server URL and sign in with a username and password under gated auth (the recommended setup), through OAuth with Nous Research or your own OIDC server, or with a static token for loopback or --insecure setups. Credentials are stored in the iOS Keychain, and an unreachable server produces a retry screen that names the server instead of a sign-in form.

Sessions are grouped by workspace and can be searched, pinned, renamed, archived or deleted. A header pill switches Hermes profiles, each with its own session list, and custom profiles can be created with an optional SOUL.md. Streaming responses render as Markdown with tool and skill activity rows. The composer supports voice dictation transcribed by the agent, photo and file attachments, a queue for the next prompt, slash commands such as /compress, /undo and /status, and a pill showing context usage. The app is built with The Composable Architecture.

Key features

  • Sign-in with gated username and password, OAuth/OIDC or a static token
  • Sessions grouped by workspace with search, pinning, renaming and archiving
  • Profile switcher with optional SOUL.md for new profiles
  • Streaming Markdown with tool and skill activity rows
  • Voice dictation, attachments, queued prompts and slash commands
  • Context usage pill in the composer

When to use it

  • Approving or clarifying an agent action from your phone while it keeps working on your server
  • Resuming a Hermes session from an iPad after leaving your desk
  • Dictating a task to a home-server Hermes agent over a VPN or Tailscale

Who it is for: Hermes Agent users with an iPhone or iPad who run their agent on a Mac or server.

How it fits with Hermes Agent

Built for Hermes Agent as a remote client for a self-hosted instance, with no agent logic on the device.

Requirements: A self-hosted Hermes Agent that the device can reach, and an iPhone or iPad

FAQ

What is Hermes Mobile?

Hermes Mobile is a native SwiftUI app for iPhone and iPad that acts as a companion to a self-hosted Hermes Agent. The agent runs on your own machine and the app is a window into it.

Does Hermes Mobile work with Hermes Agent?

Yes, it is built as a thin remote client for a self-hosted Hermes Agent. It supports multiple Hermes profiles and the agent's slash commands.

What do I need to run Hermes Mobile?

You need an iPhone or iPad and a self-hosted Hermes Agent that the device can reach. If the agent is unreachable at launch, for example because a VPN or Tailscale is off, the app shows a retry screen.

Similar interfaces for Hermes Agent

All interfaces

Related guides: Connect Hermes agents on several machines with Hermes Desktop · How to install Hermes Agent