| Dark | Light |
|---|---|
 |
 |
- 让 Claude Code 往东，它偏要往西，还自己发明一个新方向
- 让它“参考这个文档”，它秒回“好的，我已经参考了”，实际上连文件都没打开
- 你追问：“你真看了吗？”它理直气壮：“看了。”
- 你翻遍终端日志，也抓不到它“偷懒”的实锤，一肚子火
别再猜 Agent 做了什么——让每一步都有迹可循。
AgentLens 只做一件事：
把 AI 干活时的所有“小动作”记录下来，放到网页里让你实时围观。
- 它调用了什么工具
- 它读了哪个文件，还是假装读了其实没读
- 它执行了什么命令，输出是什么
- 它是真的“参考了文档”，还是张口就来
所有动作，尽收眼底。
在此基础上，AgentLens 将 Agent 的本地 Session 日志与模型请求记录整理到同一个 Viewer 中，让执行过程可以被搜索、比较、回放和导出。
以 Session → Task → Conversation → Step / Turn 的结构查看用户请求、Agent 回复、思考过程、工具调用和工具结果。默认视图突出主要执行步骤，调试视图保留完整事件。
在当前 Session、当前项目或全部项目中搜索 Session、Task、Turn 和事件，并直接跳转到命中位置。通过 Request / Response 页面查看实际模型请求及流式响应。
比较相邻 Turn 的结构变化，定位新增、删除和修改的上下文字段。对于包含真实用户消息的历史请求，可以原文回放，也可以修改 Prompt 后重新发送，用于验证响应或比较不同写法。
使用本地规则自动切分长 Session，也可以手动创建 Task，或调整、拆分、合并和删除已有 Task 边界，使执行轨迹更适合复盘。
从当前 Session 生成分析报告；将确认后的 Task 保存为标准 Dataset，包括 manifest.json、dataset.jsonl、traces/*.json 和 scores.jsonl，用于后续评测、分析或训练数据转换。
将 Session 与相关请求记录导出为压缩包，也可以重新导入并在 Viewer 中打开，便于复现问题和协作排查。
- macOS、Linux 或 WSL
- Python 3.10+
- Windows 原生环境暂不支持
安装脚本会检查 Python，并在需要时安装 mitmproxy。
curl -fsSL https://raw.githubusercontent.com/PacemakerG/CCWhat/main/install.sh | bash安装完成后检查版本：
ccwhat --versioncurl -fsSL https://raw.githubusercontent.com/PacemakerG/CCWhat/main/install.sh | bash -s -- uninstall卸载不会删除 ~/.ccwhat 中的本地配置和记录。
在原命令前加上 ccwhat --：
ccwhat -- claude
ccwhat -- codex
ccwhat -- opencodeAgentLens 会根据目标 Agent 读取本地配置、启动记录服务，并自动打开 Viewer。首次运行如果仍缺少录制目标，会进入配置引导。
Viewer 默认运行在 http://127.0.0.1:7789。如果关闭了页面，可以重新打开：
ccwhat web --agent claude
ccwhat web --agent codex
ccwhat web --agent opencode进入 Viewer 后，可以：
- 选择 Agent、项目和 Session。
- 在 Session 页面查看主要执行步骤或完整调试事件。
- 在 Tasks 页面自动或手动切分任务，并校正 Task Trace。
- 使用 Search、Req / Resp、Diff 和 Diagnostics 定位问题。
- 根据需要生成报告、保存 Dataset 或导出 Session。
| 命令 | 用途 |
|---|---|
ccwhat setup |
修改录制目标和路径配置 |
ccwhat discover -- claude |
只记录流量元数据，发现需要录制的 API 地址 |
ccwhat --no-web -- codex |
启动记录，但不自动打开 Viewer |
ccwhat web --agent opencode |
打开指定 Agent 的 Viewer |
ccwhat export --list |
列出可导出的 Session |
ccwhat export <session-id> |
导出指定 Session |
ccwhat import <archive.tar.gz> --open |
导入压缩包并打开 Viewer |
AgentLens 会尝试从 Claude Code、Codex 和 OpenCode 的本地配置中发现 API 地址。使用中转服务或自定义模型提供商时，如果地址没有被自动识别，可以运行：
ccwhat setup如果不确定实际请求地址，可以先使用 Discovery 模式：
ccwhat discover -- claudeDiscovery 模式只保存请求方法、地址、状态码和内容类型等元数据，不保存请求或响应正文。
AgentLens 组合两类证据：
- Agent 本地日志：通过独立 Adapter 读取 Claude Code、Codex 和 OpenCode 的原生 Session 数据。
- 模型请求记录：通过本地
mitmproxy记录配置范围内的 HTTP / HTTPS 请求与响应。
本地 Viewer 将两类数据关联起来，提供 Session 导航、Task 切分、全局搜索、Turn Diff、请求回放、报告分析和 Dataset 导出。
- Viewer、配置、请求记录和 Dataset 默认保存在本机。
Authorization、Cookie、Set-Cookie、X-API-Key等敏感 Header 默认会被替换为[REDACTED]。- 请求和响应正文仍可能包含 Prompt、代码或其他业务数据，分享导出文件前应自行检查。
- HTTPS 记录需要信任
mitmproxy的本地 CA 证书；AgentLens 只记录配置中匹配的目标地址和路径。 - 不需要保存正文时，优先使用 Discovery 模式。
默认数据目录：
~/.ccwhat/
├── config.toml
├── raw-req-resp/
└── datasets/
| 平台 | 状态 |
|---|---|
| macOS | 支持 |
| Linux | 支持 |
| WSL | 支持 |
| Windows 原生环境 | 暂不支持 |
不同 Agent 的本地日志结构和可写能力不同。例如，Codex 和 OpenCode 支持在 Viewer 中重命名 Session；Claude Code 当前不支持从 Viewer 重命名 Session。
欢迎通过 Issue 提交问题或建议，通过 Pull Request 参与开发。
v2.3 — 当前版本
- Runtime Task Recording：通过
ccwhat -- claude启动，原生 slash 菜单触发/ccwhat:start//ccwhat:finish - Runtime Dataset V2：任务边界用户显式标定，记录
repo_before/after快照、diff.patch和完整 Agent 行为轨迹 task_trace.json：从 proxy session 日志按任务时间窗口提取 events、commands、errors、final_claim- OpenCode 支持：通过
.opencode/command/注册 task 命令
v2.2
- 双语切换界面（中文/英文），语言选择持久化
- 全局 Session / Task / Turn / Event 搜索，支持三种范围
- 请求回放与对比，支持原文重放和改写后重新发送
- Turn 详情面板重构，四栏折叠式布局
- 零配置自动录制，自动读取 Agent 本地配置
v2.1
- 零配置自动录制（读取 Agent 配置文件提取 API domain）
- OpenAI 格式 SSE 解析，支持 OpenCode 等 Agent
- 任务自动切分与手动校正
- Dataset 导出（manifest.json、dataset.jsonl、traces、scores）
v2.0
- 请求回放功能
- 网络抓包与 Viewer 集成
- Session → Task → Conversation → Turn 层级结构
- 首个稳定版本
完整更新历史见 CHANGELOG.md。