Repomix nedir? Kurulum, kullanım, MCP ve güvenlik notları

Projeni ChatGPT ya da Claude'a göstermek için dosyaları tek tek yüklemen gerekmez. Klasörde tek komut çalıştırırsın, Repomix bütün kodu, klasör ağacını ve token sayısını tek bir dosyada toplar; o dosyayı sohbete yükleyip "bu projeyi özetle" dersin. Kurulum gerekmez: npx repomix@latest, Node.js 22 veya üstü. Aynı program repomix --mcp ile asistanın doğrudan kullanacağı bir MCP sunucusu da olur.

Ne yapar: Kod klasörünü tek dosyada toplar
Tür: Komut satırı aracı (ve MCP sunucusu)
Yapımcı: Kazuki Yamada (bireysel geliştirici)
CLI verisi: Telemetri toplamıyor
Geçmiş: 5 yayımlı güvenlik uyarısı (düzeltilmiş)
Türkçe: CLI İngilizce; site Türkçe seçeneği sunuyor
Ücret: Ücretsiz, MIT

Repomix ne işe yarar?

Bir sohbet asistanına projenin kodunu göstermek istediğinde dosyaları tek tek yüklemek yorucudur. Repomix klasörü gezer, dosya içeriklerini, dizin ağacını ve token sayısını tek bir çıktı dosyasında toplar. İstersen GitHub'daki bir depoyu indirmeden paketler (--remote), çıktıyı küçültür (--compress) ya da parçalara böler.

Kodu yapay zekâya tek dosyada vermekNe alırsın: repomix-output.xml (varsayılan)Ayrı kurulum gerekir

Aynı araç MCP sunucusu olarak da çalışır: asistan paketlemeyi kendisi tetikler, çıktıda arama yapar ve okur. Claude Code için resmî eklentiler de var.

Kime yarar: Büyük bir kod tabanını sohbet asistanına yüklemek ya da bir depoyu hızlıca analiz ettirmek isteyen geliştiricilere.

Repomix nasıl çalışır?

Klasörün

src/App.jsx
src/api.js
README.md
package.json

Kodun bulunduğu klasör.

Tek komut› npx repomix@latestKlasörün içinde çalıştırırsın; kurulum gerekmez.

Tek dosyarepomix-output.xmlkod + klasör ağacı + token sayısıDosyayı sohbete yükleyip projeyi özetlettirirsin.

Repomix nasıl kurulur?

Gereken: Node.js 22.0.0 veya üstü (uzak depo için ayrıca Git). Hesap ve anahtar gerekmez. Komutlar Repomix kurulum sayfasından alındı.

Proje klasöründe› npx repomix@latest

İlk çalıştırma klasörde repomix-output.xml dosyası oluşturur.

npm› npm install -g repomix

Homebrew› brew install repomix

Docker› docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix

Ekle› claude mcp add repomix -- npx -y repomix --mcp

Tek klasöre kısıtlı› repomix --mcp --sandbox path/to/project

Claude Code eklentileri için: /plugin marketplace add yamadashy/repomix, sonra /plugin install repomix-mcp@repomix. Eklenti repomix@latest çalıştırır, yani sürümü sabitlemez.

VS Code› code --add-mcp '{"name":"repomix","command":"npx","args":["-y","repomix","--mcp"]}'

Cursor, Cline ve Claude Desktop için yapılandırma dosyasına mcpServers altında repomix girdisi (komut npx, argümanlar -y repomix --mcp) eklenir.

Sürüm sabitlemek için npx repomix@1.18.1 yaz; bu bir README örneği değil, bu sayfanın önerisi.

Repomix nasıl kullanılır?

