# I got 30% better AI coding results

> Source: <https://github.com/akasula09/CodeSlimmer>
> Published: 2026-08-09 22:01:47+00:00

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**.

- 🌐
**Remote GitHub URL Support:** Pass any public GitHub URL (`[https://github.com/user/repo](https://github.com/user/repo)`

) to fetch, extract, and slim repositories directly—zero`git`

required. - 📋
**Cross-Platform Clipboard Integration:** Instantly copies output directly to your system clipboard (Windows, macOS, or Linux). - 🛡️
**Overwrite Safety:** Inspects signature headers to ensure local files are never overwritten accidentally. - 🌳
**ASCII Directory Tree:** Builds a visual project structure map at the very top of your context output. - 🏷️
**LLM-Friendly XML Output:** Encloses code in clear`<file path="...">`

tags for max prompt accuracy. - 📊
**Token Estimator:** Estimates context size (~4 chars/token) and checks capacity against major models. - 📏
**Smart File Sizes:** Calculates and formats physical sizes (`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:

``` php
<!-- GENERATED BY CODESLIMMER v2.2 - DO NOT EDIT MANUALLY -->

<project_structure_tree>
my_project_folder/
├── src/
│   ├── index.js
│   └── utils.js
├── .gitignore
└── package.json
</project_structure_tree>

<file path="src/index.js">
console.log("Hello World");
</file>

<file path="src/utils.js">
export function add(a, b) { return a + b; }
</file>
```

Distributed under the **PolyForm Noncommercial License 1.0.0**. Free for personal, educational, research, and internal business use. See [LICENSE](/akasula09/CodeSlimmer/blob/main/LICENSE) for details.