AgentGraphed：本地优先的 AI 编码会话分析仪表盘
每天用 Claude Code 和 Codex CLI 写大量代码，但一周后想找回上周写过的某个功能时，只能在终端翻历史记录？想看看这个月花了多少 API 费用、哪个项目消耗的 Token 最多，却没有一个直观的仪表盘？AgentGraphed 就是为解决这个问题而生的。
问题：AI 编码会话的”黑箱”
Claude Code 和 Codex CLI 会把每次对话记录到本地 JSONL 文件（~/.claude/projects/ 和 ~/.codex/sessions/），但默认情况下：
- 不可搜索——只能用 grep 勉强翻日志
- 无聚合视图——看不到按项目、按模型的使用量统计
- 无法恢复——一个终止的终端会话，关联的对话记录就沉了
- 无成本追踪——花了多少钱全靠估算
AgentGraphed 把这些本地的日志文件自动索引，变成一个实时更新的 Web 仪表盘，所有数据不出你的机器。
安装：一行命令
npx agentgraphed
不需要克隆仓库、不需要注册账号、不需要配置文件。第一次运行会下载 ~15MB 的 npm 包（约 30-60 秒），之后启动只需几秒。
如果想全局安装：
npm install -g agentgraphed agentgraphed
前提是机器上有 Node.js 20+（LTS 版本即可）。
首次启动
第一次运行后，你会看到类似这样的输出：
› Starting AgentGraphed on http://localhost:3737 › Scanning local AI coding sessions… Found 142 Claude + 8 Codex sessions (14821 messages indexed in 1943ms) › Ready. Press Ctrl+C to stop.
浏览器自动打开 http://localhost:3737，所有历史会话就以时间线形式呈现在你面前。
核心功能一览
1. 时间线（Timeline）
每次会话按日期分组排列，并标注时长标签：STARTED（新建）、CONTINUED（继续）、CLOSED（关闭）。跨多天的工作不会被淹没在某个单日条目中。
2. 会话搜索（Sessions）
可按内容关键词、项目、提供商（Anthropic / OpenAI）、模型名称搜索过去的对话。点击任意会话即可看到完整的 Chat Bubble 视图，就像在 Claude Code 终端里看对话一样。
3. 恢复会话（Resume）
发现一个上周做到一半但被搁置的功能？点击 Resume 按钮，一键复制恢复命令到剪贴板：
cd /path/to/project && claude --resume
重新进入当时的上下文，继续工作。再也不用在终端历史里翻几十页找那个 session ID 了。
4. 项目视图（Projects）
AgentGraphed 自动从 Git 仓库根目录检测项目归属，每个项目独立统计：
- 会话数量和总时长
- 使用的模型分布
- 估算的 API 成本
这对同时维护多个项目的开发者尤其有用——一眼就能看出哪个项目消耗了最多的计算资源。
5. 自动分类（Auto-Classification）
这是一个可选功能，需要你自己提供 LLM API 密钥。AgentGraphed 会自动将每次会话归类为：Feature（功能开发）、Debugging（调试）、Planning（规划）、Refactor（重构）、Styling（样式）、DevOps、Data、Docs、Content 等类别，并为每个会话生成一个干净的过去式标题。
数百条会话的分类成本通常只需几美分。
6. 实时配额监控（Live Quota Probe）
侧边栏小部件可以实时读取你的 Anthropic（5 小时 / 7 天）和 OpenAI（每分钟）速率限制使用情况。鼠标悬停即可查看剩余配额百分比，避免在关键时刻被限流。
数据隐私
AgentGraphed 所有数据存储在 ~/.agentgraphed/agentgraphed.sqlite，完全是本地 SQLite 数据库。只有当你主动点击”Copy Context”或”Classify Sessions”时，数据才会发送到你自己的 LLM API 提供商（使用你自己的 API 密钥）。
API 密钥以明文形式存储在 SQLite 中（与 ~/.aws/credentials 或 .env 文件的安全模型相同）。
实用技巧
技巧 1：保持运行，自动扫描更新
启动后让 AgentGraphed 在后台保持运行，它每 5 分钟自动重新扫描一次新的会话数据。这样你随时打开浏览器都能看到最新的统计。
技巧 2：利用 Git 项目隔离
在多个 Git 仓库中使用 AI 编码工具时，AgentGraphed 会自动按项目分组。如果你希望更精确的成本归属，可以在不同仓库中分别启动 Claude Code / Codex。
技巧 3：为 Resume 功能建立习惯
每天结束工作时，可以顺手记录一下今天最想恢复的会话 ID。但更省心的做法是：关掉终端前，让 AgentGraphed 在后台运行，第二天打开浏览器直接点 Resume 即可。
配置选项
AgentGraphed 支持通过环境变量自定义：
| 变量 | 默认值 | 作用 |
|---|---|---|
AGENTGRAPHED_PORT | 3737 | 端口号（被占用时自动递增） |
AGENTGRAPHED_DATA_DIR | ~/.agentgraphed | SQLite 数据库存放目录 |
AGENTGRAPHED_CLAUDE_DIR | ~/.claude/projects | Claude Code 日志路径 |
AGENTGRAPHED_CODEX_DIR | ~/.codex/sessions | Codex 日志路径 |
日志目录也可以在运行时的 Settings → Data sources 界面中修改，无需重启。
横向对比
| 特性 | AgentGraphed | 手动 grep 日志 | Claude Code 自带统计 |
|---|---|---|---|
| Web 仪表盘 | ✅ | ❌ | ❌ |
| 跨会话搜索 | ✅ | 勉强可行 | ❌ |
| 一键恢复 | ✅ | ❌ | ❌ |
| 按项目分组 | ✅ | ❌ | ❌ |
| 成本估算 | ✅ | ❌ | ❌ |
| 数据完全本地 | ✅ | ✅ | ✅ |
| 自动分类 | ✅ (可选的) | ❌ | ❌ |
| 安装复杂度 | 一行命令 | 零学习成本 | 零学习成本 |
| 支持的 Agent | Claude Code + Codex | 通用 | 仅 Claude Code |
总结
AgentGraphed 不是什么”AI 编码革命性工具”，它解决的是一个朴实但真实的痛点：当你每天用 AI 写出大量代码后，如何管理、检索和分析这些编码会话的历史。24 小时的 GitHub Stars 数量虽然不高，但它的 README 文档完整、安装路径极简（只需一行 npx agentgraphed），核心功能直击痛点。
对于每天大量使用 Claude Code 和 Codex CLI 的开发者来说，AgentGraphed 是一个值得常驻后台的工具——它不生产代码，但帮你更好地理解自己的 AI 编码行为。如果 GitHub Stars 还不足以说服你，不妨直接 npx agentgraphed 体验一下，反正一行命令，零成本。