agent-dump
EN中文日本語
Install

v1.2.7Local AI session CLI

Your sessions.
Still useful.

Find, read, and export local sessions from Codex, Claude Code, Cursor, and 16 more tools with one URI syntax, then hand them to the next Agent. Free, open source, and it never modifies source data.

InstallGuides

Run without installingnpx @agent-dump/cli --help

19 tools,
one URI grammar

Export a Codex session to MarkdownMore tools · PRs welcome
  • 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

Four moves for everything after the chat ends.

$agent-dump search 'auth timeout' --query 'path:.' --days 30
auth timeouts
path:.last 30 daysProvider: allRole: all
claudeFix login timeout retry2 hits · 3d

› msg 14 “auth timeout retries after 30s, so we need…”

claude://7f3c91#msg-14

codexGateway timeout config review4 hits · 6d

› msg 3 “Before raising auth timeout, confirm upstream…”

codex://019a7c2e#msg-3

cursorSession refresh logic1 hit · 12d

A session reader in your terminal.

>_agent-dump --browse --time-field updated --days 7Auto demo · click the terminal to take over

Sessions6

›○Gateway timeout config reviewcodex · 2h ago
○Fix login timeout retryclaude · 1d ago
○Session refresh logiccursor · 3d ago
○Database migration planopencode · 4d ago
○Weekly report noteskimi · 5d ago
○Incremental search indexpi · 6d ago

Transcript · 1/6~/work/gateway

codex://019a7c2e · Gateway timeout config review

userUpstream returns an occasional 504. Should auth timeout go from 30s to 60s?
assistantNot yet. The logs show timeouts during token refresh; the refresh token has expired by the time we retry.
userSo fix the refresh order first?
assistantYes. Refresh the token before retrying, then add tests for the auth timeout boundary.
userOK. Note that the 60s change is on hold.
assistantNoted. Todo: fix refresh order, test the auth timeout boundary, watch the 504 rate for a week.
s searches sessions; / finds text in this session.Provider: all · updated: last 7 days Path: all · Role: all · Limit: all

People read in the terminal. Agents read JSON.

Three commands for last week's work

  1. 01browse the last week

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

  2. 02search this project

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

  3. 03export by URI

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

Reading you can verify

Check exit codes and status; a partial result never passes as a complete read.

  1. 01
    providers --jsoncapabilities & paths
  2. 02
    list --days 7 --jsoncandidate sessions
  3. 03
    read-prompt <uri>paging instructions
  4. 04
    follow cursor until has_more=false

Reads your sessions. Never touches your data.

Incomplete says incomplete

Failed reads or summaries are marked; unknown facts stay unknown.

Guides

All guides
Export & archive

Export a Codex session to Markdown

Export a Codex session to Markdown or JSON with Agent Dump. Find local conversations, copy the transcript into notes, and troubleshoot missing sessions.

Export & archive

Export Claude Code conversations to Markdown and JSON

Save a local Claude Code conversation as Markdown or JSON. Find the session URI, export a readable record, and troubleshoot missing project history.

Search & read

Search AI coding history and find past decisions

Find a past fix or decision across Codex, Claude Code, and other local AI tools. Filter by project, locate matching messages, and read the surrounding context.

Agent handoff

Give an AI agent context from a previous session

Continue work with context from a previous Codex or Claude Code conversation. Generate reading instructions or use bounded JSON pages with continuation cursors.

Work reports

Create a work report from AI coding sessions

Turn saved AI coding conversations into a daily or weekly work report. Preview the session scope, use AI collect or a prompt handoff, and check coverage.

Export & archive

Save AI conversations to an Obsidian vault

Keep Codex and Claude Code conversations as Markdown notes in Obsidian. Export to a dedicated vault folder, preserve useful context, and understand archive limits.

Install

Install with curl, Homebrew, or Scoop without Python or Node.js. uv and JavaScript packages remain available; JavaScript wrappers require Node.js 22+.

macOS Intel / Apple SiliconLinux x64Windows x64
Native installation
Install globally
Run without installing
curl -sSfL https://github.com/xingkaixin/agent-dump/releases/latest/download/install.sh | sh

macOS Intel / Apple Silicon · Linux x64 (glibc 2.17+). Installs to ~/.local/bin; run again to update.

Or add it as an agent skillnpx skills add xingkaixin/agent-dump

What's New

View full changelog on GitHub

Latest ·

v1.2.7

Faster AI Collect and Full-Text Search

AI collect sends independent LLM requests concurrently, so summarizing long Codex, Claude Code, Cursor, and other AI sessions no longer leaves workers idle. Full-text search reads session bodies in parallel to locate matches faster. The website loads lighter fonts, and the docs now match the CLI contract.

AI CollectFull-Text SearchPerformance
$ npx @agent-dump/cli@1.2.7 --collect --days 7

v1.2.6

Safer HTTPS Connections for AI Collect

AI collect summarizes Codex, Claude Code, Cursor, and other supported AI sessions over HTTPS with an updated certificate trust list. After eMudhra intermediate CA keys leaked, it no longer trusts the emSign ECC Root CA - G3. Session export, full-text search, and prompt handoff work as before and are now covered by stricter CLI contract tests.

AI CollectHTTPS SecurityCertificate Trust

v1.2.5

Read Sessions from 9 More AI Coding Tools

Export, search, and summarize AI sessions from Gemini CLI, Grok, Droid, Qoder, Qoder CN, Kimi-Code, oh-my-pi, Antigravity CLI, and DSH alongside Codex, Claude Code, Cursor, and other supported tools. Claude Code subagents, archived Codex rollouts, Cursor subagent chats, and the active Pi branch are read more completely, and recent-session lists skip stale files to return faster.

New ProvidersSession ExportFaster Listing
Earlier releases15 · v0.15.0 – v1.2.4
  1. v1.2.4More Flexible AI Collect
  2. v1.2.3More Reliable Session Search and Export
  3. v1.2.2Switch Large Sessions with Less Waiting
  4. v1.2.1Faster Session Search and Batch Export
  5. v1.2.0Search, Read, and Export Without Leaving the Terminal
  6. v1.1.1Find Recent Work and Reuse Conversations with Sources
  7. v1.1.0Browse Sessions and Read Search Results in Context
  8. v1.0.0Native Rust CLI for AI Session Workflows
  9. v0.15.9Export and Search OpenCode 2.x Sessions
  10. v0.15.8Export and Search MiniMax Code Sessions
  11. v0.15.7Export and Search DeepChat and Cherry Studio Sessions
  12. v0.15.6More Reliable Collect and Up-to-Date Session Reads
  13. v0.15.5Resilient Collect, Provider Pre-Scoping & Visual Redesign
  14. v0.15.4External Agent Handoff & Visible Dialogue Summaries
  15. v0.15.0Full-Text Search & Unified Relevance Ranking

FAQ

Agent Dump is a local session tool for individual developers and AI Agents. Use it to find previous work, browse or page through conversations, export context with sources, and summarize eligible user/assistant text. It reads saved sessions without modifying their source data.