GitHub - mufeedvh/code2prompt: A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting.

https://github.com/mufeedvh/code2prompt • Apr 11, 2025 20:27

Extracto

A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting. - mufeedvh/code2prompt

Resumen

Resumen Principal

code2prompt emerge como una solución integral y altamente especializada diseñada para transformar bases de código complejas en prompts estructurados y optimizados para Modelos de Lenguaje Grandes (LLMs). Su objetivo principal es simplificar y acelerar drásticamente el proceso de análisis, generación y otras tareas asistidas por IA en el ámbito del desarrollo de software, eliminando la necesidad de copiar, pegar y formatear código manualmente. La herramienta opera de manera inteligente, rastreando directorios, construyendo una estructura de árbol lógica y extrayendo información esencial de cada archivo para generar un contexto coherente. Destaca por su flexibilidad de uso, ofreciendo una interfaz de línea de comandos (CLI) para la interacción directa, un SDK con bindings de Python para la integración en agentes de IA y scripts de automatización, y un servidor MCP que potencia a los LLMs al proporcionarles acceso a un contexto de codebase bien estructurado localmente. Con características como filtrado inteligente, plantillas personalizables y seguimiento de tokens, code2prompt se posiciona como un facilitador clave para aprovechar al máximo las capacidades

Contenido

Convert your codebase into a single LLM prompt !

Want to engage with us ? Join our Discord channel!
Stay updated on new features 📢
Give your insight and suggestion 💬
Get help with configuration and usage 🛠️
Report Bug 🐛

Quick Install ⚡

# Cargo
$ cargo install code2prompt

# Homebrew
$ brew install code2prompt

SDK with pip 🐍

pip install code2prompt-rs

How is it useful?

Core

code2prompt is a code ingestion tool that streamline the process of creating LLM prompts for code analysis, generation, and other tasks. It works by traversing directories, building a tree structure, and gathering informations about each file. The core library can easily be integrated into other applications.

CLI

code2prompt command line interface (CLI) was designed for humans to generate prompts directly from your codebase. The generated prompt is automatically copied to your clipboard and can also be saved to an output file. Furthermore, you can customize the prompt generation using Handlebars templates. Check out the provided prompts in the doc !

SDK

code2prompt software development kit (SDK) offers python binding to the core library. This is perfect for AI agents or automation scripts that want to interact with codebase seamlessly. The SDK is hosted on Pypi and can be installed via pip.

MCP

code2prompt is also available as a Model Context Protocol (MCP) server, which allows you to run it as a local service. This enables LLMs on steroids by providing them a tool to automatically gather a well-structured context of your codebase.

Documentation 📚

Check our online documentation for detailed instructions

Features

Code2Prompt transforms your entire codebase into a well-structured prompt for large language models. Key features include:

Automatic Code Processing: Convert codebases of any size into readable, formatted prompts
Smart Filtering: Include/exclude files using glob patterns and respect .gitignore rules
Flexible Templating: Customize prompts with Handlebars templates for different use cases
Token Tracking: Track token usage to stay within LLM context limits
Git Integration: Include diffs, logs, and branch comparisons in your prompts
Developer Experience: Automatic clipboard copy, line numbers, and file organization options

Stop manually copying files and formatting code for LLMs. Code2Prompt handles the tedious work so you can focus on getting insights and solutions from AI models.

Alternative Installation

Refer to the documentation for detailed installation instructions.

Binary releases

Download the latest binary for your OS from Releases.

Source build

Requires:

Git, Rust and Cargo.

git clone https://github.com/mufeedvh/code2prompt.git
cd code2prompt/
cargo install --path crates/code2prompt

Star History

License

Licensed under the MIT License, see LICENSE for more information.

Liked the project?

If you liked the project and found it useful, please give it a ⭐ !

Contribution

Ways to contribute:

Suggest a feature
Report a bug
Fix something and open a pull request
Help me document the code
Spread the word