abtop

就像 btop 一样，但专为你的 AI 编码 Agent 设计。

一眼洞察所有 Claude Code、Codex CLI 和 OpenCode 会话——包括 Token 使用情况、上下文窗口百分比、速率限制、子进程、开放端口等信息。 abtop 通过本地进程/文件状态发现 Claude Code、Codex CLI 和 OpenCode 会话，因此支持在 macOS、Linux 和 Windows 上管理多个活跃配置。

demo

为什么选择 abtop

在不同项目中运行了 3 个以上的 Agent？可以在一个屏幕上查看所有内容。
触碰速率限制（Rate Limits）了？实时监控你的额度。
Agent 生成了服务却忘了关闭？提供孤立端口检测功能。
上下文窗口快满了？查看每个会话的百分比进度条及预警。

全只读操作。无需 API Key，无需身份验证。

安装

macOS / Linux

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/graykode/abtop/releases/latest/download/abtop-installer.sh | sh

Cargo

cargo install abtop

Windows

原生支持，无需 WSL。通过 sysinfo 获取进程信息，使用 netstat -ano 监控监听端口。

powershell -c "irm https://github.com/graykode/abtop/releases/latest/download/abtop-installer.ps1 | iex"

或者在任何 Git 已加入 PATH 的终端中运行 cargo install abtop。Claude Code 配置会自动从 %USERPROFILE%\.claude 中读取。

其他

所有平台的预构建二进制文件均可在 GitHub Releases 页面获取。

使用方法

abtop                    # 启动 TUI
abtop --once             # 打印一次快照后退出
abtop --setup            # 安装速率限制采集钩子
abtop --theme dracula    # 使用指定主题启动

推荐终端尺寸：120x40 或更大。最小支持 80x24——在窗口较小时面板会自动精简隐藏。

tmux

abtop 可以独立运行，但在 tmux 中运行可解锁会话跳转功能——按下 Enter 键即可直接切换到运行该 Agent 的面板。

tmux new -s work
# pane 0: abtop
# pane 1: claude (project A)
# pane 2: claude (project B)
# → 在 abtop 中按下 Enter 即可跳转到对应面板

支持的 Agent

功能	Claude Code	Codex CLI	OpenCode
会话发现	✅	✅	✅
Token 追踪	✅	✅	✅
上下文窗口 %	✅	✅	❌
状态检测	✅	✅	✅
当前任务	✅	✅	❌
速率限制	✅	✅	❌
Git 状态	✅	✅	✅
子进程/端口	✅	✅	✅
子 Agent	✅	❌	❌
内存状态	✅	❌	❌

OpenCode 支持功能需读取位于 ~/.local/share/opencode/opencode.db 的本地 SQLite 数据库，并要求 PATH 中包含 sqlite3。

主题

内置 12 款主题，包括 4 款色盲友好型方案（high-contrast、protanopia、deuteranopia、tritanopia）。按下 t 键可在运行时循环切换，或使用 --theme 参数启动。你的选择将保存至 ~/.config/abtop/config.toml。

btop (默认)	dracula	catppuccin

tokyo-night	gruvbox	nord

色盲友好主题：

high-contrast	protanopia

deuteranopia	tritanopia

亮色主题（light — Solarized 奶油色，white — GitHub 风格纯白）适用于明亮环境下的终端：

light	white

配置

~/.config/abtop/config.toml 支持以下配置：

theme = "btop"
# 从 TUI 中隐藏特定的 Agent CLI（不区分大小写）。
# 如果你只使用一个 Agent 并希望界面更简洁，此项非常有用。
hidden_agents = ["codex"]