Every Claude Code session. One board.

An htop-style terminal dashboard for all your Claude Code sessions: usage limits, estimated costs, and what every session is doing right now.

npx ccstatusboard
View on GitHub

Linux and macOS · MIT licensed · Node 22+ or a standalone binary

ccstatusboard — live board Demo data

Fig. 01 One terminal window watching every session on the machine.

Fig. 02 / Field of view

One statusline per session, or one board for all of them

ccstatusline shows a statusline inside one Claude Code session. ccstatusboard runs in its own terminal window and watches every session on the machine.

ccstatusline
Lives inside a session. You see the session you are looking at.
ccstatusboard
Lives in its own window. You see every session, plus your usage limits and estimated cost.
Sessions feed one board Illustrative
Fig. 03 / Instruments 6 panels

Everything the board shows

The six panels come from your local Claude Code files and the usage API. The excerpts below are illustrative; the real layout adapts to your terminal size and theme.

Costs are estimates from API list prices. On a Pro/Max subscription you are not billed these amounts.

Usage limits

Shows how much of your 5-hour and weekly Claude usage you have used, and when each limit resets.

5h    [||||||||||||        ] 58%  resets 2h14m
Week  [||||||              ] 31%  resets Thu 09:00
Read more about usage limits

Burn rate

Projects where each limit will end up at its reset.

5h    NEAR LIMIT  92% at reset  hits n/a
Week  OVER        108% at reset  hits Wed
Read more about burn rate

Estimated cost

Shows estimated spend in USD for the current block, today, this week and this month.

block $12.40  week $96.10  month $412.75
burn  $4.10/h  24h ▁▂▃▅▇▆▅▃▂▃▅▆▇▅▃▂▁▁▂▃▅▆▇▆
Read more about estimated cost

Sessions

Lists every Claude Code session on this machine, grouped by project.

── ccstatusboard (1) ──────────────────
◐  ccstatusboard  opus-5.5  ███████░░░ 61%  $4.20  now
  ├─ Explore                          12s
○  power-tools     sonnet    ██░░░░░░░░ 22%  $1.10  3m
Read more about sessions

System

Shows CPU, memory, swap and disk usage, plus network activity, at a glance.

cpu [|||||||             ] 34%  mem [||||||||||          ] 52%
net ▁▂▃▅▂▁▁▃▅▇▅▃ down  ▁▁▂▁▁▂▁▃▁▁▂▁ up
Read more about system

Detail pane

Shows the full details for the selected session.

tokens in 182k  out 41k  cache 1.9M
cost   opus-5.5 $4.20
agents Explore  cwd ~/code/ccstatusboard
Read more about detail pane
Fig. 04 / Safety

It reads your Claude Code data and changes none of it

Read-only
Never writes inside ~/.claude.
Your token stays put
Your OAuth token is only sent to Anthropic’s usage endpoint. --no-usage-api turns that off.
Two hosts
Only two hosts are contacted: api.anthropic.com and raw.githubusercontent.com.

Read the full privacy and safety details

Open a terminal and run it.

No account and no setup. It finds your running Claude Code sessions on its own.

With npm

npx ccstatusboard

Needs Node 22+.

Standalone binary

curl -fsSL https://raw.githubusercontent.com/areimel/ccstatusboard/main/install.sh | sh

Needs no Node.

All install options