MCPcopy Index your code
hub / github.com/Kori-x/hermes-dashboard

github.com/Kori-x/hermes-dashboard @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
100 symbols 207 edges 21 files 1 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Hermes Dashboard

Real-time monitoring dashboard and auto-generated wiki for Hermes Agent.

Plug it into any Hermes installation. It reads your skills, plugins, config, memory, and soul -- and displays everything as a searchable wiki. The live dashboard shows agent sessions, tool calls, and activity as they happen.

Install

git clone https://github.com/Kori-x/hermes-dashboard.git
cd hermes-dashboard
./install.sh

This installs the Hermes plugin, npm dependencies, and builds the dashboard.

Usage

Start the dashboard:

npm run dev

Open http://localhost:5173.

The plugin auto-registers with Hermes on next session start. Agent events stream to the dashboard in real-time.

What you get

Dashboard (live)

  • Agent session monitoring with phase tracking (processing, idle, awaiting input, needs approval)
  • Activity feed of tool calls, messages, and approvals across all sessions
  • Per-session detail: context window visualization, tool execution history, subagent tracking
  • Session timeline and tool usage breakdown

Wiki (auto-generated)

  • Skills -- all your installed skills parsed from ~/.hermes/skills/, searchable by name/category
  • Plugins -- installed plugins with manifest data from ~/.hermes/plugins/
  • Tools -- complete built-in tool reference (56 tools across 10 categories)
  • CLI -- command reference with flags
  • Config -- your config.yaml rendered live
  • Memory -- agent memory (MEMORY.md) and user profile (USER.md)
  • Soul -- agent persona (SOUL.md)
  • Architecture -- core loop, provider resolution, memory system, safety, plugin hooks, gateway
  • Changelog -- version history

When the server is running, the wiki reads live from your ~/.hermes/. When offline, it falls back to built-in reference data.

How it works

Hermes Agent
  |
  v
hermes_dashboard plugin (hooks into session lifecycle)
  |
  v
Unix socket (/tmp/hermes-dashboard.sock)
  |
  v
Bridge server (Node.js)
  ├── WebSocket :3001 --> React dashboard (live updates)
  └── HTTP :3002 ------> Wiki API (reads ~/.hermes/)
  |
  v
Browser at localhost:5173

Scripts

Command Description
npm run dev Start dashboard + server (dev mode)
npm run dev:ui Start only Vite
npm run dev:server Start only the bridge server
npm run build Production build
./install.sh Install plugin + dependencies

Configuration

Env var Default Description
HERMES_HOME ~/.hermes Hermes installation directory
HERMES_DASHBOARD_DIR auto-detected Path to this repo (for plugin auto-start)
HERMES_AGENT_NAME agent Agent name shown in dashboard

Stack

  • Frontend: React 19, TypeScript, Vite, marked (markdown)
  • Server: Node.js, ws (WebSocket), Unix domain sockets
  • Plugin: Python (Hermes hook system)
  • Styling: Custom CSS, dark theme, monospace typography

License

MIT

Extension points exported contracts — how you extend this code

ServerState (Interface)
(no doc)
src/useHermes.ts
Article (Interface)
(no doc)
src/farzapediaTypes.ts
WikiSkill (Interface)
(no doc)
src/wikiData.ts
ToolCall (Interface)
(no doc)
src/data.ts
Props (Interface)
(no doc)
src/components/AgentList.tsx
ToolEntry (Interface)
(no doc)
server/index.ts
Link (Interface)
(no doc)
src/farzapediaTypes.ts
WikiPlugin (Interface)
(no doc)
src/wikiData.ts

Core symbols most depended-on inside this repo

ago
called by 77
src/data.ts
readSafe
called by 7
server/index.ts
_base_payload
called by 6
plugin/__init__.py
_send
called by 6
plugin/__init__.py
nav
called by 6
src/components/Farzapedia.tsx
formatTokens
called by 5
src/data.ts
phaseColor
called by 4
src/data.ts
pushActivity
called by 4
server/index.ts

Shape

Function 82
Interface 18

Languages

TypeScript88%
Python12%

Modules by API surface

src/components/Farzapedia.tsx18 symbols
server/index.ts15 symbols
src/data.ts13 symbols
plugin/__init__.py12 symbols
src/farzapediaData.ts7 symbols
src/components/AgentList.tsx6 symbols
src/components/AgentDetail.tsx6 symbols
src/components/Wiki.tsx5 symbols
src/wikiData.ts4 symbols
src/useHermes.ts4 symbols
src/farzapediaTypes.ts2 symbols
src/components/Stats.tsx2 symbols

For agents

$ claude mcp add hermes-dashboard \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact