# abtop

> A terminal UI monitor for AI coding agents — like btop but for Claude Code, Codex CLI, and OpenCode sessions, showing token usage, context window, rate limits, and ports in real-time.

abtop is an open-source terminal UI tool built in Rust by Tae Hwan Jung (graykode) that brings btop-style process monitoring to AI coding agent sessions. It runs entirely read-only against local process and file state — no API keys, no authentication required — and supports Claude Code, Codex CLI, and OpenCode across macOS, Linux, and Windows.

## What It Is

abtop is a TUI (terminal user interface) dashboard that aggregates live data from multiple AI coding agent sessions running on your machine. Inspired by btop and htop, it surfaces per-session metrics — token counts, context window fill percentage, rate limit status, child processes, and open ports — all in a single terminal view. It is written in Rust using the ratatui library and released under the MIT license.

## How It Works

abtop discovers agent sessions from local process metadata and config files rather than intercepting network traffic or requiring API credentials:

- **Claude Code** sessions are read from `~/.claude` and any additional profile roots configured in `config.toml`
- **OpenCode** sessions are read from a local SQLite database at `~/.local/share/opencode/opencode.db`
- **Codex CLI** sessions are discovered from local process state
- Port detection uses `sysinfo` on macOS/Linux and `netstat -ano` on Windows
- Session summaries are generated via `claude --print`, which is the only indirect network call

The tool exposes a `--json` flag and a Rust library crate so other tools can consume the same data layer without re-scanning.

## Supported Agents and Feature Matrix

Feature coverage varies by agent. As of the README:

- **Claude Code**: full support — session discovery, token tracking, context window %, status detection, current task, rate limits, git status, children/ports, subagents, and memory status
- **Codex CLI**: session discovery, token tracking, context window %, status, current task, rate limits, git status, children/ports
- **OpenCode**: session discovery, token tracking, status, git status, children/ports (no context window %, current task, rate limits, subagents, or memory status)

## Themes and Customization

abtop ships with 12 built-in themes including popular developer palettes (dracula, catppuccin, tokyo-night, gruvbox, nord) and 4 colorblind-friendly options (high-contrast, protanopia, deuteranopia, tritanopia). Light themes (solarized cream and GitHub-style white) are available for bright terminals. Theme selection persists to `~/.config/abtop/config.toml` and can be cycled at runtime with the `t` key.

Configuration also supports hiding specific agent CLIs, adding extra Claude profile roots to scan, and setting the UI language (English or Simplified Chinese, with auto-detection from `LANG`).

## Update: v0.5.1

The latest release is **v0.5.1**, published on 2026-06-29. The project was created in March 2026 and has accumulated over 3,100 stars and 290 forks on GitHub as of the last recorded update. Recent development — credited in the README to contributor @tbouquet — added themes, a config overlay, panel toggles, session filtering, a subagent tree view, a context window gauge with compaction detection, and security hardening. The project is actively maintained with 18 open issues at last check.

## Features
- Real-time TUI dashboard for AI coding agent sessions
- Token usage tracking per session
- Context window fill percentage with warning bars
- Rate limit monitoring
- Child process and orphan port detection
- Terminal jump to agent session (tmux, cmux, iTerm2)
- Kill session or orphan ports from TUI
- JSON snapshot output for scripting
- Rust library crate for programmatic data access
- 12 built-in themes including 4 colorblind-friendly options
- Multi-profile Claude Code support
- OpenCode SQLite database integration
- Subagent tree view for Claude Code
- Memory status monitoring for Claude Code
- Git status per session
- UI language support (English, Simplified Chinese)
- Panel visibility toggles
- No API keys or authentication required

## Integrations
Claude Code, Codex CLI, OpenCode, tmux, cmux, iTerm2, SQLite (for OpenCode sessions)

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v0.5.1

## Links
- Website: https://github.com/graykode/abtop
- Documentation: https://github.com/graykode/abtop#readme
- Repository: https://github.com/graykode/abtop
- EveryDev.ai: https://www.everydev.ai/tools/abtop