CTOP — AI Agent Terminal Operations Panel

htop for your AI coding agents. Monitor Claude Code, Codex CLI, OpenCode, and Devin sessions — CPU, memory, tokens, context window, costs, branches — from a single terminal pane.

Features

• Multi-agent monitoring — Claude Code + Codex CLI + OpenCode + Devin, real-time CPU/memory/status
• Context window tracking — visual bar with input, cache, output, and free segments
• Cost estimation — per-session and aggregate API cost (Claude + OpenAI pricing)
• Token waveform — real-time sparkline showing token activity pulse
• Two view modes — list view (table) and pane view (card grid), toggle with P
• Live log tailing — stream conversation in a split pane (L)
• Sort, filter, search — by CPU, memory, context, branch, model, or full-text (F)
• Dashboard & history — aggregate stats (d), 24-hour usage charts (H)
• Process control — kill sessions (graceful or force), bulk multi-select close, quick-jump to project dir
• Desktop notifications — get notified when sessions complete
• 5 color themes — default, minimal, dracula, solarized, monokai (+ custom)
• Plugin system — extend with custom columns via ~/.ctop/plugins/
• Compaction & rate limit detection — flags compaction events and quota usage
• CLI mode for agents — ctop ls, ctop whoami, ctop alerts, … (see CLI mode)

Installation

# Homebrew
brew tap aakashadesara/ctop && brew install ctop-claude

# npm
npm install -g ctop-claude

# npx (no install)
npx ctop-claude

# From source
git clone https://github.com/aakashadesara/ctop.git
chmod +x ctop/claude-manager
ln -s "$(pwd)/ctop/claude-manager" /usr/local/bin/ctop

Then run ctop. If no agents are running, you'll see an empty state — start a Claude Code, Codex, OpenCode, or Devin session and it'll appear on the next refresh.

Keyboard shortcuts

Mouse: click to select, scroll to navigate, click the ★ gutter to pin/unpin, Shift+click to mark (best-effort).

Pinned sessions

Keep the sessions you care about in view. Press p (or click the ★ in a row's gutter, or the Pin footer button) to pin the session under the cursor — it jumps to a yellow ★ Pinned section at the top and stays there regardless of sort or filter. Pinning works in list, group, and pane views. Pins are keyed by session identity (not pid), so they survive refreshes, the session restarting, and quitting ctop — persisted to ~/.ctop/pins.json. Press p again to unpin.