abtop 智能编码会话监控器
在终端集中查看 AI 编码会话、令牌、上下文、限额与端口。
按维度查看评分与理由
证据显示：项目声明只读、无API密钥、无认证，读取本地文件和进程元数据，权限最小化。但缺少用户确认机制（如杀进程前确认），数据流透明性有说明但未深入，敏感数据处理有隐私说明但JSON快照可能包含敏感内容，依赖安全未审计，外部影响有杀进程和端口操作但无确认，回滚机制未提及，来源归属仅作者信息。扣分：用户确认、依赖安全、回滚、来源归属不足。
证据显示：README与Cargo.toml一致，依赖列表明确，错误处理有提示（如sqlite3缺失警告）。但未提供失败场景的详细说明，依赖可用性未验证。扣分：失败消息不够详细。
证据显示：明确目标用户（多agent开发者），支持多平台，功能边界清晰（支持哪些agent、哪些功能），触发条件明确（命令参数），环境适配有说明（Windows无load average）。扣分：无。
证据显示：README结构清晰，安装说明详细，命名稳定（abtop），有示例和FAQ（部分），已知限制有提及（如OpenCode不支持某些功能），MIT许可证明确，版本号存在但无changelog，维护责任未明确。扣分：版本变更日志缺失，维护责任不明确。
证据显示：输出可用（TUI、JSON快照），边际价值高（解决多agent监控痛点），成本效益合理（免费开源）。扣分：无。
证据显示：README中的声明部分有代码支持（如支持的功能），但未提供测试结果或独立验证，事实与推断未明确区分。扣分：声明可追溯性不足，交叉验证不足，事实与推断分离不足。
- 杀进程和端口操作缺乏用户确认，可能误杀。
- JSON快照可能包含敏感项目上下文，需谨慎处理。
- 依赖安全未审计，建议检查依赖漏洞。
- 版本变更日志缺失，升级风险不明。
这个 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 的本机会话，并展示会话令牌、上下文、限额、进程和端口数据。