Komut	Ne yapar
repomix	Bulunduğun klasörü paketler.
repomix --include "src//.ts,/.md"**	Yalnız eşleşen dosyaları paketler.
repomix --ignore "/.log,tmp/"*	Ek dışlama kalıpları.
repomix --style markdown	Çıktı biçimi: xml (varsayılan), markdown, json, plain.
repomix --compress	Kod gövdelerini atıp imzaları bırakır (belge: deneysel).
repomix --remote kullanici/depo	GitHub deposunu klonlayıp paketler.
repomix --token-count-tree	Klasör bazlı token dökümü.
repomix --copy	Çıktıyı panoya da kopyalar.
repomix --split-output 1mb	Çıktıyı parçalara böler.

Varsayılan olarak .gitignore, .ignore, .repomixignore ve yerleşik kalıplar (node_modules, .git, ikili dosyalar) uygulanır. Paketlemesini istemediğin yolları .repomixignore dosyasına yaz.

Depoyu analiz ettir"Ekteki repomix çıktısını oku. Projenin mimarisini, ana modüllerini ve dikkat edilmesi gereken yerleri özetle. Çıktıdaki hiçbir parola ya da anahtarı tekrar etme."

Repomix nerede çalışır?

Terminal (CLI)Var	npx, npm, Homebrew ya da Docker.
Claude CodeVar	MCP olarak ya da resmî eklentilerle.
Claude Desktop, VS Code (Insiders dahil), Cline, CursorVar	MCP belgesinde yapılandırma var.
Codex, GitHub Copilot ve diğerleriKısmen	Yalnız repomix-explorer becerisi (Agent Skills); MCP değil.
repomix.com web sitesiVar	Dosyalar sitenin sunucusuna geçici gider.

Repomix neye erişir, güvenli mi?

Okur

Paketlenen klasördeki dosyalar, yerel git geçmişi (sıralama için; istenirse diff ve commit günlüğü), --remote ile verilen GitHub deposu. MCP kipinde varsayılanda kullanıcının okuyabildiği her yol.

Yazar

Tek çıktı dosyası; istenirse panoya kopya; --init ile yapılandırma dosyası; --skill-generate ile .claude/skills altında beceri klasörü.

Siler

Belgede kullanıcı dosyası silen bir komut yok.

Veri

Resmî gizlilik sayfasına göre CLI telemetri ve kullanıcı verisi toplamaz; internet yalnız kurulum, --remote ve güncelleme kontrolünde kullanılır. repomix.com sitesi ise Google Analytics kullanır ve yüklenen dosyaları işlem için geçici tutup siler. Çıktıyı sonra yüklediğin yapay zekâ hizmeti ayrı bir veri yoludur.

MCP kipinde Repomix, varsayılanda sunucuyu çalıştıran kullanıcının okuyabildiği her yolu okuyabilir. --sandbox bunu tek klasöre sınırlar ama belge bunun işletim sistemi düzeyinde korumalı alan olmadığını söylüyor; --sandbox ayrıca uzak paketlemeyi ve beceri üretimini de kapatır. Secretlint taraması bir garanti değil: yakalamadığı gizli bilgi olabilir, çıktıyı paylaşmadan gözden geçir.

Geçmiş güvenlik uyarıları (GitHub, hepsi 1.18.1 ve öncesinde düzeltilmiş):

Uyarı	Özet	Etkilenen sürümler
GHSA-9mm9-rqhj-j5mx	Yüksek: --remote-branch argümanıyla komut enjeksiyonu	1.14.1 öncesi
GHSA-4p5g-gh74-q524	Yüksek: hazırlanmış bir depo git yapılandırması komut çalıştırabiliyordu	0.2.41–1.18.0 (1.18.1 düzeltiyor)
GHSA-hwpp-h97w-2h3j	Orta: attach_packed_output gizli bilgi taramasını atlatabiliyordu	1.14.0 ve öncesi
GHSA-w8cw-mgw9-74h7	Orta: uzak depo adresindeki parola ya da jeton günlüğe açık yazılıyordu	1.17.0 ve öncesi
GHSA-rpmv-562j-qxrv	Düşük: MCP dosya araçları iddia ettikleri korumaları uygulamıyordu	1.17.0 ve öncesi

