cctop
A htop-like TUI for monitoring Claude Code sessions in real-time.
See all your running Claude Code sessions at a glance — status, project, branch, idle time, LLM-generated summaries, and more.
Press Enter to jump straight to the iTerm2 pane running a session. No more hunting through tabs.
Quick start
# Run directly (no install needed)
uvx --from claude-cctop@latest cctop
# Install the hooks so cctop can track session activity in real-time
cctop install
Restart any running Claude Code sessions after installing hooks.
iTerm2 integration
Press Enter on any session to instantly focus its iTerm2 pane. cctop walks up the process tree from the Claude PID to find the matching terminal session — works across tabs, split panes, and windows.
Setup: Make sure the iTerm2 Python API is enabled (Preferences > General > Magic > Enable Python API). It may already be on by default.
What it shows
| Column | Description |
|---|---|
| PROJECT | Project directory (auto-detects worktrees) |
| NAME | Session name (--name flag passed to claude) |
| BRANCH | Git branch or worktree name |
| STATUS | Working (+ current tool), Idle, or Offline |
| MSGS | Message count |
| DURATION | Total session duration |
| IDLE | Time since last activity |
Expand a session with Space to see the PR link, an LLM-generated summary, the working directory, session ID, and branch details.
Keybindings
| Key | Action |
|---|---|
↑/↓ or k/j |
Navigate sessions |
Space |
Expand / collapse session detail |
Enter |
Focus the iTerm2 pane |
c |
Copy session ID to clipboard |
r |
Regenerate LLM summary |
F6 or >/< |
Cycle sort mode |
/ |
Filter (coming soon) |
? or h |
Help |
q |
Quit |
Options
cctop # Show active sessions only
cctop --recent 1h # Include sessions ended within the last hour
cctop install # Install hooks into Claude Code settings
cctop uninstall # Remove hooks and clean up
Requirements
- Python 3.12+
- macOS (iTerm2 integration is macOS-only)
jq(used by hooks —brew install jq)- Claude Code with hooks support
Uninstall
cctop uninstall
This removes the hooks from Claude Code settings and cleans up ~/.cctop.
1 maintainer
Metadata
1 maintainer
Release files for claude-cctop 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| claude_cctop-0.2.2.tar.gz | 248.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_cctop-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 275.8 kB
Release files / claude_cctop-0.2.2.tar.gz
| Download URL | claude_cctop-0.2.2.tar.gz |
|---|---|
| Size | 248.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f8ca54cd9a220b91dcd68975c3650d2b37483dca3d77f71cf19c964734528c1f
|
|
BLAKE2b-256 checksum How to use checksums |
d6cd0df19d0d7b3243d4cbfc3e27550c3f5cb4ec009e20a942ff2425c97b03a0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.9
|
Release files / claude_cctop-0.2.2-py3-none-any.whl
| Download URL | claude_cctop-0.2.2-py3-none-any.whl |
|---|---|
| Size | 27.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
888e2f7611091e7a4f15f5fab52ce93380019536318672b5c9ea2a2d270ed423
|
|
BLAKE2b-256 checksum How to use checksums |
1223d4061b76d84b74e77a41e700480882c941c42aa2579d5e2c3ecc5e7c85da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.5.9
|
Security for claude-cctop 0.2.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
