TR: ai-context, yerel kaynak kodlarınızı Yapay Zeka (LLM) modellerine (Claude, ChatGPT, Gemini vb.) aktarmak için optimize edilmiş profesyonel bir "bağlam döküm" (context dumper) aracıdır. Tüm projenizi veya seçtiğiniz dosyaları tek bir Markdown dosyasına dönüştürür, panoya kopyalar ve token sayısını hesaplar. Raporlar, yetki hatalarını önlemek için otomatik olarak Masaüstü'ndeki ai-reports klasörüne kaydedilir.
EN: ai-context is a professional context dumping tool optimized for providing your codebase to LLMs (Claude, ChatGPT, Gemini, etc.). It converts your entire project or specific files into a single, clean Markdown file, copies it to the clipboard, and estimates token counts. Reports are automatically saved to the ai-reports folder on your Desktop to avoid permission issues.
- 📏 Dinamik Boyut Filtresi / Dynamic Size Filter:
-msparametresi ile belirlediğiniz KB'dan büyük dosyaları otomatik olarak atlayabilirsiniz. / Skip files larger than specified KB using-ms. - 📂 Masaüstü Çıktısı / Desktop Output: Raporlar artık her zaman Masaüstü'ne kaydedilir, böylece Program Files gibi klasörlerde yetki hatası almazsınız.
- ➕ Dinamik Dahil Etme / Dynamic Include:
-iparametresi ile listede olmayan özel uzantıları (.log, .cfg vb.) anlık olarak sürece dahil edebilirsiniz. - 📂 Tree-Only Modu: Projenin sadece klasör ağacını döküm alır (İçerik okumaz). / Dumps only folder structure (No content).
- 🧠 Smart Filter:
.gitignorekurallarını otomatik tanır ve uygular. - 🛡️ Binary Shield: Resim, video, PDF ve derlenmiş dosyaları otomatik ayıklar.
- 📋 Instant Copy: Tek tıkla tüm dökümü panoya (clipboard) kopyalar.
- 📊 Token Counter: Çıktının tahmini Token maliyetini anlık hesaplar.
GitHub üzerinden doğrudan en güncel sürümü yüklemek veya güncellemek için:
pip install --upgrade git+https://github.com/cetincevizcetoli/ai-context.gitKlasörün içine girin ve terminalde şu komutu çalıştırın. Bu sayede kodda yaptığınız değişiklikler anında komut satırına yansır:
pip install -e .Önemli / Important: Tüm parametreler tek tire (-) ile kullanılmaktadır. All parameters are used with a single dash (-).
TR: 500 KB'dan büyük dosyaları atla ve kopyala:
EN: Skip files larger than 500 KB and copy:
ai-context -ms 500 -c
TR: Özel uzantıları (log, cfg) sürece dahil et:
EN: Include extra extensions (log, cfg):
ai-context -i log cfg -c
TR: Belirli bir dosyayı hedefle ve kopyala:
EN: Target a specific file and copy:
ai-context -t main.py -c
TR: Sadece klasör yapısını al ve panoya kopyala:
EN: Get folder structure only and copy to clipboard:
ai-context -to -c
TR: Tüm projeyi tara, token sayısını göster ve kopyala:
EN: Scan project, show tokens, and copy:
ai-context . -c -tk
| Komut / Cmd | Açıklama (TR) | Description (EN) |
|---|---|---|
| -ms | Maksimum dosya boyutu (KB) | Max file size filter (KB) |
| -i | Özel uzantı ekle | Include extra extensions |
| -to | Sadece klasör yapısını dök | Tree-only mode (structure only) |
| -c | Panoya kopyala | Copy to clipboard |
| -tk | Token sayısını göster | Show estimated token count |
| -t | Sadece belirli dosyaları tara | Target specific files only |
| -xd | Klasörleri hariç tut | Exclude directories |
| -xf | Dosyaları hariç tut | Exclude files |
| -xe | Uzantıları hariç tut | Exclude extensions |
| -u | Tüm dosya tiplerini oku | Unsafe mode (Read all extensions) |
| -h | Yardım menüsünü göster | Show help menu |
MIT License. Created by Ahmet Çetin.