# Add to your Claude Code skills
git clone https://github.com/stefanprodan/cctopcctop is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by stefanprodan. Live top-style monitor for Claude Code sessions. It has 66 GitHub stars.
cctop's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/stefanprodan/cctop" and add it to your Claude Code skills directory (see the Installation section above).
cctop is primarily written in TypeScript. It is open-source under stefanprodan on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh cctop against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
Interactive top-style monitor for Claude Code sessions. Know at a glance what Claude is working on, how much context it has left, and which sessions are waiting for input.
--once it prints a single frame.x → SIGTERM, with confirm), or
free ports held by a session's leftover dev server
(f in the detail view).~/.claude and the process table,
spawns no processes.On macOS or Linux, install the standalone binary with Homebrew:
brew install stefanprodan/tap/cctop
Or install it as a script with Bun:
bun install -g github:stefanprodan/cctop#v0.3.0
To display the subscription's rate-limit usage, add the following to your Claude Code status-line script:
input=$(cat)
# persist the account-wide 5h/7d rate limits
printf '%s' "$input" | cctop --capture-usage || true
With --capture-usage the rate limits stats are persisted to
~/.claude/cctop/usage.json from which the cctop TUI reads.
See docs/usage-limits.md for more details.
With Homebrew:
brew upgrade stefanprodan/tap/cctop
Or upgrade the scrip to the latest release with Bun:
bun install -g github:stefanprodan/cctop#v0.3.0
With Homebrew:
brew uninstall stefanprodan/tap/cctop
Or with Bun:
bun uninstall -g cctop
If you enabled usage limits, also remove the cctop --capture-usage line from
your Claude Code status-line script.
On an interactive terminal cctop runs as a live TUI (like top); when piped,
redirected, or run with --once it prints a single frame and exits.
While the TUI is running:
| Key | Action |
|---|---|
↑/k ↓/j |
move the selection |
PgUp/PgDn |
jump 10 rows |
g / G |
jump to top / bottom |
enter |
open the detail view for the selected session |
esc |
leave the detail view / close an overlay |
/ |
filter sessions (type, enter to apply) |
s |
cycle the sort column (default, cpu, mem, ctx, pid) |
x |
quit the selected session (SIGTERM, with confirm) |
f |
reclaim the detail view's orphan ports (SIGTERM, with confirm) |
? |
toggle the help overlay |
q / Ctrl-C |
quit cctop |
cctop [filter] [options]
filter only show sessions whose project, host, branch,
model, or session id contains this
-w, --watch[=seconds] set the refresh interval (default: 1s, min 0.25s)
--once render once and exit (default when piped)
--json print full session details as JSON
-v, --version show version
-h, --help show this help
Examples:
cctop flux # start filtered to sessions matching "flux"
cctop --watch=0.5 # refresh twice a second
cctop --once # single frame, then exit
cctop --json # machine-readable snapshot
cctop is open source and contributions are welcome — open an issue or send a
pull request on GitHub. See
docs/CONTRIBUTING.md to get set up.