Keep Claude, Codex, and their orphan ports in line
A read-only TUI that watches your AI agents' tokens, context windows, and stray ports—no API key required.

What it does abtop is a terminal dashboard that scans local process and file state to surface every running Claude Code, Codex CLI, and OpenCode session on one screen. It tracks token usage, context window percentage, rate limits, child processes, and open ports in real time. The tool is fully read-only, requires no API keys, and runs natively on macOS, Linux, and Windows.
The interesting bit
Rather than building yet another cloud dashboard, it reverse-engineers agent state from local SQLite databases, process trees, and filesystem metadata. The only network touch comes from session summaries generated via claude --print, which makes its own API call; everything else stays on your machine.
Key highlights
- Discovers multiple agent profiles and config directories automatically, including
~/.claudeand~/.claude-*roots. - Surfaces orphan ports spawned by agent children and offers a keybinding to wipe them out.
- Jumps directly to a session’s tmux pane with
Enter, turning the dashboard into a launcher. - Ships with 12 themes—four colorblind-friendly—and gracefully degrades its layout on smaller terminals.
- Supports English and Simplified Chinese, auto-detected from
LANG.
Caveats
- OpenCode lags behind Claude Code and Codex CLI: it lacks context window percentage, current task, rate limit, subagent, and memory status visibility, and requires
sqlite3in yourPATH. - The recommended terminal size is 120×40; below 80×24 panels start hiding, so laptop-sized windows may feel cramped.
- Session summaries rely on
claude --print, which makes its own API call—abtop itself never phones home, but that one feature does.
Verdict Grab this if you juggle multiple AI agents and want to catch runaway context windows or forgotten dev servers before they burn your quota. If you only run a single local model with no child processes, you probably don’t need another TUI.
Frequently asked
- What is graykode/abtop?
- A read-only TUI that watches your AI agents' tokens, context windows, and stray ports—no API key required.
- Is abtop open source?
- Yes — graykode/abtop is open source, released under the MIT license.
- What language is abtop written in?
- graykode/abtop is primarily written in Rust.
- How popular is abtop?
- graykode/abtop has 3.4k stars on GitHub and is currently accelerating.
- Where can I find abtop?
- graykode/abtop is on GitHub at https://github.com/graykode/abtop.