agent-dump

v1.2.5本地 AI 会话 CLI · 源数据只读

写过的对话,
继续派上用场。

Codex、Claude Code、Cursor 等 19 款工具的本地会话,用一套 URI 查找、阅读、导出,并交给下一个 Agent 继续工作。免费、开源,不改动任何源数据。

免安装运行npx @agent-dump/cli --help

01支持工具

19 款工具,
一套 URI 语法

通过会话 URI 读取本机保存的历史。可用格式和内容范围取决于来源工具。

Session URIagent-dump export <uri>

  • Codexcodex://threads/a1b2c3
  • Claude Codeclaude://a1b2c3d4
  • Qoderqoder://6f1e2d3c
  • Qoder CNqoder-cn://9a8b7c6d
  • ZCodezcode://sess-9f8e7d
  • Kimikimi://k-7a3f21
  • Kimi-Codekimi-code://kc-4e9d12
  • OpenCodeopencode://5c4b3a
  • Cursorcursor://req-8821
  • Droiddroid://5f3e2a1b-9c4d
  • Grokgrok://019b2c4f-7e1a
  • Pipi://019e7978-b2ec
  • oh-my-piomp://019a0000-7000
  • Gemini CLIgemini-cli://3f9a2c41
  • DSHdsh://d5f0a2c1
  • DeepChatdeepchat://session-123
  • Cherry Studiocherry://topic-123
  • MiniMax Codeminimax://session-123
  • Antigravity CLIantigravity-cli://agy-5d21f0

02它能做什么

四个动作,覆盖一段对话的后半生。

找回当时的决策,读懂完整讨论,带着来源导出,再完整地交给下一次工作。下面的输出为示例会话。

$agent-dump search 'auth timeout' --query 'path:.' --days 30
auth timeouts
path:.近 30 天Provider: 全部角色: 全部
claude修复登录超时重试2 hits · 3d

› msg 14 “auth timeout 在 30s 后触发重试,需要…”

claude://7f3c91#msg-14

codex网关超时配置梳理4 hits · 6d

› msg 3 “提高 auth timeout 之前先确认上游…”

codex://019a7c2e#msg-3

cursor会话刷新逻辑1 hit · 12d

搜索标题、消息、推理与工具状态 · 按 Provider / 路径 / 角色筛选

03agent-dump --browse

终端里的会话阅读器。

左边是会话,右边是正文。搜索会话、在会话内查找、预览命中摘录、标记后批量导出,都不离开终端。下面的演示可以操作:点进终端用键盘,或点下方按键。

>_agent-dump --browse --time-field updated --days 7自动演示中 · 点击终端接管

会话6

›○网关超时配置梳理codex · 2 小时前
○修复登录超时重试claude · 1 天前
○会话刷新逻辑cursor · 3 天前
○数据库迁移方案opencode · 4 天前
○周报素材整理kimi · 5 天前
○搜索索引增量更新pi · 6 天前

正文 · 1/6~/work/gateway

codex://019a7c2e · 网关超时配置梳理

user上游偶发 504,auth timeout 要不要从 30s 提到 60s?
assistant先别改。日志显示超时集中在 token 刷新那一步,重试时 refresh token 已经过期。
user那先修刷新顺序?
assistant对。重试前先刷新 token,再给 auth timeout 的边界补测试。
user好,记一下:60s 方案暂缓。
assistant已记录。待办:刷新顺序修复、auth timeout 边界测试、观察一周 504 比例。
s 搜索会话;/ 查找当前会话。来源: 全部 · 最近 7 天(更新) 目录: 全部 · 角色: 全部 · 上限: 全部

示例会话 · 界面布局、按键和提示文案与 CLI 一致点击终端后可直接用键盘:↑ ↓ ← → 空格 e s / n x t c ?

04人与 Agent

人用终端读,Agent 用 JSON 读。

给开发者

三条命令找回上周的工作

浏览最近活跃的会话,在当前项目里搜索,再用 URI 导出。

  1. 01浏览最近一周

    agent-dump --browse --time-field updated --days 7

  2. 02在当前项目里搜索

    agent-dump search 'auth timeout' --query 'path:.' --days 30

  3. 03按 URI 导出

    agent-dump export codex://SESSION_ID --format markdown --output ./sessions

