pjjt/claude-statusline-kit repository overview

⁠claude-statusline-kit

A mixin kit that adds a rich status line to Claude Code running inside a Docker sandbox.

⁠What it does

Installs jq and configures Claude Code's statusLine setting to run a shell script on every prompt. The default script displays:

• Sandbox indicator — [📦 sandbox-name] when running inside an sbx sandbox (IS_SANDBOX=1)
• user@host:cwd — coloured green/blue, matching a standard bash prompt
• Model name — the active Claude model in magenta, with any parenthetical suffix stripped
• Context window usage — tokens used vs. total size with colour-coded urgency:
  • green below 50 %
  • yellow from 50–79 %
  • red at 80 %+

Example output:

[📦 my-sandbox] agent@my-sandbox:/workspace [Sonnet 4.6] 42k/200k (21%)

⁠Customising the status line

The install step writes the default script to ~/.claude/statusline-default.sh. To override it, create ~/.claude/statusline.sh — the kit's command checks for that file first and falls back to the default.

⁠Files installed

⁠Requirements

• Debian/Ubuntu-based sandbox image (uses apt-get to install jq)
• Claude Code settings file at ~/.claude/settings.json must exist before install runs