Copy a bunch of files into your clipboard to provide context for LLMs
- 🔍 Search for files with specific extensions or all files
- 📋 Automatically copy file contents to clipboard
- 🚫 Skip specified directories
- 📝 Respects .gitignore rules by default
- 🚀 Fast! Can copy 1.6 million tokens in ~0.8 seconds
dump_dir <file_extension> <directory1> [directory2] ... [-s <skip_directory1>] [-s <skip_directory2>] ...
Use 'any' as file_extension to match all files.
Get all JS files, ignoring your node_modules and dist directories:
dump_dir js ./project -s ./project/node_modules -s ./project/dist
Get all files in your project directory of all types
dump_dir any ./project
Get all Go, JavaScript, and Python files in your project:
dump_dir go,js,py ./project
Get all files, including those normally ignored (e.g., files in .gitignore):
dump_dir any ./project --include-ignored
This repo:
dump_dir any .
Skipping ignored directory: .git
Skipping ignored directory: .idea
Skipping ignored directory: gitignore
🔍 Matching files:
- dump_dir
- src/colors.go
- README.md
- .gitignore
- main.go
- go.mod
- src/ignore.go
- src/file_processing.go
- src/output.go
- go.sum
- .goreleaser.yaml
- src/types.go
- src/args.go
- .github/workflows/release.yml
📚 Total files found: 14
📝 Total lines across all files: 710
✅ File contents have been copied to clipboard.
By default, dump_dir respects your project's .gitignore rules. This means:
Files and directories listed in your project's .gitignore will not be included in the output. The tool also respects your global gitignore file. Common version control directories (like .git) are automatically ignored.
To include ignored files, use the --include-ignored
flag as shown in the examples above.
Mac and Linux
You can easily install the latest version of dump_dir using curl. Run the following command in your terminal:
curl -sfL https://raw.githubusercontent.com/fargusplumdoodle/dump_dir/main/install.sh | sh
This script will:
- Detect your operating system and architecture
- Download the latest release of dump_dir
- Install it to /usr/local/bin (you may need to use sudo for this)
Alternatively, you can manually download the latest release from the GitHub Releases page and place it in a directory in your PATH.
Windows
For Windows users, please download the latest release from the GitHub Releases page and add it to your PATH manually.
- 📁 Use
dump_dir
to quickly gather context from multiple project files - 🧠 Paste the copied content directly into your LLM conversation
- 🔄 Easily update context by re-running
dump_dir
with different parameters
Raise an issue or make a PR, I whipped this up real quick so there's probably a lot of room for improvement.
This project is licensed under the MIT License - see the LICENSE file for details.
Happy coding! 🎉👨💻👩💻