agent-top 是一款终端仪表盘,用于监控本地运行的编码智能体。它被描述为“编码智能体的 htop”,旨在解决多个编码智能体会话分散在不同窗口、各自产生费用和资源泄漏、缺乏统一视图的问题。
用途
编码智能体已演变为长时间运行的进程,用户通常会同时开启多个会话,每个会话都有自己的成本消耗和潜在的进程泄漏。没有任何单一工具能同时展示所有这些会话。agent-top 填补了这一空白,像 htop 展示进程、btop 展示整机状态那样,为编码智能体提供统一的监控视图。
主要能力
- 集中视图:在一个终端界面中显示机器上所有 Claude Code、Codex、Gemini CLI 和 OpenCode 会话,以及任何其他可被检测到的编码工具会话。
- 状态监控:STATE 面板显示哪些智能体正在工作、哪些正在等待用户输入。
- 成本追踪:COST 面板显示每个会话截至目前的花费,按标价计算,数据来源于各工具自身的用量记录。
- Token 统计:展示每个会话消耗的 token 数量。
- MCP 泄漏检测:详情窗格中的红色行表示其所属智能体已消失的 MCP 服务器,即泄漏,agent-top 会在每个 tick 检测此类情况。
- 进程关联:显示每个会话遗留的辅助进程。
- 成本报告:可按工具、模型、项目或日期汇总所有会话的总成本。
- 快照与回放:可将整个屏幕保存为一个 JSON 文件,用于错误报告和截图。
使用方式
agent-top 使用 Rust 编写,以单个静态二进制文件形式发布,支持 macOS 和 Linux。无需运行时环境、无需守护进程、无需配置,也无需在智能体中启用任何功能。它读取各工具已经写入的转录记录和操作系统已有的进程表。它从不写入、发送信号或终止任何智能体,数据不会离开本机。
安装、首次运行和快捷键说明可参考“Getting started”文档。实时视图的每个面板、其回答的问题以及数据来源可参考“The live view”文档。
适用场景
- 同时运行多个编码智能体会话,需要统一监控状态和成本。
- 需要追踪各会话的 token 消耗和费用,以便控制预算。
- 需要检测 MCP 服务器泄漏等遗留进程问题。
- 需要生成成本报告,按工具、模型、项目或日期分析支出。
- 需要为错误报告或截图保存当前监控状态的快照。
限制
- 目前仅提供 macOS 和 Linux 版本,暂未提供其他平台信息。
- 具体支持的编码工具以实际检测能力为准,官方文本列举了 Claude Code、Codex、Gemini CLI 和 OpenCode,并说明可检测其他编码工具。
- 费用按标价计算,可能不反映实际折扣或订阅价格。
- 不提供对智能体的控制功能(如终止、发送信号),仅用于监控。
- 其他功能细节、收费模式、价格等信息暂未提供。