Combicode

Combicode is a zero-dependency CLI tool that intelligently combines your project's source code into a single, LLM-friendly text file.

The generated file starts with a system prompt and a file tree overview, priming the LLM to understand your project's complete context instantly. Paste the contents of combicode.txt into ChatGPT, Claude, or any other LLM to get started.

Why use Combicode?

• Maximum Context: Gives your LLM a complete picture of your project structure and code.
• Intelligent Priming: Starts the output with a system prompt and a file tree, directing the LLM to analyze the entire codebase before responding.
• Intelligent Ignoring: Automatically skips node_modules, .venv, dist, .git, binary files, and other common junk.
• .gitignore Aware: Respects your project's existing .gitignore rules out of the box.
• Zero-Install Usage: Run it directly with npx or pipx without polluting your environment.
• Customizable: Easily filter by file extension or add custom ignore patterns.

Quick Start

Navigate to your project's root directory in your terminal and run one of the following commands:

For Node.js/JavaScript/TypeScript projects (via npx):

npx combicode

For Python projects (or general use, via pipx):

pipx run combicode

This will create a combicode.txt file in your project directory, complete with the context-setting header.

Usage and Options

Preview which files will be included

Use the --dry-run or -d flag to see a list of files without creating the output file.

# npx
npx combicode --dry-run

# pipx
pipx run combicode -d

Specify an output file

Use the --output or -o flag.

npx combicode -o my_project_context.md

Include only specific file types

Use the --include-ext or -i flag with a comma-separated list of extensions.

# Include only TypeScript, TSX, and CSS files
npx combicode -i .ts,.tsx,.css

# Include only Python and YAML files
pipx run combicode -i .py,.yaml

Add custom exclude patterns

Use the --exclude or -e flag with comma-separated glob patterns.

# Exclude all test files and anything in a 'docs' folder
npx combicode -e "**/*_test.py,docs/**"

All CLI Options

Option	Alias	Description	Default
--output	-o	The name of the output file.	combicode.txt
--dry-run	-d	Preview files without creating the output file.	false
--include-ext	-i	Comma-separated list of extensions to exclusively include.	(include all)
--exclude	-e	Comma-separated list of additional glob patterns to exclude.	(none)
--no-gitignore		Do not use patterns from the project's .gitignore file.	false
--no-header		Omit the introductory prompt and file tree from the output.	false
--version	-v	Show the version number.
--help	-h	Show the help message.

License

This project is licensed under the MIT License.