hermes-hud

Name: hermes-hud
Author: joeynyc

by joeynyc

Verified

TUI consciousness monitor for Hermes

866stars

60forks

Python

Added 4/7/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/joeynyc/hermes-hud

Getting Started

Guides for using ai agents skills like hermes-hud.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/7/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-07T06:36:47.066Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": false
}

README.md

Frequently Asked Questions

What is hermes-hud?

hermes-hud is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by joeynyc. TUI consciousness monitor for Hermes. It has 866 GitHub stars.

Is hermes-hud safe to use?

Yes. hermes-hud passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install hermes-hud?

Clone the repository with "git clone https://github.com/joeynyc/hermes-hud" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is hermes-hud written in?

hermes-hud is primarily written in Python. It is open-source under joeynyc on GitHub, so you can review or fork the full source.

Are there alternatives to hermes-hud?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh hermes-hud against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

ai-trader flow-like

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.

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

License

MIT