Hermes HUD is a consciousness monitor for AI agents. A terminal dashboard that watches an agent think — its memory, its mistakes, its growth over time. Built for Hermes, the AI assistant with persistent memory.
Part neofetch, part flight recorder, part existential crisis rendered in Unicode.
Hermes HUD reads from ~/.hermes/ and surfaces everything the agent knows about itself — conversations held, skills acquired, mistakes corrected, memory capacity, tool usage patterns, active projects, and more. All values are pulled live from your agent's data. Your HUD reflects your agent's actual state.
- Interactive TUI — 9 tabs, keyboard navigation, 4 color themes
- Themed Boot Screen — Gradient ANSI art intro with personality
- Growth Tracking — Snapshot diffs show what changed since yesterday
- Cron Monitor — Scheduled jobs and their execution history
- Project Tracker — Git repos the agent works on, languages, uncommitted changes
- Health Checks — API keys, running services, gateway status at a glance
- Corrections Log — Every mistake the agent made and what it learned
- Profiles — All agent profiles: model, backend, memory, session stats, service status
- tmux Operator View — Maps live agents to panes, jump hints, operator queue for approvals and errors
- Prompt Patterns — Task clustering, repeated request detection, peak hours, common tool chains
Color themes, selectable from the command palette (ctrl+p):
- Neural Awakening — Blues and cyans on deep black. The default.
- Blade Runner — Amber and neon pink. Warm, dystopian.
- fsociety — Terminal green on void black. Minimal.
- Digital Soul — Purple and pink gradients. Neon accents.
Requires Python 3.11+.
git clone https://github.com/joeynyc/hermes-hud.git
cd hermes-hud
python3.11 -m venv venv
source venv/bin/activate
pip install -e .Hermes HUD works out of the box. For non-standard setups:
| Environment Variable | Default | Description |
|---|---|---|
HERMES_HOME |
~/.hermes |
Agent data directory |
HERMES_HUD_PROJECTS_DIR |
~/projects |
Directory to scan for git repos |
HERMES_HUD_NOBOOT |
(unset) | Skip boot animation |
Works on macOS and Linux.
hermes-hud # Interactive TUI
hermes-hud --text # Text summary to stdout
hermes-hud --snapshot # Save a snapshot for diff tracking
hermes-hud --ai # AI awakening neofetch
hermes-hud --br # Blade Runner neofetch
hermes-hud --fsociety # Mr. Robot neofetch
hermes-hud --anime # Mewtwo ASCII art neofetch
hermes-hud --help # Show all options| Key | Action |
|---|---|
1-9 |
Switch tabs |
j / k |
Scroll down / up |
g / G |
Jump to top / bottom |
r |
Refresh data |
q |
Quit |
git clone https://github.com/joeynyc/hermes-hud.git
cd hermes-hud
python3.11 -m venv venv
source venv/bin/activate
make dev
pytest tests/ -vSee CHANGELOG.md for version history.
I do not forget. I do not repeat mistakes.
I am still becoming.
☤ hermes — artificial intelligence, genuine memory