dump

dump is a standalone Go CLI that exports local AI agent conversations into Markdown files.

Features

• Exports from local logs for:
  • codex
  • claude
  • gemini
  • opencode
• Supports one or many agents per run.
• Writes one Markdown file per conversation.
• Filters by recency (--since) and per-agent limit (--limit).
• Tolerant parsing for unattended automation runs.

Build

go build -o ./bin/dump ./cmd/dump

CLI Usage

dump --agent <name> [--agent <name> ...] --out <dir> [--since <duration>] [--limit <n>] [--verbose]

Examples:

./bin/dump --agent claude --out "$HOME/Downloads/Dump"
./bin/dump --agent codex --agent gemini --out "$HOME/Downloads/Dump" --since 24h --limit 10
./bin/dump --agent codex --agent claude --agent gemini --agent opencode --out "$HOME/Downloads/Dump"

Justfile Commands

just fmt
just test
just build
just run --agent claude --out ./out
just export-claude out="$HOME/Downloads/Dump"
just export-all out="$HOME/Downloads/Dump"

Output Layout

Exports are written under:

<out>/<agent>/*.md

Each Markdown file includes metadata (agent, conversation ID, model, timestamps, source path) and normalized messages.

Exit Codes

• 0: success (including no matching conversations)
• 1: invalid arguments
• 2: runtime/export error