llm-context-cli 0.0.4

A tool to combine multiple files into a single file for AI context

LLM Context CLI

🚀 A powerful command-line tool to combine multiple files into a single file formatted for Large Language Model (LLM) context.

🌟 Features

• 📁 Combine multiple files into a single document
• 🎯 Smart file pattern matching and exclusion
• 🎨 Markdown-formatted output with syntax highlighting
• 🔄 Preserve file structure and organization
• ⚡️ Fast and efficient processing
• 🛠 Customizable output formatting

📋 Prerequisites

• Python 3.7 or higher
• pip (Python package installer)

🚀 Installation

Install using pip:

pip install llm-context-cli

Or install with pipx for isolated environments:

pipx install llm-context-cli

💻 Usage

Basic Usage

Simply point the tool to your project directory:

llm-context-cli /path/to/project

Advanced Usage

Customize the output with various options:

llm-context-cli /path/to/project \
    --patterns "*.py" "*.js" \
    --exclude "__pycache__/*" "node_modules/*" \
    --output llmcontext.txt \
    --header "Project source code for review:" \
    --no-language

🎮 Command Options

Option	Short	Description	Example
--patterns	-p	File patterns to include (multiple allowed)	--patterns "*.py" "*.js"
--exclude	-e	Patterns to exclude (multiple allowed)	--exclude "test/*" "*.pyc"
--output	-o	Output file path	--output combined.txt
--header	-h	Optional header text	--header "Source code:"
--language/--no-language	-	Toggle language hints in code blocks	--no-language

📝 Examples

Combining Python and JavaScript Files

llm-context-cli . \
    --patterns "*.py" "*.js" \
    --exclude "tests/*" \
    --header "Frontend and Backend Source Code:"

Processing a Specific Directory

llm-context-cli ./src \
    --patterns "*.ts" \
    --output typescript-code.txt \
    --language

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a new branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Commit your changes (git commit -m 'Add amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

📄 License

This project is licensed under the MIT License.

🙏 Acknowledgments

• Thanks to all contributors who have helped shape this tool
• Inspired by the need for better LLM context management

---

Made with ❤️ for the AI and developer community