simple10/agents-observe

解决的问题

当 AI 代理（如 Claude Code）自主运行时，其内部流程——例如生成子代理、执行 bash 命令和读取文件——通常对用户是不可见的。这种不透明性使得难以实时了解代理正在执行的操作，或调试并行执行链深处发生的故障。

工作原理

Agents Observe 使用钩子系统，在每个代理事件（工具调用、提示词、子代理生命周期）触发时进行响应。CLI 工具捕获这些事件，并通过 HTTP POST 将其发送到后端服务器（在 Docker 中运行），后端服务器将事件存储在 SQLite 数据库中。一个基于 React 的仪表板通过 WebSocket 实时流式传输这些事件，使用户能够可视化代理层级结构、工具使用情况和会话历史。

适用人群

需要深入洞察 AI 代理自主行为以进行调试、监控和分析代理工作流的 Claude Code 或 Codex 代理使用者。

主要亮点

• 实时监控：实时查看工具调用和代理活动流入仪表板的过程。
• 代理层级可视化：清晰查看哪个父代理生成了哪些子代理。
• Token 与成本追踪：监控每个会话的 Token 使用量和成本明细。
• 完整事件回放：浏览历史会话，包含完整的负载、命令和结果，实现“时间旅行”式调试。
• 集成插件：可直接作为 Claude Code 插件安装，支持专用斜杠命令（如 /observe status）进行管理。