📦 Ctrl+C

Copy only what matters! Ctrl+C your whole codebase (not your .git, __pycache__, or random CSVs) and prep your project for LLMs in one go.

---

What is Ctrl+C?

Ctrl+C is a simple Python CLI tool that formats and packages your entire codebase into a single file, making it easy to provide complete project context to an LLM for understanding or analysis. It uses ignore files, size filters, and compression options to make the output just right. No more manual copy-pasting code context over and over; one simple command and you're set for vibe coding galore :)

Installation

pip install ctrlc-cli

Usage

Run this in your project root directory:

ctrlc run

This will walk through your codebase and save the formatted context to a context.txt in the project's root directory.

Flags and Options

Flag	Description
--ignore-files	Use ignore rules from .gitignore, .contextignore, or both. Options: none, all, git (only from .gitignore), context (only from .contextignore). Default: all.
--threshold	Skip files larger than this many bytes. Ideal for keeping massive files out of the bundle.
--compress	Compress the output file into a specified format. Options: none, gzip, zip, tar.gz. Default: none.
--output	Name of the output file (without extension for compressed options). Default: context.txt.

Default Skips

Ctrl+C comes with built-in ignore rules for common non-codebase related folders/files:

• .git, .svn, .hg, __pycache__
• node_modules, .DS_Store, .vscode, .env, .venv
• context.txt, .gitignore, .contextignore

You can layer on your own .gitignore and .contextignore filters too.

The .contextignore File

The .contextignore file essentially works the same way a .gitignore file does. Simply create one in your project's root directory and add the file/folder names you want to exclude. Those files will not be written to your final context file. An example .contextignore file is given below:

*/subfolder1
*/subfolder2
file1.py
folder1

License

This project is licensed under the MIT License.