abtop
Like htop, but for AI coding agents. Monitor Claude Code & Codex CLI sessions, tokens, context window, rate limits, and ports in real-time.
What is abtop?
Like htop, but for AI coding agents. Monitor Claude Code & Codex CLI sessions, tokens, context window, rate limits, and ports in real-time.
Overview of abtop
What it is
abtop is a terminal user interface (TUI) tool that monitors AI coding agents in real time. It discovers and displays sessions for Claude Code, Codex CLI, and OpenCode from local process and file state. The tool shows token usage, context window percentage, rate limits, child processes, open ports, and other session metadata. It works on macOS, Linux, and Windows without requiring API keys or authentication. All data is read-only.
Key features
- Real-time monitoring of multiple AI coding agents (Claude Code, Codex CLI, OpenCode) in a single TUI - Token usage, context window percentage, and rate limit tracking per session - Orphan port detection and child process monitoring - Session discovery from local process/file state (no API keys or auth required)
- Terminal jump: press Enter to focus the terminal running the selected agent (supports tmux, cmux, iTerm2)
- 12 built-in themes including 4 colorblind-friendly options and 2 light themes - JSON snapshot output (
--json) and a library crate for scripting and integration
Use cases
- Running three or more agents across different projects and wanting to see them all in one screen - Monitoring rate limit quotas in real time to avoid hitting limits - Detecting orphan ports left behind by agents that spawned servers and forgot to kill them - Watching context window fill-up with per-session percentage bars and warnings
Getting started
Install on macOS/Linux: bash curl --proto '=https' --tlsv1.2 -LsSf https://github.com/graykode/abtop/releases/latest/download/abtop-installer.sh | sh Install via Cargo: bash cargo install abtop Install on Windows (native, no WSL): powershell powershell -c 'irm https://github.com/graykode/abtop/releases/latest/download/abtop-installer.ps1 | iex' Basic usage: bash abtop # Launch TUI abtop --once # Print snapshot and exit abtop --json # Print one JSON snapshot and exit abtop --setup # Install rate limit collection hook abtop --theme dracula # Launch with a specific theme abtop --mouse # Enable mouse click/scroll navigation
License and pricing
The project is licensed under MIT and is open source.
Based on the project's public README and repository metadata.