Install
npx @ldegio/agtopclaude mcp add agtop -- npx @ldegio/agtop{
"mcpServers": {
"agtop": {
"command": "npx",
"args": [
"@ldegio/agtop"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →agtop
Run with:
npx @ldegio/agtop
Your window into what your AI coding agents are doing, sitting in the terminal, where you run them. agtop is a top-style terminal dashboard that tracks every Claude Code and Codex session on your machine: spend, token usage, context pressure, CPU load, tool invocations, and more. All in one place, live.
Features
- Session discovery -- automatically finds Claude Code (
~/.claude/projects/) and Codex (~/.codex/sessions/) sessions - Cost tracking -- per-session spend with hourly and daily breakdowns; plan-aware billing (retail, Max, included)
- Context pressure -- CTX% shows how full each agent's context window is
- Live toggle -- filter to running sessions with real-time CPU%, cost rates, and incremental tool counts
- Performance panel -- per-session CPU and memory sparkline charts over time
- Processes panel -- live process tree showing child processes with CPU%, memory, and command lines
- Tool Activity panel -- scrollable per-tool invocation history with timestamps; see exactly what each agent has been doing
- Cost panel -- total spend by time window with per-model token and cost breakdown
- Config panel -- browse CLAUDE.md/AGENTS.md, memories, skills, MCP servers, and permissions per session
- Subagents panel -- list the subagents a session dispatched (type, model, description, cost, tools, duration); includes "ghost" rows reconstructed from the parent transcript when Claude Code has purged the subagent's own jsonl. Expand a session row in the list to inspect or drill into each subagent.
- OS process metrics -- CPU% and PID count for running sessions (macOS/Linux/Windows)
- Overview sparklines -- aggregate spend, tokens, and CPU charts at a glance
- Detail view -- full cost breakdown, token split, per-model stats, and complete tool history
- Session management -- delete non-running sessions with confirmation
- Inactivity filter -- filter sessions by age (1 day, 1 week, 1 month)
- Mouse support -- click to select, sort by column, switch tabs; hover tooltips on column headers
- Non-interactive modes -- table and full JSON dump for scripting
Setup
The npx command at the top of this page runs agtop without installing it. To install it permanently so agtop is always available in your terminal:
npm install -g @ldegio/agtop
agtop
npm uninstall -g @ldegio/agtop
Requires Node.js >= 18. No other dependencies.
Options
| Flag | Description |
|---|---|
-l, --list |
List sessions in a table and exit |
-j, --json |
Dump full session data as JSON and exit |
-p, --plan |
Billing plan for cost display (default: retail) |
-d, --delay <secs> |
Refresh interval in seconds (default: 2) |
-h, --help |
Show help |
Keyboard Shortcuts
Similar plugs
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
Bash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1
Documented system prompts from Anthropic - Claude Fable 5.1, Opus 5.5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro,…
Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build, Muse Code, Devin as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini…