●  Claude Code · Statusline

Everything that matters, on one line.

Context usage, session limits, weekly allowance, Git status and active tasks at a glance.

my-project ⎇ main ↑2↓1 │ Opus 5.5 · high │ C45 │ H14 ↺ 4h20m │ W31 ↺ 2d13h │ $44.21
$ npx ctxline-claude
Then restart Claude Code or start a new session. That's it. (bunx also works)
● Works on macOS·Linux·Windows
What it shows

Nine signals, one line

Read left to right. If a source is missing, the line just skips it.

↑ hover, tap, or use arrow keys to inspect a segment

DIR

Subagent panel

Subagents get their own line too

Each running subagent gets a row: name, model, effort, context and elapsed time.

subagents 2 running
○ architecture-review│Opus 5 · max│C51│⏱ 4m12s
○ test-coverage│Sonnet 5 · high│C36│⏱ 1m48s

Effort shows only when a subagent overrides it.

Claude desktop app

Also in the desktop app

The Code tab can't run statusline scripts, so ctxline ships a plugin: a pixel pet, live activity, branch, cache rate, context and usage limits.

In the mock, the row and thin line above the prompt are ctxline. The rest is Desktop's own.

H and W are 5-hour and weekly usage.

Install the plugin

In the app

  1. Open Plugins → Add → Add Marketplace
  2. Enter MithunWijayasiri/ctxline-claude
  3. Install ctxline-desktop

Or with commands

/plugin marketplace add MithunWijayasiri/ctxline-claude
/plugin install ctxline-desktop@ctxline
⚠ Turn on auto-update

Third-party plugins don't auto-update by default. Paste this into Claude Code to turn it on:

Turn on auto-update for the ctxline plugin marketplace: in ~/.claude/settings.json, set extraKnownMarketplaces.ctxline.autoUpdate to true (if there is no ctxline entry, add one with source github, repo MithunWijayasiri/ctxline-claude). Then run: claude plugin update ctxline-desktop@ctxline
Desktop themes

Four looks to choose from

A second plugin, ctxline themes, restyles the desktop app. Each look has a light version and a still background.

Dusk: layered plum mountains under a violet and orange sky, mirrored in a still lake
DuskDefault/ctxtheme duskMountains at dusk, mirrored in a still lake.
Ember: glowing coals along the bottom of a warm charcoal background
Ember/ctxtheme emberGlowing coals along the bottom.
Contour: orange topographic map lines over a blue-slate background
Contour/ctxtheme contourOrange topographic map lines.
Phoenix: a large gold black hole on the right edge, its striped disk streaming out to the left, small galaxies among the stars around it
Phoenix/ctxtheme phoenixA black hole, and small galaxies around it.
Install the themes

In the app

  1. Add the marketplace MithunWijayasiri/ctxline-claude (skip if you already did for ctxline-desktop)
  2. Install ctxline-desktop-themes
  3. Start a new Code session (themes don't show in Chat).
  4. Run /ctxtheme <style> to switch.

Or with commands

/plugin marketplace add MithunWijayasiri/ctxline-claude
/plugin install ctxline-desktop-themes@ctxline
Under the hood

Fast, cached, never breaks

A single zero-dependency Node script.

01

Reads session

Context comes straight from Claude Code's session data on every render.

02

Reads usage

5-hour and weekly limits come from the session data, with Anthropic's usage API as a fallback.

03

Caches it

The fallback is cached and shared across sessions.

04

Falls back

Every failure path degrades silently to cached or partial output. The statusline always renders.

Learn more

The rest lives in the docs on GitHub — one click away.

Support

Enjoying ctxline?

Donations help keep it maintained, improve existing features, and fund new open-source tools.