repo2llm

A simple tool to copy repository contents to your clipboard, useful for pasting into an LLM like Claude or ChatGPT.

Features

• 🚀 Simple command-line interface for easy usage
• 🔍 Content preview with customizable length
• 📋 Automatic clipboard integration
• 💻 Cross-platform support (Windows, macOS, Linux)
• ⚙️ Configuration file support (.repo2llm)
• 🧹 Built-in default ignore patterns for common files/directories

Installation

pip install repo2llm

Usage

Basic Usage

# Process current directory
repo2llm .

# Process specific directory
repo2llm /path/to/your/repo

Advanced Options

# Add custom ignore patterns
repo2llm . --ignore "*.log" --ignore "temp/*"

# Disable preview
repo2llm . --no-preview

# Customize preview length
repo2llm . --preview-length 300

# Use custom config file
repo2llm . --config my-config.txt

Configuration

Default Ignore Patterns

The tool automatically ignores common development files and directories. See repo2llm/constants.py for the default list.

Config File

You can create a .repo2llm file in your repository root to specify custom ignore patterns:

# Development directories
.github/
.vscode/
node_modules/

# Build artifacts
dist/
build/
*.pyc

# Custom patterns
temp/
*.bak

The config file supports:

• One pattern per line
• Comments (lines starting with #)

Contributing

Contributions are welcome, feel free to submit a PR.

Release

To release a new version, run the scripts/version.py script:

# For a patch update (0.1.0 -> 0.1.1)
poetry run python scripts/version.py patch --tag

# For a minor update (0.1.1 -> 0.2.0)
poetry run python scripts/version.py minor --tag

# For a major update (0.2.0 -> 1.0.0)
poetry run python scripts/version.py major --tag

License

MIT