Skip to main content

Enhanced status line for Claude Code

Project description

ccsl

CI PyPI

Enhanced status line for Claude Code showing context usage, session time, and weekly budget.

screenshot

[Fable 5] | ๐Ÿ“ statusline | ๐ŸŒฟ main | $7.36 | Ext 23% $11.50/$50
Context:    โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’ [25%] 245.1K/1.0M
Session:    โ–…โ–ˆโ–ƒโ–โ–‚โ–„โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ– [7%] 67.7M token (5:08-10:08) $12
Weekly:     โ–…โ–ƒโ–โ–‡โ–‚โ–‡โ–โ–โ–„โ–โ–†โ–ˆโ–โ–โ–โ–โ–โ–โ–โ– [42%] 3d0h24m, $34, Ext: 23% $11.50/$50

Install

It's a single dependency-free Python file. Drop it in and point Claude Code at it:

mkdir -p ~/.claude
curl -fsSL https://raw.githubusercontent.com/usedhonda/statusline/main/statusline.py -o ~/.claude/statusline.py
python3 ~/.claude/statusline.py --setup

Restart Claude Code. Done โ€” it keeps itself up to date automatically.

Other install methods

pip

pip install ccsl
ccsl --setup

From source

git clone https://github.com/usedhonda/statusline.git
cd statusline
python3 install.py

Homebrew (being retired โ€” prefer the curl install above)

brew install usedhonda/tap/ccsl
ccsl --setup

What it shows

  • Line 1 โ€” Model, directory, git branch. Metered-billing models (e.g. Fable 5) add the cost of the latest turn and extra-usage credit consumption (Ext)
  • Line 2 โ€” Context window token usage with progress bar and cache ratio
  • Line 3 โ€” Session sparkline with 5-hour utilization, token count, time range, and the 5-hour window's metered spend
  • Line 4 โ€” Weekly sparkline with 7-day token distribution, remaining time, the 7-day window's metered spend, extra usage

Supports 1M context โ€” the context line scales to the active window size (e.g. 122K/1.0M).

Features

  • Metered-model cost tracking โ€” models billed via usage credits (Fable 5) show what the latest turn cost, computed per-message so mixed-model sessions only count the metered share
  • Context window progress bar with color warnings (yellow 80%, red 90%)
  • 5-hour session sparkline (20 segments, 15min each)
  • Weekly usage sparkline with remaining time and budget tracking
  • Responsive layout adapting to terminal width and height
  • Agent team support with single-line format and dead agent warnings
  • Schedule integration showing upcoming calendar events

Customize

Control which lines to display:

ccsl --show all      # All 4 lines (default)
ccsl --show simple   # Lines 2 and 3 only
ccsl --show 1,2      # Specific lines

Requirements

  • Python 3.9+
  • Claude Code

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ccsl-1.0.30.tar.gz (51.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ccsl-1.0.30-py3-none-any.whl (50.3 kB view details)

Uploaded Python 3

File details

Details for the file ccsl-1.0.30.tar.gz.

File metadata

  • Download URL: ccsl-1.0.30.tar.gz
  • Upload date:
  • Size: 51.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ccsl-1.0.30.tar.gz
Algorithm Hash digest
SHA256 6df3eed2448852b2d73eff47f8cd44347562bbdd4bb0c41098447ac4fec26fa0
MD5 8a54d02e4d4cc381fa94444b12bf1c45
BLAKE2b-256 cafefb23725f91ace1886b84deafda9e2c3974a99353138f439d92c8f1be636c

See more details on using hashes here.

Provenance

The following attestation bundles were made for ccsl-1.0.30.tar.gz:

Publisher: publish.yml on usedhonda/statusline

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ccsl-1.0.30-py3-none-any.whl.

File metadata

  • Download URL: ccsl-1.0.30-py3-none-any.whl
  • Upload date:
  • Size: 50.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ccsl-1.0.30-py3-none-any.whl
Algorithm Hash digest
SHA256 e19b82325f8f7b0f919579f51f12f52dd6fe543261f8c8531efbd1d9dad6b750
MD5 2063f11095440de1745a6ae6a6f15ba3
BLAKE2b-256 3b578ef06813dcbcc2ae53bc29f4b6f54272dac9dd3451da062ba304bff81493

See more details on using hashes here.

Provenance

The following attestation bundles were made for ccsl-1.0.30-py3-none-any.whl:

Publisher: publish.yml on usedhonda/statusline

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page