A command-line tool for concatenating text files in a directory tree, designed for creating context files for LLM prompting.
- Recursively finds and concatenates all text files in a directory
- Respects
.gitignorepatterns (optional) - Multiple header styles for file sections
- Line numbering support
- Customizable path display (relative/absolute)
- Various output formatting options
Using uv:
uv venv
source .venv/bin/activate # or Windows equivalent
uv pip install -e .Basic usage:
promcat # Process current directory, output to stdout
promcat /path/to/project # Process specific directory
promcat -o output.txt # Save to file instead of stdout--output, -o Output file path (defaults to stdout)
--respect-gitignore Honor .gitignore patterns
--relative/--absolute Use relative or absolute paths in headers
--style Header style (newline|separator|markdown|xml)
--footer Include footers for file sections
--line-numbers Add line numbers to output
--separator Custom separator for line numbers (default: '|')- Newline (
--style newline):
content of file 1
content of file 2
- Separator (
--style separator):
=== file1.txt ===
content of file 1
=== end file1.txt ===
- Markdown (
--style markdown):
## file1.txt
content of file 1
## end file1.txt
# script.py
content of script
# end script.py
- XML (
--style xml):
<file><path>file1.txt</path><content>content of file 1</content></file>
Add line numbers with custom separator:
promcat --line-numbers --separator ' > 'Output:
=== file1.txt ===
1 > First line
2 > Second line
- Creating context files for LLM prompting
- Combining multiple source files for analysis
- Creating documentation from source files
- Code review and auditing
- Creating backups of text content
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License