btopfor AI agents.
See what your agents are doing. Real-time terminal dashboard.
$ brew install pattynextdoor/tap/tophWhat toph senses
Sessions
Every running Claude Code session across your machine. Active, idle, waiting for permission — toph sees them all by watching ~/.claude/projects/ for filesystem vibrations.
Token flow
input_tokens, output_tokens, cache_read, burn rate. toph parses every assistant response to track context window fill and estimated cost in real-time.
Tool calls
Bash, Edit, Read, Write, Grep — every tool invocation your agents make, streamed into a live activity feed. See what your agents are doing the moment they do it.
Under the hood
Your Claude Code sessions generate rich JSONL logs — tool calls, token usage, cost data, subagent activity. toph reads these in real-time, no API keys required.
JSONL Logs
Session files at ~/.claude/projects/ with every message, tool call, and usage record. toph watches them with fsnotify.
~/.claude/projects/{hash}/{session}.jsonl
Hooks
6 lifecycle events: intercept tool calls, track subagents, and capture notifications. Opt-in for richer real-time data.
PreToolUse · PostToolUse · Stop · SubagentStart · SubagentStop · Notification
Process Scan
Detects running claude processes for CPU and memory usage. Works as a fallback even without log access.
ps aux | grep claude
Live event capture
Every tool call your agents run is captured as JSONL. toph watches these logs and renders them across five panels in real-time.
Get started
Install
$ brew install pattynextdoor/tap/toph
Single binary. No dependencies.
Run your agents
$ claude
Start Claude Code sessions as usual. Nothing changes about your workflow.
Watch
$ toph
That's it. toph finds your sessions automatically and shows you everything.
panels
hook events
fps rendering
config needed
Open source
Built with Go and Bubble Tea. MIT licensed. Contributions welcome.