by joeynyc
TUI consciousness monitor for Hermes
# Add to your Claude Code skills
git clone https://github.com/joeynyc/hermes-hudHermes 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.
No comments yet. Be the first to share your thoughts!
Color themes, selectable from the command palette (ctrl+p):
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/ -v
See CHANGELOG.md for version history.