https://github.com/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
ai chatgpt claude cli command-line command-line-tool gpt llm prompt prompt-engineering prompt-generator prompt-toolkit rust
Last synced: 11 days ago
JSON representation
A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting.
- Host: GitHub
- URL: https://github.com/mufeedvh/code2prompt
- Owner: mufeedvh
- License: mit
- Created: 2024-03-09T12:42:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-09T15:46:49.000Z (12 days ago)
- Last Synced: 2025-04-09T16:49:06.318Z (12 days ago)
- Topics: ai, chatgpt, claude, cli, command-line, command-line-tool, gpt, llm, prompt, prompt-engineering, prompt-generator, prompt-toolkit, rust
- Language: Rust
- Homepage: https://code2prompt.dev
- Size: 2.67 MB
- Stars: 5,326
- Watchers: 32
- Forks: 309
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ChatGPT-repositories - code2prompt - A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting. (Prompts)
- jimsghstars - mufeedvh/code2prompt - A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting. (Rust)
- project-awesome - mufeedvh/code2prompt - A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting. (Rust)
- definitive-opensource - Code2prompt
- AiTreasureBox - mufeedvh/code2prompt - 04-15_5390_2](https://img.shields.io/github/stars/mufeedvh/code2prompt.svg)|A CLI tool to convert your codebase into a single LLM prompt with source tree, prompt templating, and token counting.| (Repos)
- StarryDivineSky - mufeedvh/code2prompt
README
Convert your codebase into a single LLM prompt !
[](https://crates.io/crates/code2prompt)
[](https://github.com/mufeedvh/code2prompt/blob/master/LICENSE)
[](https://github.com/user/repo/pulls)
[](https://github.com/mufeedvh/code2prompt)
[](https://discord.com/invite/zxVMKtsFbK)
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 ⚡
CLI with cargo 🦀
```bash
cargo install code2prompt
```SDK with pip 🐍
```bash
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](https://code2prompt.dev/docs/welcome/) 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 optionsStop 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](https://code2prompt.dev/docs/how_to/install/) for detailed installation instructions.
### Binary releases
Download the latest binary for your OS from [Releases](https://github.com/mufeedvh/code2prompt/releases).
### Source build
Requires:
- [Git](https://git-scm.org/downloads), [Rust](https://rust-lang.org/tools/install) and `Cargo`.
```sh
git clone https://github.com/mufeedvh/code2prompt.git
cd code2prompt/
cargo install --path crates/code2prompt
```## Star History
[](https://star-history.com/#mufeedvh/code2prompt&Date)
## 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 :star: !
## 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