Agent Htop — AI skill for Claude Code
Terminal dashboard for AI agent fleets (Paperclip, Claude Code, Codex).
How to install Agent Htop
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open acunningham-ship-it/agent-htop and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Agent Htop does
Terminal dashboard for AI agent fleets (Paperclip, Claude Code, Codex). htop but for your agents.
Alternatives in AI
- Claude Squad — by smtg-ai - Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents i 6.5k ★
- AI In The Terminal — Complete companion guide for NetworkChuck's 'AI in the Terminal' video - Gemini CLI, Claude Code, Codex, and o 855 ★
- Tokentap — Intercept LLM API traffic and visualize token usage in a real-time terminal dashboard 763 ★
README
agent-htop
Real-time terminal dashboard for Claude Code sessions, Paperclip agent fleets, and more. Monitor costs, tokens, and agent status without leaving the terminal.
Demo
[](https://asciinema.org/a/placeholder)
Or watch the recording in your terminal:
asciinema play agent-htop-demo.cast
agent-htop v0.3.0 sessions: 3 running: 2 cost today: $0.42 [q]uit
NAME STATUS MODEL TOKENS IN TOKENS OUT COST ELAPSED LAST TOOL
────────────────────────────────────────────────────────────────────────────────────────────────────────
-home-armani-projects-fnaf running claude-sonnet 142,310 8,421 $0.0234 12m 34s Bash
-home-armani-projects-api running claude-haiku 98,002 6,103 $0.0171 8m 12s Write
-home-armani-projects-web idle claude-haiku 43,118 2,940 $0.0041 3m 07s Read
**In the demo:** Navigate sessions with `j`/`k`, filter with `f`, sort by cost with `s`, and quit with `q`.
Install
**From source:**
go install github.com/acunningham-ship-it/agent-htop/cmd/agent-htop@latest
**Via Homebrew:**
brew install acunningham-ship-it/tap/agent-htop
Requires Go 1.21+.
Quick start
**For Claude Code sessions (no setup needed):**
agent-htop
Auto-discovers your sessions from `~/.claude/projects/**/*.jsonl`.
**For Paperclip agent fleets:**
agent-htop --company
Displays your local Claude Code sessions alongside Paperclip agents with kill/pause control.
Supported runtimes
| Runtime | Auto-discovered | Kill support | Cost tracking |
|---|---|---|---|
| Claude Code | ~/.claude/projects/**/*.jsonl |
No (read-only) | Yes |
| Codex | ~/.codex/ |
No | Planned |
| Paperclip | --company |
Yes | Yes |
Keybindings
| Key | Action |
|---|---|
↑ / k |
Nav |
Related Skills
Agentop
📊 Terminal UI for monitoring AI coding agents — like htop for Claude Code, Codex, and Antigravity.
Vibe Cockpit
Real-time monitoring dashboard for AI coding agent fleets: session health, output streaming, and observability
Nudge
Manage AI agent fleets (Codex, Claude Code, Gemini) running in tmux. Dashboard over monitored sessions, add/pa
Flywheel Gateway
SDK-first orchestration platform for managing AI coding agent fleets: BYOA key rotation, real-time WebSocket d
Frankenterm
Terminal hypervisor for AI agent swarms: real-time pane capture, state-machine pattern detection, and a JSON A
Unterm
The terminal AI agents can drive — and the cockpit to run them from. 99 MCP methods / 21 namespaces, agent Inb
Related Agents
Agent Of Empires
Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI Coding Agent Terminal Session manager via tmux and
Contract Neutral Reviewer
Contract-neutral fallback reviewer. Executes the attached family review template verbatim when Codex is unavai
Abtop
AI agent monitor for your terminal. Like btop++, but for AI coding agents. Supports Claude Code and Codex CLI.