Installation Guide

Quick Install

Python (pip) — Recommended

pip install context-stats

Or with uv:

uv pip install context-stats

After installation, add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "claude-statusline"
  }
}

Install from Source

git clone https://github.com/luongnv89/cc-context-stats.git
cd cc-context-stats
pip install .

Windows

pip install context-stats

Or manually copy the script:

git clone https://github.com/luongnv89/cc-context-stats.git
copy context-stats\scripts\statusline.py %USERPROFILE%\.claude\statusline.py

Manual Installation

macOS / Linux

cp scripts/statusline.py ~/.claude/statusline.py
chmod +x ~/.claude/statusline.py

Configure Claude Code

Add to your Claude Code settings:

File location:

• macOS/Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

pip Install

{
  "statusLine": {
    "type": "command",
    "command": "claude-statusline"
  }
}

Python (Manual Copy)

{
  "statusLine": {
    "type": "command",
    "command": "python ~/.claude/statusline.py"
  }
}

Windows:

{
  "statusLine": {
    "type": "command",
    "command": "python %USERPROFILE%\\.claude\\statusline.py"
  }
}

Requirements

Python 3.9+ is the only requirement. No additional system packages needed.

Verify Installation

Test your statusline:

# If installed via pip
echo '{"model":{"display_name":"Test"}}' | claude-statusline

# Python script (manual copy)
echo '{"model":{"display_name":"Test"}}' | python3 ~/.claude/statusline.py

# Windows (Python)
echo {"model":{"display_name":"Test"}} | python %USERPROFILE%\.claude\statusline.py

You should see output like: [Test] directory

Restart Claude Code to see the status line.