Agent Htop

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