Maintainer of this skill?
by Hermes-Deck
An application to manage your Hermes agents. Available on Windows, macOS and iOS (soon).
# Add to your Claude Code skills
git clone https://github.com/Hermes-Deck/hermes-deckSee how hermes-deck compares with popular alternatives.
hermes-deck is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Hermes-Deck. An application to manage your Hermes agents. Available on Windows, macOS and iOS (soon). It has 50 GitHub stars.
hermes-deck's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/Hermes-Deck/hermes-deck" and add it to your Claude Code skills directory (see the Installation section above).
hermes-deck is primarily written in JavaScript. It is open-source under Hermes-Deck on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh hermes-deck against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
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.
| 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.
Hermes + Deck plugin ←── SSH / WSL / local ──→ Deck app
│ events + state ↕
└────────→ optional relay ←─ token ────→ app
↕
optional Telegram
| 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.
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 its skills/hermes-deck-setup skill. Ask me before changing any profile or starting services.
The skill checks your Hermes installation, shows the plugin installer's plan before applying it, optionally sets up the relay, and prints the values to enter in the app. It asks before every change and never restarts a busy gateway. Your agent can read it from a clone, or you can install it into Hermes first:
hermes skills install Hermes-Deck/hermes-deck/skills/hermes-deck-setup
To check a host at any time, run the read-only doctor from a clone with Hermes' Python:
<hermes-python> scripts/doctor.py (--json for agents, --home <hermes-home>, --relay http://<relay-host>:9330).
Details and the manual equivalent: docs/install-with-hermes.md.
Then install the desktop app (step 2 below) and complete its first-start setup (step 3).
1. Install the plugin on the Hermes host. From a clone of this repository, with Hermes' own Python (the interpreter of your Hermes installation):
cd hermes-plugin/hermes-deck
<hermes-python> install.py --dry-run # shows the plan, changes nothing
<hermes-python> install.py
The installer backs up each changed config.yaml, enables hermes-deck in the selected profiles (--profile NAME,
default: all) and writes the direct-connection entry point to <Hermes home>/hermes-deck/stream.py (normally
~/.hermes/hermes-deck/stream.py). Restart each affected gateway only when its foreground and background work has
finished; a restart also ends background sub-agents. Options: plugin README.
2. Install the desktop app. Download from Releases:
| System | File |
|---|---|
| Windows x64 | Hermes-Deck-<version>-Setup.exe (recommended) or Hermes-Deck-<version>-win-x64.zip |
| macOS Apple Silicon | Hermes-Deck-<version>-mac-arm64.dmg |
| macOS Intel | Hermes-Deck-<version>-mac-x64.dmg |
Builds are not code-signed (macOS builds are ad-hoc signed, not notarized). Check the download against the release's
SHA256SUMS.txt first:
Get-FileHash .\Hermes-Deck-<version>-Setup.exe -Algorithm SHA256
shasum -a 256 Hermes-Deck-<version>-mac-arm64.dmg
On Windows, Setup installs per user without admin rights and adds Start menu and Desktop shortcuts (Windows notifications need the Start menu shortcut). On macOS, drag the app to Applications. SmartScreen or Gatekeeper asks once; approve only a download you verified.
3. First-start setup. The app walks you through:
stream.py path from step 1; Test connection. SSH uses your existing key login and
known_hosts; Deck never prompts for passwords.With Telegram mode on, Telegram's API-key and phone login screens follow. Everything can be changed later in Settings (gear in the top bar, or Ctrl+, / Cmd+,).
4. Relay (optional). Run it on the Hermes host, bound to loopback or a private network address only, then enter
ws://<relay-host>:9330 and its token in Settings → Relay. Setup for Linux and macOS: docs/relay.md.
SHA256SUMS.txt and installs it. On macOS, install the new DMG from the release page.compat.json (minHermes), on Linux, macOS or WSL.App, relay and plugin share one version; run the same version of each. Full matrix and the version/protocol rules: docs/compatibility.md.