KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

hermes-hud

★ 899 Open GitHub ↗

TUI consciousness monitor for Hermes

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h3 align="center">What does an AI see when it looks in a mirror?</h3>

**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](https://github.com/nousresearch/hermes-agent), 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+.

```bash
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

```bash
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

```bash
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](CHANGELOG.md) for version history.

## Star History

## License

[MIT](LICENSE)

---

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

☤ hermes — artificial intelligence, genuine memory

hermes-hud

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README