Pemrosesan Repositori GitHub

Penggunaan Dasar

Memproses repositori publik:

# Menggunakan URL lengkap
repomix --remote https://github.com/user/repo

# Menggunakan singkatan GitHub
repomix --remote user/repo

Anda juga dapat memberikan singkatan owner/repo secara langsung, tanpa --remote:

repomix yamadashy/repomix

Karena owner/repo juga terlihat seperti path lokal relatif, Repomix hanya memperlakukannya sebagai repositori remote ketika tidak ada file atau direktori lokal dengan nama tersebut dan repositori dapat dijangkau di GitHub. Path lokal yang cocok selalu diutamakan; untuk memaksa penanganan lokal pada path berbentuk owner/repo, awali dengan ./ (misalnya, repomix ./owner/repo). Jika argumen cocok dengan pola tetapi repositori tidak dapat dijangkau (misalnya, repositori privat atau salah ketik), Repomix kembali menanganinya sebagai path lokal.

Pemilihan Branch dan Commit

# Branch tertentu
repomix --remote user/repo --remote-branch main

# Tag
repomix --remote user/repo --remote-branch v1.0.0

# Hash commit
repomix --remote user/repo --remote-branch 935b695

Persyaratan

• Git harus terpasang
• Koneksi internet
• Akses baca ke repositori

Kontrol Output

# Lokasi output kustom
repomix --remote user/repo -o custom-output.xml

# Dengan format XML
repomix --remote user/repo --style xml

# Hapus komentar
repomix --remote user/repo --remove-comments

Penggunaan Docker

# Memproses dan menghasilkan output ke direktori saat ini
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo

# Menghasilkan output ke direktori tertentu
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo

Keamanan

Demi keamanan, file konfigurasi (repomix.config.*) di repositori remote tidak dimuat secara default. Ini mencegah repositori yang tidak tepercaya menjalankan kode melalui file konfigurasi seperti repomix.config.ts.

Konfigurasi global dan opsi CLI Anda tetap diterapkan.

Untuk mempercayai konfigurasi repositori remote:

# Menggunakan flag CLI
repomix --remote user/repo --remote-trust-config

# Menggunakan variabel lingkungan
REPOMIX_REMOTE_TRUST_CONFIG=true repomix --remote user/repo

Saat menggunakan --config dengan --remote, path absolut diperlukan:

repomix --remote user/repo --config /home/user/repomix.config.json

Masalah Umum

Masalah Akses

• Pastikan repositori bersifat publik
• Periksa instalasi Git
• Verifikasi koneksi internet

Repositori Besar

• Gunakan --include untuk memilih path tertentu
• Aktifkan --remove-comments
• Proses branch secara terpisah

Sumber Daya Terkait

• Opsi Baris Perintah - Referensi CLI lengkap termasuk opsi --remote
• Konfigurasi - Atur opsi default untuk pemrosesan remote
• Kompresi Kode - Kurangi ukuran output untuk repositori besar
• Keamanan - Bagaimana Repomix menangani deteksi data sensitif