Hermes Atlas
Desktop apps, web UIs & dashboards

Hermes Deck

TNJ2026/hermes-deck

Native macOS SwiftUI client that chats with Hermes, Hermes profiles and external coding agents

In short

Hermes Deck is a native macOS chat client for the Hermes agent backend that also routes messages to Codex, Claude, Gemini and other Hermes profiles.

What Hermes Deck does

Hermes Deck is a SwiftUI app for macOS 14 or later that talks to a locally installed Hermes agent over a JSON-RPC TUI gateway on stdio. In the chat you can @mention another agent to route a message inline: @codex uses Codex over the Agent Client Protocol, @claude uses the Claude CLI, @gemini calls agy in single-shot print mode, and any Hermes profile can be addressed by name.

Agents can hand work to one another through a built-in deck_delegate_agent Hermes tool, with a fenced AgentRouting block as the fallback. The Deck forwards the request, feeds the reply back and shows a live status card under the triggering message. A right-hand sidebar holds a Kanban board, scheduled cron jobs, per-agent panels and settings. Past Hermes sessions are read from the backend SQLite database and can be reopened, installed Hermes tools and skills can be toggled, and dictation uses SFSpeechRecognizer.

Key features

  • @mention routing to Codex, Claude, Gemini or any Hermes profile
  • Agent-to-agent delegation through the deck_delegate_agent tool
  • Switching between Hermes profiles such as default, coding and research
  • Session history read from the Hermes SQLite database
  • Kanban board and scheduled cron job panels
  • Voice dictation with a selectable recognition language

When to use it

  • Driving Hermes, Codex and Claude from a single macOS chat window
  • Browsing and reopening past Hermes sessions
  • Switching between Hermes profiles for coding and research work

Who it is for: Mac users who run Hermes and want a native chat app that can also reach other coding agents.

How it fits with Hermes Agent

It is a client for a local Hermes agent backend installed at ~/.hermes/hermes-agent, and it adds a deck_delegate_agent tool to Hermes.

Requirements: macOS 14.0 or later, a Hermes agent backend at ~/.hermes/hermes-agent, sqlite3 at /usr/bin/sqlite3; for external agents, Node/npx, the Claude CLI and agy on PATH as needed

FAQ

What is Hermes Deck?

Hermes Deck is a native macOS SwiftUI app that gives the local Hermes agent and a set of external coding agents a chat-first interface with session history, side panels and voice input.

Does Hermes Deck work with Hermes Agent?

Yes. It talks to a locally installed Hermes agent backend and can address individual Hermes profiles. It also adds a deck_delegate_agent tool that you install from the app's Tools page.

What do I need to run Hermes Deck?

You need macOS 14.0 or later, a Hermes agent backend at ~/.hermes/hermes-agent and sqlite3 at /usr/bin/sqlite3. Codex, Claude and Gemini routing need Node/npx, the Claude CLI and agy respectively.

Similar interfaces for Hermes Agent

All interfaces

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