Repomix: Tüm Kod Deponuzu Yapay Zeka İçin Tek Dosyada Paketleyin

Karmaşık, çok dosyalı bir projeniz var ve bir hata ayıklama (debugging) veya refactoring için yapay zekadan yardım almak istiyorsunuz. Dosyaları tek tek kopyalayıp yapıştırmak tam bir işkence, değil mi? İşte tam bu noktada Repomix (eski adıyla Repopack) imdadımıza yetişiyor. | 🇬🇧 English

Repomix Nedir?

Repomix, tüm kod deponuzu (repository) yapay zeka modellerinin (Claude, ChatGPT, Gemini, DeepSeek vb.) en iyi anlayabileceği şekilde tek bir dosyada paketleyen güçlü bir CLI aracıdır. Sadece dosyaları birleştirmekle kalmaz, aynı zamanda çıktı dosyasını XML, Markdown veya JSON gibi yapay zekanın bağlamı (context) daha iyi kavramasını sağlayan formatlarda optimize eder.

Öne Çıkan Özellikler

• AI-Optimized: Kodunuzu yapay zekanın yapısını kolayca çözebileceği formatlarda sunar.
• Token Sayımı: Hem her dosya hem de tüm çıktı için toplam token sayısını gösterir (LLM limitlerini aşmamak için kritik).
• Güvenlik Odaklı: Secretlint entegrasyonu sayesinde yanlışlıkla API anahtarlarınızı veya şifrelerinizi çıktıya dahil etmenizi engeller.
• Akıllı Sıkıştırma: --compress seçeneği ile kodun mantığını bozmadan gereksiz detayları budayarak token tasarrufu sağlar.
• Git-Aware: .gitignore kurallarınıza otomatik olarak saygı duyar.

Hızlı Başlangıç

Repomix’i bilgisayarınıza kurmadan npx ile anında deneyebilirsiniz:

npx repomix

Bu komut, bulunduğunuz dizindeki tüm projeyi tarayacak ve repomix-output.xml adında bir dosya oluşturacaktır.

Kurulum (Global)

Eğer sürekli kullanmak isterseniz:

# npm ile
npm install -g repomix

# Alternatif olarak (macOS/Linux)
brew install repomix

Pratik Kullanım Senaryoları

1. Kod İncelemesi (Code Review)

Paketlediğiniz dosyayı yapay zekaya yükleyin ve şu prompt’u verin:

“Bu dosya projemin tamamını içeriyor. Genel mimariyi incele ve ölçeklenebilirlik açısından gördüğün zayıf noktaları belirt.”

2. Dokümantasyon Oluşturma

“Bu kod tabanına dayanarak, kurulum adımlarını ve API kullanım örneklerini içeren detaylı bir README.md dosyası oluştur.”

3. Test Senaryoları Yazma

“Ana fonksiyonlar için kenar durumları (edge cases) içeren kapsamlı bir unit test seti öner.”

Gelişmiş Komutlar

Sadece belirli dosyaları dahil etmek veya uzak bir depoyu paketlemek de mümkün:

# Sadece src altındaki TypeScript dosyalarını al, logları dahil etme
repomix --include "src/**/*.ts" --ignore "**/*.log"

# Uzak bir GitHub deposunu yerel klasöre çekmeden paketle
repomix --remote yamadashy/repomix

# Çıktıyı Markdown formatında al
repomix --style markdown

Sonuç

Özellikle benim gibi Arch Linux ve terminal tabanlı iş akışlarını sevenler için Repomix, yapay zeka ile kod geliştirme sürecini bambaşka bir boyuta taşıyor. Manuel kopyalama ile vakit kaybetmek yerine, projeyi saniyeler içinde paketleyip yapay zekaya “Snapshot” olarak sunmak, bağlam hatalarını (context errors) minimize ediyor.

Siz de projelerinizi yapay zekaya anlatırken zorlanıyorsanız, repomix.com adresine bir göz atmanızı veya CLI aracını denemenizi şiddetle öneririm. Ayrıca repomix’in github sayfasını da ziyaret edebilirsiniz: https://github.com/yamadashy/repomix