Claude Code Status Line

Claude Code doesn't show you how many agents are running, which ones finished, or how large your agent ecosystem is. It also hides your token burn rate, rate limit proximity, and context window usage. You're flying blind.

This gives you everything in one persistent status line.

All data is pulled in real-time from Claude Code's stdin JSON payload. No polling, no external API calls, no background daemons.

The status line shows three numbers for your agent ecosystem: running · spawned · total.

• Running — agents actively executing right now (spawned minus completed, parsed from your session transcript)
• Spawned — total Agent tool calls in the current session
• Total — your full agent ecosystem: built-in Claude Code agents + plugin agents + custom agents from ~/.claude/agents/

This works with any Claude Code setup. If you use subagents (Agent tool), your running and spawned counts update in real-time. The total reflects everything available in your environment.

• Claude Code (CLI or desktop)
• bash
• python3
• (Optional) ccusage for token data fallback when stdin rate limits are unavailable

git clone https://github.com/disconnect13/claude-code-statusline.git
cd claude-code-statusline && bash install.sh

mkdir -p ~/.claude/scripts
cp statusline.sh ~/.claude/scripts/statusline.sh
chmod +x ~/.claude/scripts/statusline.sh

Then add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "/full/path/to/home/.claude/scripts/statusline.sh"
  }
}

Replace /full/path/to/home with your actual home directory (e.g., /Users/yourname on macOS or /home/yourname on Linux).

Restart Claude Code to see the status bar.

Claude Code invokes the script after each assistant message, passing a JSON payload on stdin with context_window, rate_limits, and transcript_path data. The script parses this with python3 and renders ANSI-colored output.

Token data comes from stdin's rate_limits.five_hour when available. If not present (older Claude Code versions or certain configurations), falls back to the ccusage CLI with a 30-second cache TTL and async background refresh so the status bar never blocks.

The status bar uses a muted, dark-theme-friendly palette:

Edit the color variables near the top of statusline.sh to customize.

• Green: 0-49% usage
• Yellow: 50-79% usage
• Red: 80%+ usage

rm ~/.claude/scripts/statusline.sh

Remove the statusLine key from ~/.claude/settings.json.

• macOS: Fully supported
• Linux: Fully supported (portable stat handling)
• Windows (WSL): Should work under WSL with bash and python3

MIT