Hermes HUD by joeynyc: app and UI for Hermes Agent

Terminal dashboard showing a Hermes agent's memory, skills, cron jobs, projects and corrections

What Hermes HUD does

Hermes HUD reads from the ~/.hermes/ data directory and presents live values from your own agent rather than sample data. The interactive TUI has nine tabs, keyboard navigation and four color themes, with a gradient ANSI boot screen that can be skipped. Other commands print a text summary to stdout, save a snapshot, or render neofetch-style screens.

The tabs and panels cover several parts of an agent's state: a cron monitor with execution history, a project tracker for git repos the agent works on, health checks for API keys, running services and gateway status, a corrections log of mistakes and what was learned, and a profiles view with model, backend, memory and session stats. Snapshot diffs show what changed since the previous day, and a tmux operator view maps live agents to panes with an operator queue for approvals and errors. Paths are configurable through environment variables.

Key features

Nine-tab interactive TUI with four selectable color themes
Snapshot diffs that show what changed since yesterday
Cron monitor with scheduled jobs and execution history
Health checks for API keys, running services and gateway status
Corrections log and a profiles view with model, backend and session stats
tmux operator view that maps live agents to panes

When to use it

Checking at a glance whether a long-running Hermes agent's gateway, keys and cron jobs are healthy
Reviewing which mistakes the agent has corrected and how its skills have grown over time
Watching several Hermes profiles and tmux-hosted agents from one terminal

Who it is for: Hermes Agent users who want a read-only terminal view of their agent's state, memory and activity.

How it fits with Hermes Agent

Built for Hermes Agent. It reads the standard ~/.hermes/ directory, or the path set in HERMES_HOME.

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/joeynyc/hermes-hud.git
cd hermes-hud
pip install -e .

Requirements: Python 3.11+ on macOS or Linux; the README creates a venv first with python3.11 -m venv venv

FAQ

What is Hermes HUD?

Hermes HUD is a terminal dashboard that reads a Hermes Agent's ~/.hermes/ directory and shows its memory, skills, corrections, cron jobs and other state. It is a Python TUI built with Textual.

Does Hermes HUD work with Hermes Agent?

Yes, it is built for Hermes Agent and works out of the box with the default ~/.hermes/ location. For non-standard setups, set the HERMES_HOME environment variable.

What do I need to run Hermes HUD?

You need Python 3.11 or newer on macOS or Linux, plus an existing Hermes data directory. HERMES_HUD_PROJECTS_DIR sets which folder it scans for git repos.