About the Tool

Combdir (com-der) is a lightweight CLI tool that combines an entire project into a single AI-friendly file, making it easier to share codebases with ChatGPT, Claude, Google AI Studio, Gemini, and other LLMs.

Instead of manually selecting files, copying folders, or worrying about context limits, combdir scans your project and generates a consolidated Markdown or plain-text document containing your source files, organized and ready for AI consumption.

Key Features

• Recursive project scanning with optional folder tree generation

• .gitignore support to automatically exclude unwanted files

• Smart filtering through include/exclude patterns

• Binary file detection to avoid unreadable content

• File size limits for controlling output size

• Node modules exclusion with a dedicated flag

• Folder skipping by name anywhere in the project

• Large-folder protection via maximum files-per-folder limits

• Optional timestamps and file metadata

• Markdown and plain-text output modes

• Token estimation to help stay within LLM context windows.

• Usage Guidance: Provides clear installation instructions, usage examples, and troubleshooting tips for common issues.

Technical Details

• Developed using PowerShell.

• Designed to work on Windows OS with PowerShell 7 or later.

• Supports various command-line options for fine-grained control over file inclusion, exclusion, and output formatting.

The generated output is ideal for:

• Code reviews

• Bug fixing

• Architecture discussions

• Refactoring assistance

• Documentation generation

• Repository onboarding

• AI pair programming sessions

Typical Usage

For a Next.js or React application, a single command can collect the important source files, respect existing .gitignore rules, skip dependency folders, and produce a clean AI-ready context file:

combdir . -GitIgnore -SkipNodeModules -MaxFilesPerFolder 10 -r

The result is a compact representation of your project that can be uploaded directly to an AI assistant without the hassle of manually curating files.