{
  "markdown": "# claude-vitals\n\nReal-time session vitals for Claude Code. Context health, active tools, running agents, cost, rate limits — always visible below your input.\n\n![claude-vitals demo](demo.svg)\n\n## What You See\n\n```\n[Opus 4.6 (1M context)]  ~/myproject  main ✱ ~2  ⏱ 12m 34s\n████████░░░░░░░░  42%  (420k / 1.0M)  ~$9.20\n◐ Bash: npm run build │ ✓ Read ×3 │ ✓ Grep │ ✓ Edit ×2 │ ✓ Bash\n◐ AGENT: Explore [sonnet]: Searching for security vulnerabilities (2m 15s)\n▸ Tasks 2/5 ████░░░░░░\n5h: █░░░░░░░  12% resets in 4h 0m  7d: ███░░░░░  39% resets Fri 10:00 AM\n```\n\n**Line 1** — Model, project path, git branch + dirty state, session duration\n\n**Line 2** — Context window health bar with color thresholds (green < 70% < yellow < 85% < red) + token counts + estimated cost\n\n**Line 3** — Active tools (running shown individually, completed aggregated by name, errors in red)\n\n**Line 4** — Running agents with type, model, description, and elapsed time\n\n**Line 5** — Task progress with bar\n\n**Line 6** — Rate limits (5-hour session + 7-day weekly) with reset times\n\nEvery line is **reactive** — it only appears when relevant. No agents running? Line hidden. No todos? Line hidden. Git clean? Just branch name. No noise.\n\n## Features\n\n- **Context health** — progress bar with color-coded thresholds + token counts\n- **Cost estimation** — approximate session cost based on model and token usage\n- **Active tools** — see what Claude is doing right now (Read, Edit, Grep, Bash, etc.)\n- **Running agents** — track subagent dispatches with type, model, and elapsed time\n- **Todo progress** — visual progress bar for task completion\n- **Git status** — branch, dirty state, ahead/behind, file stats\n- **Rate limits** — 5-hour and 7-day usage with reset countdown\n- **Autocompact warning** — bold red alert when context hits 90%+\n- **Adaptive layout** — auto-detects terminal width (expanded / compact / minimal)\n- **Reactive sections** — lines appear/disappear based on relevance\n- **Zero config** — works perfectly out of the box\n- **Zero dependencies** — pure Node.js built-ins, nothing to install\n\n## Install\n\n```bash\ngit clone https://github.com/ICXCNIKAanon/claude-vitals.git ~/claude-vitals && cd ~/claude-vitals && npm install && npm run build && node -e \"const fs=require('fs'),p=require('path'),f=p.join(require('os').homedir(),'.claude','settings.json');let s={};try{s=JSON.parse(fs.readFileSync(f,'utf-8'))}catch{};s.statusLine={type:'command',command:'node '+p.join(require('os').homedir(),'claude-vitals','dist','bin.js')};fs.writeFileSync(f,JSON.stringify(s,null,2));console.log('Done! Restart Claude Code to see vitals.')\"\n```\n\n## Configuration\n\nOptional. Create `~/.claude/plugins/claude-vitals/config.json`:\n\n```json\n{\n  \"layout\": \"auto\",\n  \"show\": {\n    \"cost\": true,\n    \"git\": true,\n    \"tools\": true,\n    \"agents\": true,\n    \"todos\": true,\n    \"memory\": false\n  },\n  \"contextValue\": \"both\",\n  \"thresholds\": {\n    \"contextWarn\": 70,\n    \"contextDanger\": 85\n  },\n  \"colors\": {\n    \"healthy\": \"green\",\n    \"warning\": \"yellow\",\n    \"danger\": \"red\",\n    \"accent\": \"cyan\",\n    \"muted\": \"gray\"\n  }\n}\n```\n\nAll options are optional — defaults are used for anything not specified.\n\nColors support named colors, hex (`#ff0000`), and 256-color indices (`196`).\n\n## ShipSafe Integration\n\nclaude-vitals automatically detects if [ShipSafe](https://github.com/ICXCNIKAanon/shipsafe) is installed and displays your project's security score in the statusline.\n\n[ShipSafe](https://shipsafe.org) is a security scanner built for developers who ship fast. It runs 1,200+ detection rules locally on your machine — SQL injection, prompt injection, hardcoded secrets, malicious MCP servers, and more. One command install, zero config, zero cloud. Your code never leaves your machine.\n\nWhen ShipSafe is installed, you'll see an additional line:\n\n```\n⛵  A  clean                          # All clear\n⛵  C  11 findings                    # Medium-severity issues found\n⛵  D  3 crit 2 high  5 fixable      # Critical/high issues with auto-fix available\n⛵  ShipSafe  run shipsafe scan       # Installed but no scan run yet\n```\n\nThe line only appears when ShipSafe is installed. No configuration needed — it reads the cached scan results from `.shipsafe/last-scan.json` (written after every `shipsafe scan`). No re-scanning, no performance impact.\n\n**Install ShipSafe:**\n\n```bash\nnpm install -g @shipsafe/cli\n```\n\n## Requirements\n\n- Node.js 22+\n- Claude Code 2.1+\n\n## License\n\nMIT\n",
  "bytes": 4451,
  "sha": "a3db6a29a0c7fd80b87b0828fbcfc05f9a0214e070b7a279c624f680bd8529ad",
  "repo_slug": "icxcnikaanon/claude-vitals",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_icxcnikaanon_claude_vitals_claude_vitals_7ea7f256/readme"
}