https://github.com/graykode/abtop
Like htop, but for AI coding agents. Monitor Claude Code & Codex CLI sessions, tokens, context window, rate limits, and ports in real-time.
https://github.com/graykode/abtop
ai-agents ai-coding-agent btop claude-code cli codex developer-tools htop monitor ratatui rust terminal tui
Last synced: 8 days ago
JSON representation
Like htop, but for AI coding agents. Monitor Claude Code & Codex CLI sessions, tokens, context window, rate limits, and ports in real-time.
- Host: GitHub
- URL: https://github.com/graykode/abtop
- Owner: graykode
- License: mit
- Created: 2026-03-29T10:12:20.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-19T12:04:28.000Z (13 days ago)
- Last Synced: 2026-04-19T14:03:55.183Z (12 days ago)
- Topics: ai-agents, ai-coding-agent, btop, claude-code, cli, codex, developer-tools, htop, monitor, ratatui, rust, terminal, tui
- Language: Rust
- Homepage:
- Size: 11.3 MB
- Stars: 449
- Watchers: 4
- Forks: 46
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# abtop
**Like htop, but for your AI coding agents.**
See every Claude Code and Codex CLI session at a glance — token usage, context window %, rate limits, child processes, open ports, and more.
## Why
- Running 3+ agents across projects? See them all in one screen.
- Hitting rate limits? Watch your quota in real-time.
- Agent spawned a server and forgot to kill it? Orphan port detection.
- Context window filling up? Per-session % bars with warnings.
All read-only. No API keys. No auth.
## Install
### macOS / Linux
```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/graykode/abtop/releases/latest/download/abtop-installer.sh | sh
```
### Cargo
```bash
cargo install abtop
```
### Other
Pre-built binaries for all platforms are available on the [GitHub Releases](https://github.com/graykode/abtop/releases) page.
## Usage
```bash
abtop # Launch TUI
abtop --once # Print snapshot and exit
abtop --setup # Install rate limit collection hook
abtop --theme dracula # Launch with a specific theme
```
Recommended terminal size: **120x40** or larger. Minimum 80x24 — panels hide gracefully when small.
### Windows
abtop requires Unix tools (`ps`, `lsof`) and is not supported natively on Windows. Use [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) instead:
```bash
wsl --install
# Inside WSL:
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/graykode/abtop/releases/latest/download/abtop-installer.sh | sh
abtop
```
### tmux
abtop works standalone, but running inside tmux unlocks session jumping — press `Enter` to switch directly to the pane running that agent.
```bash
tmux new -s work
# pane 0: abtop
# pane 1: claude (project A)
# pane 2: claude (project B)
# → Enter on a session in abtop jumps to its pane
```
## Supported Agents
| Feature | Claude Code | Codex CLI |
| ----------------- | :---------: | :-------: |
| Session Discovery | ✅ | ✅ |
| Token Tracking | ✅ | ✅ |
| Context Window % | ✅ | ✅ |
| Status Detection | ✅ | ✅ |
| Current Task | ✅ | ✅ |
| Rate Limit | ✅ | ✅ |
| Git Status | ✅ | ✅ |
| Children / Ports | ✅ | ✅ |
| Subagents | ✅ | ❌ |
| Memory Status | ✅ | ❌ |
## Themes
10 built-in themes, including 4 colorblind-friendly options (`high-contrast`, `protanopia`, `deuteranopia`, `tritanopia`). Press `t` to cycle at runtime, or launch with `--theme `. Your choice is saved to `~/.config/abtop/config.toml`.
| btop (default) | dracula | catppuccin |
|:-:|:-:|:-:|
|  |  |  |
| tokyo-night | gruvbox | nord |
|:-:|:-:|:-:|
|  |  |  |
Colorblind-friendly themes:
| high-contrast | protanopia |
|:-:|:-:|
|  |  |
| deuteranopia | tritanopia |
|:-:|:-:|
|  |  |
Theme support contributed by [@tbouquet](https://github.com/tbouquet).
## Key Bindings
| Key | Action |
| ------------------ | ------------------------------------ |
| `↑`/`↓` or `k`/`j` | Select session |
| `Enter` | Jump to session terminal (tmux only) |
| `x` | Kill selected session |
| `X` | Kill all orphan ports |
| `t` | Cycle theme |
| `1`–`5` | Toggle panel visibility |
| `Esc` | Open/close config page |
| `q` | Quit |
| `r` | Force refresh |
## Privacy
abtop reads local files only. No API keys, no auth. Tool names and file paths are shown in the UI, but file contents and prompt text are never displayed. Session summaries are generated via `claude --print`, which makes its own API call — this is the only indirect network usage.
## License
MIT