dump

Think now, organize later.

A CLI for solo developers who think in fragments. Capture raw thoughts instantly, review them when enough signal exists, and leave with a concrete next-actions.md you can actually work from.

╭────────────────────────────────────────────────────────╮
│ ✻ dump                                                 │
│                                                        │
│ Capture thoughts. Review them. Act on what matters.    │
│                                                        │
│ model   Anthropic · Claude Sonnet 4.6                  │
│ storage ~/.dump (12 thoughts)                          │
│ pending 5 reviews                                      │
╰────────────────────────────────────────────────────────╯

❯ checkout broken on mobile maybe stripe timeout
  ⎿  ✓ captured

❯ logging is terrible cant debug anything
  ⎿  ✓ captured

❯ /review
  ● Reviewing 5 thoughts (<$0.01)...

─── Review ──────────────────────────────────────────────
  ⎿  What matters now:
     - Fix logging before debugging checkout.

     Next actions:
     1. Add request context to error logs.
     2. Reproduce checkout failure on mobile Safari.
     3. Check Stripe webhook delivery failures.

     Later:
     - Revisit Apple Pay once checkout is stable.

     Watchouts:
     - Debugging will stay slow until logging improves.

  ✓ Saved next actions.
    → /repo/.dump/next-actions.md
    Next: /actions · /copy

Why

Developers collect dozens of half-formed thoughts while coding:

• "checkout is probably timing out on mobile"
• "logging is too weak to debug this"
• "maybe we should add Apple Pay after the flow is stable"

Those thoughts usually disappear into Slack, notes apps, or memory. dump is built for a tighter loop:

1. capture without breaking flow
2. review when there is enough signal
3. leave with current next actions, not just a summary

Core Flow

1. Capture

Type directly inside dump, or capture one thought without opening the UI:

dump add "checkout broken on mobile maybe stripe timeout"

You can also pipe text in:

echo "logging is terrible cant debug anything" | dump add

2. Review

When you have 3-5 unreviewed thoughts, run:

dump review

Or inside the interactive UI:

/review

/insights still works as an alias, but /review is now the primary command.

3. Act

After every review, dump writes the current action list to:

• <repo-root>/.dump/next-actions.md when you're inside a git repo
• ~/.dump/next-actions.md when you're not

Open it anytime with:

dump actions

Or inside the UI:

/actions

Install

npm install -g dump-ai

Or run without installing:

npx dump-ai

Set any one API key in ~/.dump/.env:

echo 'ANTHROPIC_API_KEY=sk-ant-...' > ~/.dump/.env
# or
echo 'OPENAI_API_KEY=sk-...' > ~/.dump/.env
# or
echo 'GEMINI_API_KEY=AI...' > ~/.dump/.env

Requires Node.js 22+.

Supported providers:

• Anthropic
• OpenAI
• Google

Voice Mode (macOS)

Press Space on an empty input to start recording. Press Space again to stop. Audio is transcribed locally on your Mac.

Requires sox:

brew install sox

Voice is optional. If sox is missing, dump will tell you the first time you try it.

Commands

Type / to open the interactive command suggestions.

Primary

| Command | What it does | |---|---| | dump add "..." | Capture one thought without opening the UI | | Just type | Capture a thought instantly in the interactive UI | | Space | Start/stop voice capture on macOS | | /review | Turn pending thoughts into current next actions | | /actions | Preview the saved next-actions.md file | | /insights | Alias for /review | | /copy | Copy the last review or insight |

Secondary

| Command | What it does | |---|---| | /weekly | Weekly pattern analysis | | /standup | Generate a standup summary | | /focus <topic> | Review one topic deeply | | /compare | Compare this week vs last week | | /search <keyword> | Search thoughts by keyword | | /last | Show your last 5 thoughts | | /history | List captured thoughts | | /pin <n> | Pin a thought so it survives /clear | | /unpin <n> | Unpin a thought | | /delete <n> | Delete a thought by number | | /export json | Export thoughts as JSON | | /export md | Export thoughts as Markdown | | /clear | Clear all unpinned thoughts | | /help | Show help | | /quit | Exit |

Features

• Capture without friction — raw thoughts are saved instantly, no AI call required
• Review when it matters — dump nudges you at 3 and 5 unreviewed thoughts, but never auto-runs AI
• Concrete action artifact — every review writes a durable next-actions.md
• Repo-aware output — inside git repos, the action file lives next to the code
• Insight memory — past review summaries and next actions are fed back into later analysis
• Thought deduplication — similar thoughts are grouped before review to save tokens
• Project detection — repo context is used to keep actions grounded
• Input history — use arrow keys to revisit recent commands or thoughts
• Update notifications — a banner appears when a newer version is available

Privacy

Thoughts are stored locally in ~/.dump/. Nothing leaves your device until you explicitly run /review, /weekly, /standup, or another AI command. Voice transcription stays on your Mac.