SkillFoxx

CTOP CLI

An htop-like terminal panel for AI agents: Claude Code, Codex, OpenCode and Devin sessions, CPU, tokens and cost.

  • 94 ★ on the repository
  • Last commit
  • MIT
CLI

Extended access

Why this level

  • Reads the process list and agent session logs and can terminate processes with a signal
  • Column plugins run code from `~/.ctop/plugins/`
All reasons and checks

aakashadesara/ctopAuthor:aakashadesara

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add cli/ctop

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Reads the process list and agent session logs and can terminate processes with a signal
  • Column plugins run code from `~/.ctop/plugins/`

This is third-party code. Review the repository files before installing.

What it does

CTOP shows all running coding agent sessions in one terminal pane: Claude Code, Codex CLI, OpenCode and Devin. For each it displays CPU and memory load, status, branch and model, context window fill split into input, cache, output and free segments, a cost estimate per session and in total at Claude and OpenAI pricing. The panel switches between a table and a card grid, tails the live conversation log in a split pane and sorts, filters and searches conversation text. Sessions can be closed gently or by force and selected in bulk. There are desktop notifications, five color themes and column plugins. A command mode for agents offers `ctop ls`, `ctop whoami` and `ctop alerts`.

Who it is for. Developers who keep several agent sessions open and want to see context use and cost before a failure.

Good fit when

  • Five sessions run in parallel and you need to see which one ate the context and money.
  • A hung or ghost session must be found and closed gently, then by force.
  • An agent must learn which session it runs in: `ctop whoami` helps.
  • Context compaction and nearing the quota limit should be flagged in advance.

Not a fit when

  • You need cloud cost analytics for a team: CTOP is local and shows only your machine's processes.
  • Agents run on remote servers where process list access is missing.
  • You need exact bills: cost is an estimate at public prices.

Example request

Run ctop ls --json and show sessions with little free context left.

Limitations

Cost is computed from public Claude and OpenAI prices and remains an estimate and serves as no bill. CTOP reads processes and session logs on your machine, so it sees only local runs. Node.js 18 or newer is required, there are no dependencies, platforms are macOS, Linux and Windows. Sessions are closed by a process signal, and a forced close cuts the agent off without saving. Column plugins load from `~/.ctop/plugins/` and run your code, so add only your own.

How to disable. Quit the panel and remove the package with `npm uninstall -g ctop-claude` or `brew uninstall ctop-claude`. The `~/.ctop` folder with plugins and settings is erased by hand.

FAQ

Which agents are visible?

Claude Code, Codex CLI, OpenCode and Devin. If none runs, the panel is empty and refreshes when a session starts.

How do I run it without installing?

With `npx ctop-claude`. A permanent install uses `npm install -g ctop-claude` or Homebrew.

What does the command mode do?

`ctop ls` prints a table of sessions with `--json`, `--agent` and `--cwd`. `ctop whoami` detects your session and `ctop alerts` shows warnings.

Can I extend the columns?

Yes, plugins load from `~/.ctop/plugins/`, and there are five themes: default, minimal, dracula, solarized and monokai.

How do I switch the view?

`P` toggles table and card grid, `L` turns on the log, `d` opens the dashboard and `H` shows the 24-hour chart.

Discussion

No questions or reviews yet.

CLI tools

A terminal dashboard for Claude Code and Codex: a tree of agents with live status, a tool-call feed and context headroom.

CLIMinimal access64

A local dashboard for Claude Code, Codex CLI, Gemini CLI, Copilot and OpenCode that shows tokens, cost, latency and errors

CLIExtended access292

OpenTelemetry-based CLI tracing for Claude Code, Cursor and Codex sessions, showing what the agent actually did and what it cost

CLIExtended access3.1K

Tokscale

tokscale

A CLI with an interactive TUI that tracks token usage and cost across AI coding agents: Claude Code, Codex, Copilot, Cursor and more

CLIExtended access5.8K

A local dashboard for Claude Code and Codex sessions: who is working, who waits for you, plus a 3D aquarium and Stream Deck

CLIExtended access296

A monitoring dashboard for OpenClaw agents: sessions, token and cost use, system load and scheduled jobs in one browser window

SkillExtended access250

README in short

The README describes the panel features, installation through Homebrew, npm and source, keyboard shortcuts and the command mode for agents.

README badge

Report a problem