claude-status 0.1.0

Beautiful, informative status line for Claude Code — zero dependencies, cross-platform

claude-status

Beautiful, informative status line for Claude Code — zero dependencies, cross-platform.

[████████░░░░░░░░░░░░] in:245K out:18K cache:78% $0.73 burn:2.1K/min 12m05s +247 -38 ⎇ feat/statusline (200K)

Why claude-status?

• Zero dependencies — pure Python stdlib, installs in seconds
• Cross-platform — Windows, macOS, Linux — tested on all three
• pip install — no npm, no cargo, no compilation

Quick Start

pip install claude-status
claude-status --install

Restart Claude Code. Done.

Installation

pip (recommended)

pip install claude-status
claude-status --install

pipx (isolated)

pipx install claude-status
claude-status --install

uvx (fast)

uvx claude-status --install

From source

git clone https://github.com/mkalkere/claude-statusline.git
cd claude-status
pip install -e .
claude-status --install

What --install does

Adds statusLine to ~/.claude/settings.json — preserves all existing settings. Use --theme to pick a theme: claude-status --install --theme powerline

Command not found? Make sure your Python scripts directory is in PATH. Fallback: python -m claude_statusline --install

Features

Feature	Description
Context bar	20-char progress bar, green/yellow/red adaptive
Token counts	Input/output with human-readable formatting (245K, 1.2M)
Cache efficiency	% of tokens served from prompt cache
Cost tracking	Session cost in USD
Burn rate	Tokens/min consumption rate
Session duration	Wall-clock time
Lines changed	+added / -removed with git-diff colors
Git branch	Color-coded (green=main, yellow=feature)
Context size	(200K) vs (1M) indicator
!CTX warning	Red alert when exceeding 200K tokens
Vim mode	NORMAL/INSERT indicator
Agent name	Shows active subagent
Worktree	Branch indicator when in worktree

Themes

default

[████████░░░░░░░░░░░░] │ in:245K out:18K │ cache:78% │ $0.73 │ burn:2.1K/min │ 12m05s │ +247 -38 │ ⎇ feat/statusline │ (200K)

minimal

●●●●●●●●·············· 245K $0.73 12m05s ⎇ feat/statusline

powerline

████████░░░░░░░░░░░░  in:245K out:18K  cache:78%  $0.73  burn:2.1K/min  12m05s  +247 -38  ⎇ feat/statusline  (200K)

Preview all themes: claude-status --demo

CLI Reference

Command	Description
claude-status --install	Auto-configure Claude Code
claude-status --install --theme powerline	Install with specific theme
claude-status --demo	Preview all themes with sample data
claude-status --doctor	Diagnostics: Python, OS, terminal, settings
claude-status --version	Version info
claude-status --help	Usage

Manual Configuration

If you prefer manual setup, add to ~/.claude/settings.json:

{
  "statusLine": "claude-status"
}

Or with a theme:

{
  "statusLine": "claude-status --theme minimal"
}

Comparison

Feature	claude-status	ccstatusline	claude-powerline
Language	Python	Node.js	Bash
Dependencies	0	npm	bash-only
pip install	Yes	No	No
Cross-platform	Yes	Partial	Unix only
Themes	3	1	1
Burn rate	Yes	No	No
Auto-install	Yes	Manual	Manual

Uninstall

pip uninstall claude-status

Then remove "statusLine" from ~/.claude/settings.json.

Contributing

See CONTRIBUTING.md.

License

MIT