给 AI Agent

可验证的完整读取

检查退出码和 status;部分结果不会被当成完整读取。

  1. 01
    providers --json能力与路径
  2. 02
    list --days 7 --json候选会话
  3. 03
    read-prompt <uri>分页指令
  4. 04
    follow cursor until has_more=false

05数据边界

只读你的会话,不碰你的数据。

源数据零写入

导出、搜索、统计和 collect 都不会修改数据库、JSONL 或会话目录。

产物写在自己的地方

索引、配置、日志和导出文件只进入 agent-dump 拥有的路径。

不完整就说不完整

读取或摘要失败会被明确标记;未知的事实保持未知。

06使用说明

让历史对话,继续有用。

从找回一次讨论,到导出记录、交接上下文和整理周报。每篇指南都从具体场景出发,提供可以照着操作的命令。

全部指南

07Install

安装

curl、Homebrew 和 Scoop 安装无需 Python 或 Node.js。也可继续使用 uv 或 JavaScript 包;JavaScript 包装器需要 Node.js 22+。

macOS Intel / Apple SiliconLinux x64Windows x64
原生安装
全局安装
免安装运行
curl -sSfL https://github.com/xingkaixin/agent-dump/releases/latest/download/install.sh | sh

macOS Intel / Apple Silicon · Linux x64(glibc 2.17+)。安装到 ~/.local/bin,再次运行即可更新。

或作为 agent skill 添加npx skills add xingkaixin/agent-dump

08Changelog

最新动态

会话读取、搜索、导出与 collect 的版本更新。

在 GitHub 查看完整更新日志

最新版本 ·

v1.2.5

新增 9 款 AI 编程工具的会话读取

除 Codex、Claude Code、Cursor 等工具外,现在还可以导出、搜索和汇总 Gemini CLI、Grok、Droid、Qoder、Qoder CN、Kimi-Code、oh-my-pi、Antigravity CLI 和 DSH 的 AI 会话。Claude Code 子代理、Codex 归档会话、Cursor 子代理对话和 Pi 当前分支的读取更完整;列出近期会话时跳过过期文件,结果返回更快。

新增工具会话导出更快列出
$ npx @agent-dump/cli@1.2.5 providers

v1.2.4

AI collect 支持更多模型配置

汇总 Codex、Claude Code、Cursor 等工具的 AI 会话时,可配置推理模式和厂商专用请求参数。AI collect 会调整 OpenAI 兼容服务拒绝的默认参数,并正确读取 Anthropic 思考块之后的文本回复。新版网站让你浏览功能与使用指南。

AI collect推理配置模型兼容

v1.2.3

会话搜索与导出更可靠

按更新时间查找最近活跃的 AI 会话,完整读取 Kimi 文本,正确呈现 Codex 计划确认与 token 总量。全文搜索修复 Unicode 和工具状态匹配;导出与 AI collect 保护所有受支持的会话数据源,并将被截断的 AI 报告明确报告为失败。

会话导出全文搜索数据保护
更早版本13 · v0.15.0 – v1.2.2
  1. v1.2.2大型会话切换减少等待
  2. v1.2.1搜索与批量导出减少等待
  3. v1.2.0在终端完成搜索、阅读与批量导出
  4. v1.1.1查找最近活跃会话,保留来源复用对话
  5. v1.1.0终端浏览会话,定位搜索结果的上下文
  6. v1.0.0原生 Rust CLI:会话工作流迈入 v1.0.0
  7. v0.15.9导出与搜索 OpenCode 2.x 会话
  8. v0.15.8导出与搜索 MiniMax Code 会话
  9. v0.15.7导出与搜索 DeepChat、Cherry Studio 会话
  10. v0.15.6会话收集更可靠,读取与搜索及时更新
  11. v0.15.5会话收集容错保留、Provider 预剪裁与全新落地页视效
  12. v0.15.4外部 Agent 提示词交接与纯净对话提取
  13. v0.15.0本地全文搜索与跨 Provider 统一检索

09FAQ

常见问题

Agent Dump 是面向个人开发者与 AI Agent 的本地会话工具。可查找历史工作、浏览或分页读取对话、导出带来源的上下文,以及汇总符合规则的 user/assistant 正文。读取已保存的会话,不修改源数据。