vomitorium
v2.0.0
Published
Traverse project structure and write file contents to a single output file
Downloads
65
Maintainers
Readme
Vomitorium is a command-line tool designed to easily load an entire project into a single text file. It recursively scans directories, processes files, and compiles their contents into a single output file. Useful for working with LLMs.
Features
- Recursively scan directories
- Include/exclude specific directories and files
- Filter files by extension
- Customizable output file
- Configurable via command-line options or configuration file
Installation
npm install -g vomitorium
Usage
vomitorium [options]
Options
--scan <dir>
: Directory to scan (default: current working directory)--include <dirs>
: Comma-separated list of directories to include--exclude <patterns>
: Comma-separated list of directories or files to exclude--extensions <exts>
: Comma-separated list of file extensions to include--show-excluded
: Show excluded files in the output--show-skipped
: Show skipped files without listing their contents--output <file>
: Specify the output file name
Examples
vomitorium --scan ./myproject --include src,tests
vomitorium --exclude node_modules,dist,package.json --extensions .js,.ts
vomitorium --scan /path/to/project --show-excluded --show-skipped
vomitorium --output my-custom-output.txt
Configuration
Vomitorium uses cosmiconfig for configuration file support. You can create a configuration file named .vomitoriumrc
, .vomitoriumrc.json
, .vomitoriumrc.yaml
, vomitorium.config.js
, or add a "vomitorium"
key to your package.json
file.
Default configuration:
{
"scan": ".",
"include": [],
"exclude": ["node_modules", ".git", "dist", "build"],
"excludeFiles": ["package.json", "package-lock.json"],
"extensions": [".js", ".ts", ".json"],
"showExcluded": true,
"showSkipped": true,
"outputFile": "output.sick"
}
Output
The tool generates a single output file (default: output.sick
) containing the contents of all processed files, separated by file headers.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.