Hermes Control Plane

A local, single-page operations console for Hermes Agent. The app is a small zero-dependency Node.js server that serves the UI and shells out to a Hermes CLI installation.

What It Does

Lists OAuth/API-key provider pools.
Displays account identity/email data when it can be derived from Codex, Claude, Gemini, or Hermes JWT-backed auth state.
Edits Hermes model/fallback configuration.
Provides panes for skills, plugins, bundles, MCP, cron, sessions, hooks, memory, kanban, webhooks, profiles, storage, config, tools, insights, security, and system status.

Run With Docker Compose

cp .env.example .env
docker compose up --build -d
docker compose logs -f

Open:

http://127.0.0.1:7843

Runtime Requirements

The container is Linux. It can only execute a Linux-compatible Hermes install at:

/home/hermes/.hermes/hermes-agent/venv/bin/hermes

If you are on macOS, your local ~/.hermes venv contains a macOS Python binary and cannot run inside this Linux container. Use a Linux Hermes home, or run the compose bundle on the Linux Hermes host/LXC.

The default .env.example mounts:

Hermes state from ./state/hermes
Codex auth from /Users/zachsharma/.codex
Claude auth from /Users/zachsharma/.claude

Local Node Run

If Hermes is installed directly on the same OS as Node:

node server.cjs

The default local URL is:

http://127.0.0.1:7843

Useful Commands

npm run check
npm test
docker compose config
docker compose down

1.5 KiB Raw Blame History