abtop 智能编码会话监控器
在终端集中查看 AI 编码会话、令牌、上下文、限额与端口。
这个 Agent 能做什么，适合哪些场景？
abtop 是一款 Rust 终端监控工具，以 TUI、一次性文本输出和 JSON 快照展示本机 AI 编码会话。它从本地进程、文件和打开文件元数据发现 Claude Code、Codex CLI 与 OpenCode 会话，可同时扫描多个 Claude 配置目录。界面可显示令牌用量、上下文窗口比例、状态、Git 状态、子进程、监听端口及部分会话特有信息，并提供主题、面板和语言配置。它既可作为命令行程序运行，也可作为库通过 App 收集数据并序列化 Snapshot；不会要求 API 密钥或认证。
启动后，abtop 从本地进程、文件状态及打开文件元数据发现 Claude Code、Codex CLI 和 OpenCode 会话；OpenCode 通过 sqlite3 读取本地 opencode.db。它汇总令牌、上下文窗口百分比、速率限制、当前任务、Git 状态、子进程和端口信息，并在 TUI 中展示。可使用 abtop --once 输出一次快照，或使用 abtop --json 输出供脚本处理的 JSON。库使用者可创建 App，调用 App::tick_no_summaries() 刷新，再用 App::to_snapshot(interval_ms) 获取可序列化的 Snapshot；该刷新路径不会运行 claude --print。
- 同时在多个项目运行 Claude Code 的开发者，可在一个终端屏幕查看各会话的令牌、上下文占用和状态。
- 使用 Codex CLI 编码且担心子进程遗留服务的开发者，可检查会话关联进程和开放端口。
- 使用 OpenCode 的本机用户，可在安装 sqlite3 后将其会话与 Claude Code、Codex CLI 一并查看。
- 需要把本机编码会话状态接入自建仪表盘的团队，可通过 abtop --json 或 Snapshot API 获取一次 JSON 数据。
- 在 tmux、cmux 或 macOS iTerm2 中管理多窗格会话的用户，可在选中会话后按 Enter 跳转到相应终端。
这个 Agent 有哪些优点和局限？
- 同时覆盖 Claude Code、Codex CLI 和 OpenCode，并基于本地状态支持多个活跃配置档案。
- 除 TUI 外还提供 --json 和可复用的 App/Snapshot 库接口，便于本地脚本或仪表盘使用。
- 可观察会话级令牌、上下文、限额、子进程和端口，而非只显示主机指标。
- 默认关闭鼠标捕获以保留终端拖选复制，并提供 12 个内置主题和 4 个色觉障碍友好主题。
- OpenCode 会话发现依赖 sqlite3；缺少该命令时无法完成其监控。
- 会话摘要通过 claude --print 生成，会触发自己的 API 调用并消耗 Claude 配额。
- OpenCode 不提供上下文窗口百分比、当前任务或速率限制；Codex CLI 不提供子代理和内存状态。
- 推荐终端尺寸为 120x40；小于 80x24 时面板会隐藏，Windows 上 LOAD 固定显示为 0。
如何安装或部署这个 Agent？
macOS 或 Linux：运行 curl --proto '=https' --tlsv1.2 -LsSf https://github.com/graykode/abtop/releases/latest/download/abtop-installer.sh | sh，或运行 cargo install abtop。Windows：运行 powershell -c "irm https://github.com/graykode/abtop/releases/latest/download/abtop-installer.ps1 | iex"，也可在 Git 位于 PATH 的终端执行 cargo install abtop。监控 OpenCode 时需安装 sqlite3；Windows 可执行 winget install SQLite.SQLite。首次运行 abtop 启动 TUI。
如何使用这个 Agent？
运行 abtop 启动交互式界面；运行 abtop --once 打印一次快照；运行 abtop --json 输出一次 JSON 快照。可用 abtop --setup 安装速率限制收集钩子，abtop --theme dracula 指定主题，或 abtop --mouse 启用鼠标操作。配置文件为 ~/.config/abtop/config.toml，可设置 theme、hidden_agents、claude_config_dirs 和 language。
这个 Agent 与同类方案有什么区别？
README 将 abtop 定位为“类似 btop、但面向 AI 编码代理”的工具。与这一定位相比，abtop 专门发现 Claude Code、Codex CLI 和 OpenCode 的本机会话，并展示会话令牌、上下文、限额、进程和端口数据。