Hermes-Deck / hermes-deck

# Hermes Deck
Hermes Deck is a desktop app for Hermes Agent. It lets you chat with
your Hermes agents, see what they are doing right now (thinking, tools, sub-agents), steer or stop them, and keep an
eye on usage and subscription limits, all from one window on your Windows or macOS computer. It connects to the
Hermes instance you already run, over SSH, WSL or locally, through a small Hermes plugin. An optional relay on the
Hermes host adds a live view of every agent, host-wide usage, and letting agents use a browser or one window on your
computer, both off until you allow them. Telegram is optional.
 Needs you : approvals and questions from every agent in one inbox 
 Bot Chat : every profile has its own chat and personality 
 Telegram mode : your account, your bots, your group topics 
 Desktop control : watch an agent work in one window, take control any time 
 Agent browsers : the agent's own browser tab, live on your device 
 Themes : dark, light and OLED themes, wallpapers, reading preferences 
## Features
| Feature | What it does | Needs relay? | Needs Telegram? |
|---|---|---|---|
| Sessions | Browse, search and continue every Hermes session from every profile and platform | No | No |
| Bots and Bot Chat | One chat per Hermes profile, with its face, state and routines | Routines only | No |
| Telegram mode | Your bot DMs and one forum group's topics, inside Deck | For live activity | Yes |
| Live activity | Thinking, current tool, sub-agents; queue, steer, interrupt, stop, take over | For the all-agents view | No |
| Attachments, voice and drafts | Files, window captures, voice notes, dictation transcribed by Hermes, per-chat drafts | No | No |
| Model and reasoning pickers | Change the model or reasoning effort for one session | No | No |
| Usage and quotas | Tokens, cost and cache use over 24h–All; Claude/Codex limits; gateway health | Yes | No |
| Notifications, pet, themes | OS notifications, taskbar badge, status pet, themes, English/Turkish | No | No |
| Agent browsers | Watch an agent's browser live, take control, hand it back | Yes | No |
| Desktop control | Let an agent use one window you hand over, with Stop always available | Yes | No |
| Agent spaces | Each agent on its own Linux desktop (or taking turns on a shared one); watch or join in, approve risky commands, undo changes | Yes | No |
Details of each feature, what it needs and where its settings are: docs/features.md.
## How it fits together
 [code] 
| Part | Runs on | Source |
|---|---|---|
| Hermes plugin | The Hermes host, inside each Hermes profile | hermes-plugin/hermes-deck |
| Relay (optional) | The Hermes host | relay, guide: docs/relay.md |
| Desktop app | Your Windows or macOS computer | app |
More: docs/architecture.md.
## Install
### Option A: give it to your Hermes
Hermes Deck ships a setup skill that your own Hermes agent can follow on its host. Give your agent this prompt:
> Install Hermes Deck on this host from https://github.com/Hermes-Deck/hermes-deck. Use i