ccsl — Claude Code Status Line

Terminal configurator for Claude Code's built-in status line. Pick fields, pick a theme, hit Enter.

Claude Code Status Line

What it does

Writes a tiny Python script to ~/.claude/statusline.py and wires it into ~/.claude/settings.json. Claude Code calls that script on every prompt and renders the output as your status line.

Fields

Field	Example
🤖 Model	`[Opus]`
📁 Directory	`📁 directory`
📊 Context	`██████░░░░ 130k/200k (65%)`
💰 Cost	`💰 $0.01`
🌿 Git branch	`🌿 main`
⏱️ Duration	`⏱️ 0m`

Themes: default · minimal · neon · pastel · mono

Requirements

Python 3 (standard library only, no pip install)
Claude Code

Usage

Quick install:

curl -fsSL https://raw.githubusercontent.com/jsubroto/claude-code-statusline/main/ccsl.py -o /tmp/ccsl.py && python3 /tmp/ccsl.py && rm /tmp/ccsl.py

Or clone and run:

git clone https://github.com/jsubroto/claude-code-statusline.git
cd claude-code-statusline
python3 ccsl.py

Navigate with ↑ ↓, toggle fields with Space, switch sections with Tab, install with Enter, quit with q.

Restart Claude Code after installing to see your status line.

Testing

python3 -m unittest test_ccsl -v

License

MIT

Uninstall

Remove the statusLine key from ~/.claude/settings.json. A backup is saved to ~/.claude/settings.json.bak before every install.