Hermes HUD

What Hermes HUD does

Hermes HUD installs into the user plugin directory and does not replace the dashboard or change the Hermes Agent core, so Hermes upgrades do not overwrite it and one command removes it. It adds tabs for a health overview, live activity, token and cost, conversations, an agent timeline, memory, skills, skill analytics, cron, channels, errors and incidents, system storage and settings. Data refreshes about every two seconds through a shared snapshot cache and a WebSocket event stream.

Access to Hermes data is read-only: databases are opened with mode=ro and the gateway is not locked, and logs and paths are redacted before fingerprints are generated. Cost views separate estimated, actual and unpriced figures. The interface is available in Chinese, English, French and Arabic. An optional hud_alert.py script pushes new incidents, escalations and recoveries to Telegram and Feishu with debouncing. A separate macOS Desktop Alpha app for Apple Silicon is also offered.

Key features

• Tabs for health, live activity, token and cost, timeline, memory, skills, cron, channels and incidents
• About two-second updates from a shared snapshot cache and WebSocket stream
• Read-only access to Hermes data with redacted logs and paths
• Cost views that separate estimated, actual and unpriced calls
• Optional Telegram and Feishu incident alerts through hud_alert.py
• Interface in Chinese, English, French and Arabic

When to use it

• Seeing at a glance whether the gateway, channels and cron jobs are healthy
• Tracking token use and estimated cost per model and session
• Investigating errors through grouped incidents and an event timeline
• Getting Telegram or Feishu alerts when a new incident appears

Who it is for: Hermes Agent operators who run the agent continuously and want local monitoring of cost, health and incidents.

How it fits with Hermes Agent

Built for Hermes Agent as a user-level plugin for the official hermes dashboard. It is a different project from the standalone terminal UI joeynyc/hermes-hud.

How to install Hermes HUD

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/Diabloluo/hermes-hud ~/.hermes/plugins/hermes-hud
python3 ~/.hermes/plugins/hermes-hud/scripts/enable_dashboard_plugin.py enable
hermes dashboard --host 127.0.0.1 --port 9119 --no-open

Requirements: Hermes Agent with the hermes dashboard command. Desktop Alpha: Hermes Agent 0.19.0+, HUD plugin 1.1.1+, Apple Silicon Mac. Alerts: Telegram and/or Feishu credentials in .env

Note: The macOS Desktop app is an alpha release for Apple Silicon only, with no automatic updates; the web HUD is unaffected.

FAQ