dump

Think now, organize later.

A CLI that captures your raw thoughts — typed or spoken — and analyzes them with AI when you're ready. No waiting. No formatting. No context switching.

╭──────────────────────────────────────────────────╮
│ ✻ dump                                           │
│                                                   │
│ Capture thoughts instantly. Analyze when ready.   │
│                                                   │
│ model   Anthropic (Claude)                       │
│ storage ~/.dump (12 thoughts)                     │
╰──────────────────────────────────────────────────╯

❯ checkout broken on mobile maybe stripe timeout
  ⎿  ✓ captured
     tip: type /insights when you have a few thoughts

❯ /insights
  ● Analyzing 3 recent thoughts (<$0.01)...

─── Insights ──────────────────────────────────────
  ⎿  ‼ [BUG] Checkout broken on mobile
       → Reproduce on iOS Safari and Android Chrome (quick)
       → Check Stripe webhook delivery failures
       → Blocks: Apple Pay

     [FEATURE] Apple Pay support
       → Stripe supports it natively (quick once checkout works)

     💡 Fix logging first — unblocks debugging everything else.

     1.0k tokens · 3.4s

Why

Developers have dozens of scattered thoughts every day:

• "I think our API is slow because of N+1 queries somewhere"
• "Maybe we should switch to Redis for sessions"
• "The onboarding flow is confusing, users drop off at step 3"

These thoughts get lost in Slack threads, forgotten tabs, or just vanish. dump captures them the moment they happen — type or speak, no friction. When you're ready, ask for insights and get a prioritized action plan.

How it works

1. Type or speak your raw thoughts — instantly saved, no API call
2. Keep going — dump as many thoughts as you want without interruption
3. Ask for insights when ready — /insights analyzes everything and streams back structured insights
4. See patterns over time — /weekly surfaces recurring themes across days of thinking

The key insight: by analyzing multiple thoughts together, dump finds connections you'd miss thinking about them one at a time.

Install

# Install globally
npm install -g dump-ai

# Or run without installing
npx dump-ai

# Set any ONE API key (saved once, used forever)
echo 'ANTHROPIC_API_KEY=sk-ant-...' > ~/.dump/.env

# Or use OpenAI / Google instead
echo 'OPENAI_API_KEY=sk-...' > ~/.dump/.env
echo 'GEMINI_API_KEY=AI...' > ~/.dump/.env

# Run
dump

Requires Node.js 22+ and an API key from any supported provider:

• Anthropic
• OpenAI
• Google

The AI provider is auto-detected from whichever API key you set. No configuration needed.

Voice mode (macOS)

Press Space on an empty input to start recording. Press Space again when done. Your words are transcribed locally on your Mac — no audio leaves your device, no API call, no cost.

Requires sox for mic recording:

brew install sox

Voice is completely optional. If sox isn't installed, dump will guide you when you first press Space.

Commands

Type / to see an interactive suggestion list with arrow key navigation.

Capture and analyze

| Command | What it does | |---|---| | Just type | Instant capture — no waiting, no API call | | Space | Start/stop voice recording (macOS) | | /insights | Analyze today's thoughts with cost estimate | | /insights 5 | Analyze last 5 thoughts | | /insights all | Analyze all stored thoughts | | /focus <topic> | Analyze thoughts about a specific topic | | /standup | Generate a share-ready standup summary | | /weekly | Weekly pattern analysis | | /compare | Compare this week vs last week |

Manage thoughts

| Command | What it does | |---|---| | /search <keyword> | Search thoughts by keyword | | /last | Show your last 5 thoughts | | /history | List all captured thoughts | | /pin <n> | Pin an important thought (survives /clear) | | /unpin <n> | Unpin a thought | | /delete <n> | Delete a thought by number | | /copy | Copy last insight to clipboard | | /export json | Export thoughts as JSON | | /export md | Export thoughts as Markdown | | /clear | Clear all thoughts (keeps pinned) |

Navigation

| Shortcut | What it does | |---|---| | ↑ ↓ | Browse input history or navigate suggestions | | Enter | Select suggestion and execute | | Tab | Fill suggestion into input | | Esc | Dismiss suggestions or exit | | /help | Show available commands | | /quit | Exit |

Features

• Contextual tips — dump teaches you features as you use it, showing relevant tips after captures
• Rotating placeholders — the input hints cycle through features you haven't discovered yet
• Cost estimation — see estimated cost before every AI analysis
• Thought deduplication — similar thoughts are grouped before analysis to save tokens
• Project detection — auto-detects your project from git and adds context to AI analysis
• Insight memory — past analysis results are fed to AI so it builds on previous insights, not repeats
• Input history — up/down arrows browse your session history
• Update notifications — shows a banner when a new version is available

Privacy

All thoughts are stored locally on your machine at ~/.dump/. Nothing leaves your device until you explicitly run /insights or /weekly. Voice transcription happens entirely on your Mac — no audio is sent anywhere.