Agent Lens 是用于多智能体 Claude Code 会话的实时可观测性仪表盘,通过可视化方式呈现智能体交互、工具使用与会话流程。
用途与界面:提供双栏界面。进程时间线以层级视图展示事件及其父子关系;结果与指标栏展示会话统计、事件详情与性能数据。两栏可在 25%-60% 宽度之间拖动调整。
主要能力:事件可视化支持嵌套时间线、折叠展开子事件、工具类型图标与会话卡片;指标监控包括按会话估算 Token 用量、模型成本(资料称 2026 定价)、工具使用频次、延迟/时长/错误率,以及上下文窗口用量监控。HITL 人工介入提供审批界面的批准/编辑/拒绝三动作模式、超时倒计时、浏览器通知。捕获的事件类型包括 SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SubagentStop、SessionEnd。
使用方式:先启动服务端与客户端,例如 cd ~/.claude/skills/agent-lens/apps/server 后 bun run dev,再于 client 目录执行 bun run dev,或运行 bun run start-obs;浏览器打开 http://localhost:5173。随后打开 Claude Code 使用任意工具或通过 Task 启动子智能体,即可实时看到事件。事件以 JSONL 存储于 ~/.claude/history/raw-outputs/YYYY-MM/YYYY-MM-DD_all-events.jsonl,会话状态存于 ~/.claude/state/agent-lens/sessions/${CLAUDE_SESSION_ID}.json。需在 ~/.claude/settings.json 配置 hooks,capture-all-events 钩子为必需。架构为钩子捕获事件写入文件,Bun 服务端注入内存流,Vue 3 客户端实时展示,无需数据库。
限制:需 Bun 环境与 hooks 配置;功能依赖本地文件系统与 localhost,资料未提供远程部署、鉴权或数据库持久化方案。