Güncel sürüm 1.18.1 için OSV boş döndü. Bu "güvenli" demek değildir. Eski bir önbelleğe alınmış npx sürümüyle çalışma riskine karşı npx repomix@latest kullan. Uyarı özetlerini GitHub güvenlik danışmanlıkları sayfasından aldık.

Repomix ücretsiz mi?

Evet. Repomix MIT lisanslı açık kaynak; hesap, abonelik ya da kullanım limiti belgede yok. Yalnız GitHub Sponsors ile bağış istenir. Çıktıyı yüklediğin yapay zekâ hizmetinin kendi planı ve limiti ayrıdır. TL fiyatı yok.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
npx repomix hata veriyor	Node.js 22.0.0 veya üstünü kullan.
Paketlenmesini istediğim dosya çıktıda yok	gitignore ve yerleşik kalıplar uygulanır; gerekirse --no-gitignore, --no-default-patterns bayrakları.
Çıktı asistanın yükleme sınırını aşıyor	--split-output 1mb, --compress ya da --include ile küçült.
Kullanıcıların bildirdiği --split-output sonrası eski parçalar yeni çıktıya karışıyor	Açık hata (#1920); parçaları çalıştırmadan önce sil.
Kullanıcıların bildirdiği --mcp --verbose ile MCP istemcisi bozuk yanıt alıyor	Açık hata (#1866); MCP'de --verbose kullanma.

Repomix nasıl kaldırılır?

Genel kurulum: npm uninstall -g repomix ya da brew uninstall repomix (paket yöneticisinin olağan komutları; resmî belgede yazmıyor).
MCP: Claude Code'da claude mcp remove repomix; diğer istemcilerde yapılandırma dosyasından girdiyi sil.
Eklentiler: /plugin menüsünden repomix-mcp, repomix-commands, repomix-explorer'ı kaldır.
Çıktılar: repomix-output dosyalarını ve --skill-generate ile oluşan klasörü elle sil.

Sık sorulan sorular

Repomix nedir?

Bir kod deposunu yapay zekâya verilecek tek dosyada toplayan açık kaynak komut satırı aracıdır. Dosya içeriğini, dizin ağacını ve token sayısını tek çıktıda verir.

Repomix ücretsiz mi?

Evet, MIT lisanslı açık kaynak; hesap ya da anahtar gerekmez. Paketi yüklediğin yapay zekâ hizmetinin kendi planı ve limiti ayrıdır.

Repomix gizli bilgilerimi siler mi, güvenli mi?

Secretlint ile bilinen kimlik bilgisi biçimlerine uyan içeriği çıktıdan çıkarır ama yakalamadığı gizli bilgi olabilir; resmî belge çıktıyı paylaşmadan önce gözden geçirmeyi söylüyor. Güvenli damgası yoktur ve geçmişte 5 güvenlik uyarısı yayımlanmış, hepsi 1.18.1 ve öncesinde düzeltilmiş.

Kodum Repomix sunucularına gidiyor mu?

CLI'da hayır: gizlilik sayfası CLI'nin kullanıcı verisi ve telemetri toplamadığını yazıyor. repomix.com sitesine dosya yüklersen işlem için sunucuda geçici tutulur ve silinir; site Google Analytics kullanır.

Repomix'i Claude Code'a MCP olarak nasıl eklerim?

Terminalde claude mcp add repomix -- npx -y repomix --mcp komutunu çalıştır. Alternatif olarak plugin marketplace add yamadashy/repomix ile resmî eklentileri kurabilirsin. MCP varsayılanda okunabilen her yolu okuyabilir; sandbox seçeneği bunu tek klasöre sınırlar.

Hangi Node sürümü gerekiyor?

Node.js 22.0.0 veya üstü. Docker ya da Homebrew ile de kurulabilir.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Eklenti klasörlerinde hook olup olmadığı (denetlenemedi) · tarayıcı eklentilerinin izinleri · sitenin Türkçe belge kapsamı · Türkçe ve TL bilgisi. Her biri ilgili bölümde yazılı.