code-collator 0.1

A CLI tool to aggregate codebase into a single Markdown file

Code Collator

Code Collator is a powerful CLI tool designed to streamline your code review and documentation process by collating your entire codebase into a single, organised Markdown file. This is particularly useful for sharing with AI tools like ChatGPT or Claude for analysis, troubleshooting, or documentation.

Use Case

Have you ever needed to provide a comprehensive overview of your codebase for a code review, AI analysis, or detailed documentation? Code Collator simplifies this task by aggregating all your code files into a single Markdown file. This makes it easy to:

• Share your code with AI tools like ChatGPT or Claude for intelligent analysis.
• Generate a unified document for code reviews or team collaboration.
• Create comprehensive documentation for your projects with minimal effort.

Features

• Full Codebase Collation: Collates all files in the specified directory and subdirectories into one Markdown file.
• .gitignore Support: Automatically ignores files specified in the .gitignore file if one exists.
• Customizable Output: Outputs a single Markdown file named collated-code.md by default, with options to specify the path to the codebase directory and output file name.
• Binary File Inclusion: Includes binary files such as images in the output with a note about their file type.
• Help Command: Provides a help command to display usage instructions.

Installation

You can easily install Code Collator using pip:

pip install code-collator

Usage

Here’s a basic example of how to use Code Collator:

code-collator --path /path/to/codebase --output my-collated-code.md

For more detailed usage instructions, use the help command:

code-collator --help