Traitement des dépôts GitHub

Utilisation de base

Traiter des dépôts publics:

# En utilisant l'URL complète
repomix --remote https://github.com/user/repo
# En utilisant le format abrégé GitHub
repomix --remote user/repo

Vous pouvez aussi passer le format abrégé owner/repo directement, sans --remote :

repomix yamadashy/repomix

Comme owner/repo ressemble aussi à un chemin local relatif, Repomix ne le traite comme un dépôt distant que lorsqu'aucun fichier ou dossier local de ce nom n'existe et que le dépôt est accessible sur GitHub. Un chemin local existant a toujours la priorité ; pour forcer le traitement local d'un chemin en forme owner/repo, préfixez-le par ./ (par exemple, repomix ./owner/repo). Si l'argument correspond au motif mais que le dépôt est inaccessible (par exemple un dépôt privé ou une faute de frappe), Repomix le traite alors comme un chemin local.

Sélection de branche et de commit

# Branche spécifique
repomix --remote user/repo --remote-branch main
# Tag
repomix --remote user/repo --remote-branch v1.0.0
# Hash de commit
repomix --remote user/repo --remote-branch 935b695

Prérequis

• Git doit être installé
• Connexion Internet
• Accès en lecture au dépôt

Contrôle de la sortie

# Emplacement de sortie personnalisé
repomix --remote user/repo -o custom-output.xml
# Avec format XML
repomix --remote user/repo --style xml
# Supprimer les commentaires
repomix --remote user/repo --remove-comments

Utilisation avec Docker

# Traiter et sortir dans le répertoire courant
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo
# Sortie vers un répertoire spécifique
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \
  --remote user/repo

Sécurité

Par mesure de sécurité, les fichiers de configuration (repomix.config.*) des dépôts distants ne sont pas chargés par défaut. Cela empêche les dépôts non fiables d'exécuter du code via des fichiers de configuration tels que repomix.config.ts.

Votre configuration globale et vos options CLI restent appliquées.

Pour faire confiance à la configuration d'un dépôt distant :

# Via le flag CLI
repomix --remote user/repo --remote-trust-config

# Via une variable d'environnement
REPOMIX_REMOTE_TRUST_CONFIG=true repomix --remote user/repo

Lors de l'utilisation de --config avec --remote, un chemin absolu est requis :

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

Problèmes courants

Problèmes d'accès

• Assurez-vous que le dépôt est public
• Vérifiez l'installation de Git
• Vérifiez la connexion Internet

Dépôts volumineux

• Utilisez --include pour sélectionner des chemins spécifiques
• Activez --remove-comments
• Traitez les branches séparément

Ressources associées

• Options de ligne de commande - Référence complète de la CLI incluant les options --remote
• Configuration - Configurer les options par défaut pour le traitement distant
• Compression de code - Réduire la taille de sortie pour les grands dépôts
• Sécurité - Comment Repomix gère la détection de données sensibles