Ai-digest NPM | npm.io

ai-digest

A CLI tool to aggregate your codebase into a single Markdown file for use with Claude Projects or custom ChatGPTs.

Features

Aggregates all files in the specified directory and subdirectories
Ignores common build artifacts and configuration files
Outputs a single Markdown file containing the whole codebase
Provides options for whitespace removal and custom ignore patterns

How to Use

Start by running the CLI tool in your project directory:

npx ai-digest

This will generate a codebase.md file with your codebase.

Once you've generated the Markdown file containing your codebase, you can use it with AI models like ChatGPT and Claude for code analysis and assistance.

With ChatGPT:

Create a Custom GPT
Upload the generated Markdown file to the GPT's knowledge base

With Claude:

Create a new Project
Add the Markdown file to the Project's knowledge

For best results, re-upload the Markdown file before starting a new chat session to ensure the AI has the most up-to-date version of your codebase.

Options

-i, --input <directory>: Specify input directory (default: current directory)
-o, --output <file>: Specify output file (default: codebase.md)
--no-default-ignores: Disable default ignore patterns
--whitespace-removal: Enable whitespace removal
--show-output-files: Display a list of files included in the output
--ignore-file <file>: Specify a custom ignore file (default: .aidigestignore)
--help: Show help

Examples

Basic usage:
```
npx ai-digest
```

Specify input and output:

npx ai-digest -i /path/to/your/project -o project_summary.md

Enable whitespace removal:
```
npx ai-digest --whitespace-removal
```
Show list of included files:
```
npx ai-digest --show-output-files
```

Combine multiple options:

npx ai-digest -i /path/to/your/project -o project_summary.md --whitespace-removal --show-output-files

Custom Ignore Patterns

ai-digest supports custom ignore patterns using a .aidigestignore file in the root directory of your project. This file works similarly to .gitignore, allowing you to specify files and directories that should be excluded from the aggregation.

Use the --show-output-files flag to see which files are being included, making it easier to identify candidates for exclusion.

Whitespace Removal

When using the --whitespace-removal flag, ai-digest removes excess whitespace from files to reduce the token count when used with AI models. This feature is disabled for whitespace-dependent languages like Python and YAML.

Binary and SVG File Handling

Binary files and SVGs are included in the output with a note about their file type. This allows AI models to be aware of these files without including their full content.