dumpall

The universal context compiler. Everything into one document. Instantly.

Feed files, folders, URLs, or entire GitHub repos to dumpall — get back one clean, structured document ready to paste into any LLM.

npx dumpall src/
npx dumpall github.com/owner/repo
npx dumpall "https://docs.example.com/**"

---

Features

• Multiple sources — local paths, HTTP/S URLs, GitHub/GitLab/Bitbucket repos, URL globs via sitemap
• Output formats — Markdown (default), XML, JSON
• Interactive file picker — fuzzy-search and select files with @
• Clipboard, file, share — -c to copy, -o to write, --share for a public URL, --qr for a scannable QR code
• Token awareness — --tokens to estimate, --max-tokens to trim largest files first
• Directory tree — --tree or --tree-only
• Filtering — --exclude globs, --grep to keep only files containing a pattern
• Repo caching — remote zips cached in ~/.cache/dumpall with configurable TTL
• Prepend a note — -m "fix the auth bug" or bare -m for an interactive prompt

---

Install

# Run without installing
npx dumpall src/

# Or install globally
npm install -g dumpall

---

Usage

dumpall [sources...] [flags]

Sources can be any mix of:

• Local paths: src/, README.md, .
• URLs: https://example.com
• URL globs (sitemap-based): "https://docs.example.com/**"
• Repo slugs: github.com/owner/repo, github.com/owner/repo@main/src/**

---

Flags

Flag	Alias	Description
--clip	-c	Copy output to clipboard
--out <file>	-o	Write output to file
--note [text]	-m	Prepend a message/prompt (omit value for interactive)
--exclude <pattern>	-e	Exclude glob pattern (repeatable)
--grep <pattern>		Only include files containing pattern (repeatable)
--tree		Prepend directory tree to output
--tree-only		Output only the directory tree
--tokens		Show estimated token count
--max-tokens <n>		Truncate output to token budget (drops largest files first)
--max-file-size <size>		Skip files larger than size (default: 1MB)
--format <fmt>		Output format: md (default), xml, json
--share		Upload and print a shareable URL
--qr		Upload and display a scannable QR code
--stdin		Read sources from stdin (one per line)
--follow-symlinks		Follow symlinks during traversal
--strict		Abort on any error instead of skipping
--no-cache		Bypass cache for remote fetching
--cache-ttl <dur>		Cache TTL for branch refs (e.g. 1h, 30m, 0)
--max-pages <n>		Max pages to fetch for URL globs (default: 50)
--install-completions		Install shell completions (bash/zsh/fish)

---

Environment Variables

Variable	Description
DUMPALL_FORMAT	Default output format (md, xml, json)
DUMPALL_MAX_PAGES	Default max pages for URL glob fetching
DUMPALL_CACHE_DIR	Override cache directory (default: ~/.cache/dumpall)
GITHUB_TOKEN	Token for private GitHub repos
GITLAB_TOKEN	Token for private GitLab repos
BITBUCKET_TOKEN	Token for private Bitbucket repos

---

Examples

# Dump src/ to stdout
dumpall src/

# Multiple sources — paths are CWD-relative in output
dumpall src web docs

# Copy to clipboard
dumpall src/ -c

# Write to file with a prepended note
dumpall src/ -o context.md -m "refactor the auth module"

# Interactive note prompt
dumpall src/ -m

# Directory tree only
dumpall . --tree-only

# Exclude patterns
dumpall . -e "*.test.ts" -e "dist"

# Only files containing a pattern
dumpall src/ --grep "TODO"

# Estimate tokens
dumpall src/ --tokens

# Truncate to fit a token budget
dumpall . --max-tokens 50000

# XML or JSON output
dumpall src/ --format xml

# Read from stdin
find . -name "*.ts" | dumpall --stdin

# Fetch a URL
dumpall https://example.com

# Fetch all pages matching a URL glob (via sitemap)
dumpall "https://docs.react.dev/**"

# Fetch a GitHub repo
dumpall github.com/sindresorhus/is

# Fetch a specific branch and subfolder
dumpall github.com/owner/repo@main/src/**

# Interactive fuzzy picker (current directory)
dumpall @

# Picker on a specific source, with other sources alongside
dumpall src/ @ github.com/owner/repo

# Share output as a public URL
dumpall src/ --share

# Share as QR code
dumpall src/ --qr

# Install shell completions
dumpall --install-completions

---

Interactive Picker (@)

Append @ to open a fuzzy file picker. Type to filter, ↑↓ to navigate, Space to select, Enter to confirm.

dumpall @                  # pick from current directory
dumpall src/ @             # pick from src/
dumpall "https://docs.example.com/**" @  # pick from sitemap URLs
dumpall github.com/owner/repo @          # pick from repo files

---

Private Repos

Set the appropriate token environment variable:

GITHUB_TOKEN=ghp_xxx dumpall github.com/owner/private-repo

Or authenticate via the GitHub CLI (gh auth login) — dumpall will use it automatically as a fallback.

---

Sharing

--share uploads your output and prints a URL. --qr shows a scannable QR code of that URL. Small files go to paste.rs (short URL), larger ones fall back to litterbox.catbox.moe (72h expiry, up to 1GB).

---

License

MIT