@agent-dump/cli

Native agent-dump binaries for bunx and npx.

The package downloads the matching native binary for the current platform during installation and verifies it against the published checksum manifest before exposing agent-dump.

The download is bounded: each request has a 30s idle timeout and a 5 minute total deadline (shared across redirects), the response is capped by size, and the tarball is decompressed under an output limit. A stalled or oversized response fails the attempt and falls through to the existing retries instead of hanging the install.

bunx @agent-dump/cli --help
npx @agent-dump/cli --help

Requires Node.js 22 or newer. Node 18 and 20 are end-of-life upstream and are not tested.

Supported targets:

• darwin-x64
• darwin-arm64
• linux-x64
• win32-x64

Installation

# Via bunx (no installation)
bunx @agent-dump/cli --help

# Via npx (no installation)
npx @agent-dump/cli --help

# Global install
npm install -g @agent-dump/cli
agent-dump --help

Usage

Interactive export

agent-dump --interactive
agent-dump --interactive -days 3

List sessions

agent-dump --list
agent-dump --list -days 7
agent-dump --list -query error

URI direct dump

agent-dump opencode://<session-id>
agent-dump zcode://<session-id>
agent-dump codex://<session-id>
agent-dump codex://threads/<session-id>
agent-dump kimi://<session-id>
agent-dump claude://<session-id>
agent-dump cursor://<request-id>
agent-dump pi://<session-id>
agent-dump codex://<session-id> --head

Statistics

agent-dump --stats
agent-dump --stats -days 30

Provider capabilities

agent-dump --providers
agent-dump --capabilities

Search

agent-dump --search "auth timeout"
agent-dump --search "auth" --list -days 30
agent-dump --reindex

Collect (AI summary by date range)

agent-dump --collect
agent-dump --collect -days 7
agent-dump --collect -since 2026-04-01 -until 2026-04-15
agent-dump --collect --collect-mode insight
agent-dump --collect --dry-run --save ./reports
agent-dump --collect --save ./reports

Config

agent-dump --config view
agent-dump --config edit

Supported URI schemes

• opencode://<session_id> - OpenCode sessions
• zcode://<session_id> - ZCode sessions
• codex://<session_id> - Codex sessions
• codex://threads/<session_id> - Codex sessions
• kimi://<session_id> - Kimi sessions
• claude://<session_id> - Claude Code sessions
• cursor://<requestid> - Cursor sessions
• pi://<session_id> - Pi sessions

Key features

• Multi-agent support: Scan and export sessions from OpenCode, ZCode, Claude Code, Codex, Kimi, Cursor, and Pi
• Interactive selection: Friendly CLI selector with time-based grouping
• URI direct access: View or export any session by its URI without searching
• Head metadata: --head reuses bounded discovery metadata without rereading the transcript and marks incomplete message counts as unknown
• Statistics: --stats shows session and message counts grouped by agent and time, reporting known subtotals separately from sessions with unknown counts
• Provider capabilities: --providers reports URI schemes, export formats, keyword fast paths, and local search-root status without scanning sessions
• AI collect: --collect summarizes sessions over a date range using your configured LLM, with pm and insight modes
• Relative collect windows: Explicit -days N selects today minus N days through today; -since/-until takes precedence, while collect without either remains today-only
• Collect dry-run: --collect --dry-run previews provider breakdown, session/chunk counts, concurrency, and save path
• Full-text search: --search requires every distinct whitespace-delimited term, allows terms to match across corpus fields, keeps CJK matches contiguous, and gives FTS5 and in-process fallbacks the same literal semantics
• Structured queries: -query treats its keyword as one normalized literal phrase and supports provider:, role:, path:, and limit: filters (role: snippets come only from allowed messages)
• Scoped queries: agents://<path>?q=keyword&providers=codex,claude for repo-scoped searches
• Multi-format export: --format json,markdown,raw,print with md alias for markdown
• Localized CLI: --lang en|zh for user-facing messages and diagnostics
• Predictable exit codes: 0 success (including legitimately empty results), 1 could not complete the request, 2 usage error
• Config-driven: ~/.config/agent-dump/config.toml for AI provider, shortcuts, and agent deny-lists

Documentation

Full documentation and Python source: xingkaixin/agent-dump. Changelog: CHANGELOG.md.