winget install --id=akasula09.CodeSlimmer -e CodeSlimmer is a free CLI tool that safely packages local codebases into clean, LLM-optimized XML context with directory mapping and multi-model token estimation.
> Safely convert local codebases or public GitHub repos into clean, LLM-ready context with token estimation and directory mapping.
CodeSlimmer packs any code repository—whether stored on your local machine or hosted on GitHub—into a single text file structured specifically for AI models like Claude 3.5, Gemini 3.1 Pro/3.6 Flash, GPT-4o, and DeepSeek R1.
[https://github.com/user/repo](https://github.com/user/repo)) to fetch, extract, and slim repositories directly—zero git required.B, KB, MB, GB).Install CodeSlimmer using pip:
pip install code-slimmer
Clone the repository and run the script directly:
git clone [https://github.com/akasula09/codeslimmer.git](https://github.com/akasula09/codeslimmer.git)
cd codeslimmer
If installed via pip:
codeslimmer
If running directly from source:
python codeslimmer.py
CodeSlimmer supports two distinct input modes:
Enter a relative or absolute local folder path. CodeSlimmer creates ai_context.txt inside that folder and offers an optional clipboard copy. An example is below.
--- CODE SLIMMER v2.2 ---
Enter a local folder path OR a GitHub URL: my_project_folder
📄 Loaded rules from .gitignore
--- SUCCESS! ---
Packed 12 code files.
Final Context Size: 18.45 KB
💾 Added 'ai_context.txt' directly into your folder!
📊 Estimated Token Count: ~4,612 tokens
--------------------------------------------------
Which AI provider are you targeting? (gemini / claude / chatgpt / deepseek): gemini
--------------------------------------------------
🎯 Evaluated against Gemini Models:
✅ Gemini 3.1 Pro: Fits! (4,612 / 2,000,000 tokens — 0.2306% capacity)
✅ Gemini 3.6 Flash: Fits! (4,612 / 1,000,000 tokens — 0.4612% capacity)
✅ Gemini 3.5 Flash-Lite: Fits! (4,612 / 1,000,000 tokens — 0.4612% capacity)
Do you want to copy the output text directly to your clipboard as well?
Type 'y' for Yes, or press Enter to skip: y
📋 Copied full context directly to your clipboard! Ready to Ctrl+V into AI.
Paste any public GitHub URL. CodeSlimmer fetches and slims the repository in a temporary workspace, estimates tokens, and prompts you to copy the result straight to your clipboard without leaving messy files behind.
--- CODE SLIMMER v2.2 ---
Enter a local folder path OR a GitHub URL: [https://github.com/akasula09/codeslimmer](https://github.com/akasula09/codeslimmer)
🌐 Fetching repository 'akasula09/codeslimmer' from GitHub...
--- SUCCESS! ---
Packed 5 code files.
Final Context Size: 12.30 KB
📊 Estimated Token Count: ~3,075 tokens
--------------------------------------------------
Which AI provider are you targeting? (gemini / claude / chatgpt / deepseek): claude
--------------------------------------------------
🎯 Evaluated against Claude Models:
✅ Claude 3.5 Sonnet / Haiku: Fits! (3,075 / 200,000 tokens — 1.5375% capacity)
✅ Claude 3 Opus: Fits! (3,075 / 200,000 tokens — 1.5375% capacity)
Do you want to copy the output text directly to your clipboard?
Type 'y' for Yes, or press Enter to skip: y
📋 Copied full context directly to your clipboard! Ready to Ctrl+V into AI.
> ℹ️ Private Repositories: Unauthenticated requests to private or non-existent repositories will output:
> ❌ Repository does not exist or is private.
CodeSlimmer structures the prompt context using this clean, LLM-optimized XML format:
my_project_folder/
├── src/
│ ├── index.js
│ └── utils.js
├── .gitignore
└── package.json
console.log("Hello World");
export function add(a, b) { return a + b; }
Distributed under the PolyForm Noncommercial License 1.0.0. Free for personal, educational, research, and internal business use. See LICENSE for details.