Local-first · GPL v3 · No daemon

Give your AI agent a memory of its own infrastructure.

Cron, systemd, MCP servers, skills. Vitals reads what is already running on your machine and hands your agent a health check before it touches any of it.

Star on GitHub Quick start
vitals_summary
▄▀ vitals - local agent stack health
shadow: 13 autonomous thing(s) configured
(mcp: 8, systemd: 5)
subagent burnout (7d): 5 runs, 100% ✓
claude code (7d): 170 sessions, 45,626 events,
⚠ 36 stuck
- biggest stuck-looking session: 7,118 events

Three questions, twenty commands.

No dashboard, no telemetry leaving the box. Every command reads local session logs and system state, then reports back to the agent that asked.

The CLI surface 13 MCP tools · 20 CLI commands

What is running?

av shadow
Everything scheduled or configured to act on your behalf: cron, systemd, MCP servers, skills.
av doctor
One-shot health check with actionable recommendations.
av drift
Inconsistencies across your agent hosts: MCP drift, skills, hooks.

What is wasting?

av loops
Doom-loop patterns: the same Bash command 20+ times, the same edit 10+ times. Polling excluded.
av ssh
SSH polling loops, repeated commands to the same host.
av unused
MCP tools registered but never called, still costing you context every turn.
av overlap
Overlapping MCP tools across servers.

What does it cost?

av cost
Token spend parsed from session JSONLs, grouped by project, with an Effective Tokens metric.
av burnout
Per-agent completion rates and stuck-session heuristics.
av trace
Recorded session forensics for Claude Code and pi. No payloads, no secrets.

The rest do the plumbing: install, detect, mcp, tokens, coach, sessions, compact, snapshot.

That is not a CLI you read. That is a tool your agent calls from inside its own loop, before it does anything risky.

Agent hosts

  • Claude Code
  • pi
  • Cursor
  • OpenCode
  • Codex CLI

vitals MCP server

  • vitals_summary
  • shadow_list
  • shadow_stale
  • burnout_summary
  • burnout_stuck_sessions
  • + 8 trace tools

Local data

  • crontab
  • systemd
  • MCP configs
  • session JSONLs
Install

Thirty seconds, no accounts.

# install and wire into your agent hosts uv tool install agent-vitals av install # detects hosts, wires MCP + priming skill

Detects pi, Claude Code, Cursor, OpenCode, and Codex CLI, and wires the MCP server plus a priming skill into whichever ones you run.

Restart your agent host afterward. The next session calls vitals_summary on its own before anything risky.

Local-first. No daemon.
No cloud. No accounts.

Star on GitHub