Usage

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.

tmux

abtop works standalone, but running inside tmux unlocks session jumping — press Enter to switch directly to the pane running that agent.

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 | OpenCode | | ----------------- | :---------: | :-------: | :------: | | Session Discovery | ✅ | ✅ | ✅ | | Token Tracking | ✅ | ✅ | ✅ | | Context Window % | ✅ | ✅ | ❌ | | Status Detection | ✅ | ✅ | ✅ | | Current Task | ✅ | ✅ | ❌ | | Rate Limit | ✅ | ✅ | ❌ | | Git Status | ✅ | ✅ | ✅ | | Children / Ports | ✅ | ✅ | ✅ | | Subagents | ✅ | ❌ | ❌ | | Memory Status | ✅ | ❌ | ❌ |

OpenCode support reads the local SQLite database at ~/.local/share/opencode/opencode.db and requires sqlite3 in PATH.

Themes

12 built-in themes, including 4 colorblind-friendly options (high-contrast, protanopia, deuteranopia, tritanopia). Press t to cycle at runtime, or launch with --theme <name>. 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 | |:-:|:-:| | | |

Light themes (light — Solarized cream, white — GitHub-style pure white) for bright terminals:

| light | white | |:-:|:-:| | | |

Configuration

~/.config/abtop/config.toml supports:

theme = "btop"
# Hide specific agent CLIs from the TUI (case-insensitive).
# Useful if you only use one agent and want a cleaner view.
hidden_agents = ["codex"]
# UI language. Omit or leave empty to auto-detect from LANG.
language = "zh"

Supported Languages

| Code | Language | | ---- | ------------------- | | en | English (default) | | zh | Simplified Chinese |

When language is unset, abtop auto-detects from LANG — any value starting with zh switches to Simplified Chinese, otherwise English.

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 and local process/open-file metadata 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.

Acknowledgements

Huge thanks to @tbouquet for driving much of abtop's recent shape — themes, config overlay and panel toggles, session filtering, subagent tree view, the context window gauge with compaction detection, plus a steady stream of fixes and security hardening along the way.

License

MIT