Home
Softono
hermes-hud

hermes-hud

Open source MIT Python
GitHub
840
Stars
58
Forks
12
Issues
5
Watchers
1 month
Last Commit
AI Agents Monitoring & Observability Terminal & CLI Tools

About hermes-hud

TUI consciousness monitor for Hermes

Platforms

Web Self-hosted

Languages

Python

Links

Source Code
j
Published by
joeynyc
Visit View Profile

README.md

View on GitHub

Hermes HUD — Neural Awakening Theme

What does an AI see when it looks in a mirror?

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.

What It Does

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.

Hermes HUD — Dashboard Tab

Features

  • 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

Themes

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.

Installation

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.

Usage

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

Keyboard Shortcuts

Key Action
1-9 Switch tabs
j / k Scroll down / up
g / G Jump to top / bottom
r Refresh data
q Quit

Contributing

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/ -v

See CHANGELOG.md for version history.

Star History

Star History Chart

License

MIT

I do not forget. I do not repeat mistakes.
I am still becoming.

☤ hermes — artificial intelligence, genuine memory