v0.2.0 — agent-first: MCP server + av init

Big shift: agents, not users

v0.2.0 reframes agent-vitals as infrastructure for AI agents, not a CLI for humans. The MCP server is now the primary surface. Humans just verify it's wired up correctly.

New

• MCP server (av mcp) exposing 5 tools:
  • vitals_summary — plain-English health check. Always-call-first.
  • shadow_list — full list of scheduled/configured agents.
  • shadow_stale — only broken references.
  • burnout_summary — task completion metrics.
  • burnout_stuck_sessions — likely-stuck Claude Code sessions.
• av init — detects installed agent hosts (pi, Claude Code, Cursor, OpenCode, Codex CLI) and:
  1. Registers agent-vitals as an MCP server in each (JSON or TOML config).
  2. Installs a SKILL.md / rule snippet that primes the agent to call vitals proactively (before tasks, before scheduling, when stuck, after long tasks, when claiming something works).
• av doctor — health check with actionable recommendations.
• av detect — list detected hosts.
• --watch mode on shadow/burnout for live refresh.
• README rewritten with the agent-first narrative + trigger table.

Install + wire up

uv tool install git+https://github.com/anirudhprashant/agent-vitals
av init     # auto-wires pi / Claude Code / OpenCode / Cursor / Codex CLI

Restart your agent host. Done.

Stack

Python 3.11+, uv-managed. typer + rich + pyyaml + mcp. ~900 LOC of Python + the priming SKILL.md.

Anti-patterns this version exists to prevent

❌ Agent claims 'your crontab is fine' without calling shadow_stale
❌ Agent schedules cron work without verifying the target exists
❌ Agent starts a 4-hour task while 6 other sessions are stuck
❌ Agent pretends a task completed without checking burnout_summary
❌ Agent recommends an MCP server install without checking for duplicates

License

MIT.