Cctop

cctop


Like `htop`, but for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). A live terminal dashboard that shows all your sessions at a glance, status, context usage, tokens, and latest messages.


Install

Requires [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [uv](https://docs.astral.sh/uv/), and [jq](https://jqlang.github.io/jq/).

curl -fsSL https://raw.githubusercontent.com/DeanLa/cctop/main/install.sh | bash

Then launch from any terminal:

cctop

Why

If you're past the "one session at a time" stage but not running a fleet of headless agents, you're in the middle ground where most tools don't help. You have 4-20 sessions open across multiple projects, refactoring one repo while tests run in another, firing off a prompt in a third while waiting for a fourth to finish. You context-switch constantly, lose track of which tab is blocked on you, and forget what that session in the background was even doing.

cctop gives you one screen to see all of them.

What You See

Keybindings

Key	Action
q	Quit
r	Force refresh
R	Purge dead sessions (PID check + staleness fallback)
F2	Rename the highlighted session (live, no restart needed)
s	Open sort picker (activity, name, status, duration, turns, tokens, tools, files, agents, errors)
ctrl+p	Open command palette (switch theme, etc.)

Columns

Column	What it shows
Name	Session display name (custom title or directory slug)
Project	Working directory name
Branch	Git branch (truncated to 20 chars)
Status	Granular activity status (see below)
Model	Model family and version (e.g. "sonnet 4.6", "opus 4.6")
Ctx%	Context window usage percentage
Tokens	Total tokens consumed (e.g. "145k")
Tools	Tool call count
**Fi