dropcrumb_

~/docs

CLI reference for dropcrumb v0.3.2

# Install

$ npm install -g dropcrumb

Requires Node.js 18+. Once installed, the dropcrumb command is available globally.

# Login

Authenticate with your Dropcrumb account. Opens a browser window for sign-in, then saves the token locally.

$ dropcrumb login
Opening browser to sign in...
✓ Authenticated. Token saved.

Token is saved to ~/.dropcrumb/config.json. Falls back to manual token paste if the browser flow times out.

# Push

Upload a coding agent conversation and get a shareable URL. Auto-detects conversations for the current project directory.

$ dropcrumb push
$ dropcrumb push -n "Fix auth middleware"
$ dropcrumb push claude
$ dropcrumb push --latest
$ dropcrumb push --dry-run

Arguments

[agent]
Filter sessions by agent: claude, codex, gemini

Options

-n, --name <name>
Name for the conversation. Used in the URL slug. Prompted interactively if not provided.
--latest
Push the most recent session without prompting for selection.
--session <id>
Push a specific session by its ID.
--strip-thinking
Remove thinking/reasoning blocks before upload.
--dry-run
Show what would be sanitized without uploading. Does not require authentication.
--no-sanitize
Skip path and secret sanitization.

In-session mode

When run from inside a coding agent session (e.g., Claude Code), dropcrumb push auto-detects the current conversation and uploads it directly — no session selection needed.

# List

List all conversations for the current project directory across all installed coding agents.

$ dropcrumb list
$ dropcrumb list claude
$ dropcrumb list gemini
[agent]
Filter by agent: claude, codex, gemini

# Checkout

Download a shared conversation and place it in the coding agent's local history folder. After checkout, the conversation appears in your agent's session list.

$ dropcrumb checkout pedros-org/my-project/fix-auth
Downloading conversation fix-auth...
✓ Placed in Claude Code history
~/.claude/projects/-my-project/abc123.jsonl
-o, --output <path>
Save to a specific file instead of the agent's history folder.

# Configuration

Configuration is stored at ~/.dropcrumb/config.json:

{
"token": "dc_...",
"apiUrl": "https://dropcrumb.dev"
}

Global option

--api <url>
Override the API URL for a single command. Useful for local development: dropcrumb --api http://localhost:3000 push

# Sanitization

Before uploading, the CLI automatically sanitizes your conversation to remove sensitive data. This happens client-side — secrets never leave your machine.

Path sanitization

Absolute paths are replaced with relative ones. The project path becomes just the project name (e.g., /Users/you/Projects/myapp → myapp). Remaining home directory paths are replaced with ~.

Secret redaction

Known secret patterns are automatically redacted:

- Anthropic API keys (sk-ant-*)
- OpenAI API keys (sk-*)
- GitHub tokens (ghp_*, gho_*, github_pat_*)
- AWS access keys (AKIA*)
- Vercel, Clerk, Stripe tokens
- Bearer tokens
- Environment variable assignments (*_KEY=, *_SECRET=, *_TOKEN=)

Use --dry-run to preview what would be redacted without uploading. Use --no-sanitize to skip sanitization entirely.

# Supported Agents

Claude Code~/.claude/projects/
Codex~/.codex/sessions/
Gemini~/.gemini/tmp/
dropcrumb_ v0.3.2