Claude Code Hooks Multi-Agent Observability

不活跃
GitHub Python No License

简介

基于 Claude Code hooks 的实时可观测性工具,通过事件追踪监控多个编码 Agent 的运行过程。

核心特性

  • 通过 WebSocket 将 Claude Code hook 事件实时流式传输到 Vue 仪表板
  • 支持全部 12 种 Claude Code hook 事件类型(PreToolUse、PostToolUse、SessionStart 等)
  • 多 Agent 会话追踪,支持彩色标识和事件过滤
  • 基于 SQLite 的事件存储,配合实时脉搏图可视化活动
  • 聊天记录查看器和可控制滚动的事件时间线
  • 复制 .claude 目录即可集成,几分钟内可跨多个项目使用

适用场景

💡 监控使用 Opus 4.6 并行 Agent 团队的多 Agent 编排工作流
💡 通过追踪工具调用、任务交接和生命周期事件来调试 Agent 行为
💡 审计 Agent 会话以进行合规性和性能分析
💡 在一个仪表板中观察跨不同项目运行的 Claude Code Agent

快速开始

1. 安装前置依赖:Claude Code CLI、Astral uv、Bun/npm 和 ANTHROPIC_API_KEY。
2. 克隆仓库并运行 `just start` 或 `./scripts/start-system.sh`。
3. 打开 http://localhost:5173 查看仪表板。
4. 在 Claude Code 中运行任意命令(如 `git ls-files`),观察事件实时流式传输。
5. 将 `.claude` 文件夹复制到要监控的其他项目中。

相关项目