acunningham-ship-it

Agent Htop — AI skill for Claude Code

AI community

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

[![Demo](https://asciinema.org/a/placeholder.svg)](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