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

[Opus 4.6] | ๐ŸŒฟ main | ๐Ÿ“ statusline | ๐Ÿ’ฌ 249 | +24/-45 | ๐Ÿ’ฐ $7.36
Context:    โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’โ–’ [49%] 98.4K/200.0K
Session:    โ–…โ–ˆโ–ƒโ–โ–‚โ–„โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ–โ– [7%] 67.7M token (5am-10am)
Weekly:     โ–…โ–ƒโ–โ–‡โ–‚โ–‡โ–โ–โ–„โ–โ–†โ–ˆโ–โ–โ–โ–โ–โ–โ–โ– [42%] 3d0h24m, Extra: 7% $3.59/$50

Install

brew install yzhonda/tap/ccsl
ccsl --setup

Restart Claude Code. Done.

Other install methods

pip

pip install ccsl
ccsl --setup

From source

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

What it shows

  • Line 1 โ€” Model, git branch, directory, message count, lines changed, cost
  • Line 2 โ€” Context window token usage with progress bar and cache ratio
  • Line 3 โ€” Session sparkline with 5-hour utilization, token count, and time range
  • Line 4 โ€” Weekly sparkline with 7-day token distribution, remaining time, extra usage

Supports 1M context โ€” the model bracket shows (1M) when using extended context.

Features

  • 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.12.tar.gz (44.8 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.12-py3-none-any.whl (43.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ccsl-1.0.12.tar.gz
  • Upload date:
  • Size: 44.8 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.12.tar.gz
Algorithm Hash digest
SHA256 705ba2ab1b064935c20ab2ae4810dd9119c88340e77cc78386a429f40bac6abf
MD5 a463191c0cd7b7b4e29ba4a9334b0889
BLAKE2b-256 1d6e4d84b4e8e291d8670be4f5ab9d574ac91beb105ba2a7780b0e55db481aed

See more details on using hashes here.

Provenance

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

Publisher: publish.yml on yzhonda/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.12-py3-none-any.whl.

File metadata

  • Download URL: ccsl-1.0.12-py3-none-any.whl
  • Upload date:
  • Size: 43.6 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.12-py3-none-any.whl
Algorithm Hash digest
SHA256 dff8dccd1743d4b26aba0a93539838d616a7d70cd4e75e868539f65cff645f16
MD5 2d561d87640ec160d83baf9adea8ef4f
BLAKE2b-256 8112f830d46e2f136681646c856ed08e0fe6232ed266b37ef87db699677478cc

See more details on using hashes here.

Provenance

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

Publisher: publish.yml on yzhonda/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