FAQ et dépannage

Cette page aide à choisir le bon workflow Repomix, réduire les sorties volumineuses et préparer un contexte de code pour les assistants IA.

Questions fréquentes

À quoi sert Repomix ?

Repomix empaquette un dépôt dans un seul fichier adapté à l'IA. Vous pouvez ainsi fournir à ChatGPT, Claude, Gemini ou d'autres assistants un contexte complet pour revue de code, investigation de bugs, refactorisation, documentation et onboarding.

Repomix fonctionne-t-il avec les dépôts privés ?

Oui. Exécutez Repomix localement dans un checkout auquel votre machine a déjà accès :

repomix

Relisez le fichier généré avant de le partager avec un service IA externe.

Peut-il traiter un dépôt GitHub public sans le cloner ?

Oui. Utilisez --remote avec la forme courte ou une URL complète :

npx repomix --remote yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix

Quel format de sortie choisir ?

Utilisez XML par défaut. Choisissez Markdown pour des conversations lisibles, JSON pour l'automatisation et texte brut pour une compatibilité maximale. Changez de format avec --style :

repomix --style markdown
repomix --style json

Consultez Formats de sortie.

Réduire les tokens

Le fichier généré est trop volumineux. Que faire ?

Réduisez le contexte :

repomix --include "src/**/*.ts,docs/**/*.md"
repomix --ignore "**/*.test.ts,dist/**"
repomix --compress
repomix --remove-comments

Combinez les patterns include et ignore avec la compression de code pour les grands dépôts.

Que fait --compress ?

--compress conserve la structure importante comme imports, exports, classes, fonctions et interfaces, tout en retirant beaucoup de détails d'implémentation. C'est utile pour une analyse d'architecture.

Sécurité et confidentialité

La CLI envoie-t-elle mon code ?

La CLI Repomix s'exécute localement et écrit un fichier de sortie sur votre machine. Le site web et l'extension navigateur ont des workflows différents ; consultez la Politique de confidentialité.

Comment Repomix évite-t-il les secrets ?

Repomix utilise des contrôles basés sur Secretlint. Cela reste une protection supplémentaire : vérifiez toujours la sortie.

Dépannage

Pourquoi des fichiers manquent-ils dans la sortie ?

Repomix respecte .gitignore, les règles ignore par défaut et les patterns personnalisés. Vérifiez repomix.config.json, --ignore et vos règles git.

Comment rendre la sortie reproductible en équipe ?

Créez et versionnez une configuration partagée :

repomix --init

Questions fréquentes supplémentaires

Repomix fonctionne-t-il avec C#, Python, Java, Go, Rust ou d'autres langages ?

Oui. Repomix lit les fichiers de votre projet et les formate pour les outils d'IA, il peut donc empaqueter des dépôts écrits dans n'importe quel langage. La CLI nécessite Node.js 20 ou plus récent. Certaines fonctions avancées, comme la compression basée sur Tree-sitter, dépendent de la prise en charge des parseurs pour chaque langage.

Puis-je utiliser Repomix avec Hermes Agent, OpenClaw ou d'autres agents compatibles MCP ?

Oui. Repomix peut s'exécuter comme serveur MCP :

npx -y repomix --mcp

Pour Hermes Agent, ajoutez Repomix comme serveur MCP stdio dans ~/.hermes/config.yaml :

mcp_servers:
  repomix:
    command: "npx"
    args: ["-y", "repomix", "--mcp"]

Pour OpenClaw ou d'autres agents compatibles MCP, utilisez la même commande et les mêmes arguments là où l'agent permet de configurer un serveur MCP stdio externe. Si votre assistant prend en charge Agent Skills, vous pouvez aussi utiliser Repomix Explorer Skill.

Comment aider un assistant IA à comprendre une nouvelle bibliothèque ou un framework ?

Empaquetez le dépôt de la bibliothèque ou sa documentation, puis donnez la sortie à l'assistant IA comme référence :

npx repomix --remote owner/repo
npx repomix --remote owner/repo --include "docs/**,src/**"

Pour un usage répété, vous pouvez générer un répertoire Agent Skills réutilisable :

npx repomix --remote owner/repo --skill-generate library-reference

Comment exclure CSS, tests, sorties de build ou autres fichiers bruyants ?

Utilisez --ignore pour une commande ponctuelle :

repomix --ignore "**/*.css,**/*.test.ts,dist/**,coverage/**"

Utilisez --include pour ne garder que certains chemins de code source ou de documentation :

repomix --include "src/**/*.ts,docs/**/*.md"

Existe-t-il une limite de taille de dépôt ?

La CLI n'a pas de limite fixe de taille de dépôt, mais les très grands dépôts peuvent être limités par la mémoire, la taille de fichier ou les limites d'upload et de contexte de l'outil d'IA. Pour les grands projets, commencez avec des include ciblés, inspectez les fichiers lourds en tokens et divisez la sortie si nécessaire :

repomix --token-count-tree 1000
repomix --split-output 1mb

Pourquoi --include n'inclut-il pas les fichiers de node_modules, des dossiers de build ou des chemins ignorés ?

--include réduit les fichiers que Repomix essaie d'empaqueter, mais les règles d'ignore s'appliquent toujours. Des fichiers peuvent être exclus par .gitignore, .ignore, .repomixignore, les motifs par défaut intégrés ou repomix.config.json. Dans les cas avancés, --no-gitignore ou --no-default-patterns peuvent aider, mais utilisez-les prudemment car ils peuvent inclure des dépendances, des artefacts de build ou d'autres fichiers bruyants.

Ressources liées

• Utilisation de base
• Options de ligne de commande
• Compression de code
• Sécurité