GitHub-Repository-Verarbeitung

Grundlegende Verwendung

Öffentliche Repositories verarbeiten:

# Mit vollständiger URL
repomix --remote https://github.com/user/repo

# Mit GitHub-Kurzform
repomix --remote user/repo

Branch- und Commit-Auswahl

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

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

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

Voraussetzungen

• Git muss installiert sein
• Internetverbindung
• Lesezugriff auf das Repository

Ausgabekontrolle

# Benutzerdefinierter Ausgabeort
repomix --remote user/repo -o custom-output.xml

# Mit XML-Format
repomix --remote user/repo --style xml

# Kommentare entfernen
repomix --remote user/repo --remove-comments

Docker-Verwendung

# Verarbeitung und Ausgabe in das aktuelle Verzeichnis
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo

# Ausgabe in bestimmtes Verzeichnis
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo

Sicherheit

Aus Sicherheitsgründen werden Konfigurationsdateien (repomix.config.*) in Remote-Repositories standardmäßig nicht geladen. Dadurch wird verhindert, dass nicht vertrauenswürdige Repositories über Konfigurationsdateien wie repomix.config.ts Code ausführen.

Ihre globale Konfiguration und CLI-Optionen werden weiterhin angewendet.

Um der Konfiguration eines Remote-Repositorys zu vertrauen:

# Per CLI-Flag
repomix --remote user/repo --remote-trust-config

# Per Umgebungsvariable
REPOMIX_REMOTE_TRUST_CONFIG=true repomix --remote user/repo

Bei Verwendung von --config mit --remote ist ein absoluter Pfad erforderlich:

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

Häufige Probleme

Zugriffsprobleme

• Stellen Sie sicher, dass das Repository öffentlich ist
• Überprüfen Sie die Git-Installation
• Überprüfen Sie die Internetverbindung

Große Repositories

• Verwenden Sie --include, um bestimmte Pfade auszuwählen
• Aktivieren Sie --remove-comments
• Verarbeiten Sie Branches separat