FAQ e risoluzione dei problemi

Questa pagina aiuta a scegliere il workflow Repomix corretto, ridurre output troppo grandi e preparare contesto di codice per assistenti IA.

Domande frequenti

A cosa serve Repomix?

Repomix impacchetta un repository in un singolo file adatto all'IA. Puoi fornire a ChatGPT, Claude, Gemini o altri assistenti il contesto completo della codebase per review, debug, refactoring, documentazione e onboarding.

Repomix funziona con repository privati?

Sì. Esegui Repomix localmente in un checkout a cui la tua macchina ha già accesso:

repomix

Controlla il file generato prima di condividerlo con un servizio IA esterno.

Può elaborare repository GitHub pubblici senza clonarli?

Sì. Usa --remote con shorthand o URL completo:

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

Quale formato di output scegliere?

Usa XML come default. Usa Markdown per conversazioni leggibili, JSON per automazione e testo semplice per massima compatibilità. Cambia formato con --style:

repomix --style markdown
repomix --style json

Vedi Formati di output.

Ridurre i token

Il file generato è troppo grande. Cosa fare?

Restringi il contesto:

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

Combina pattern include e ignore con compressione del codice per repository grandi.

Cosa fa --compress?

--compress conserva struttura importante come import, export, classi, funzioni e interfacce, rimuovendo molti dettagli implementativi. È utile quando il modello deve capire l'architettura.

Sicurezza e privacy

La CLI carica il mio codice?

La CLI Repomix gira localmente e scrive un file di output sulla tua macchina. Sito web ed estensione browser hanno workflow diversi; consulta la Privacy Policy.

Come evita Repomix di includere segreti?

Repomix usa controlli basati su Secretlint. Considerali una protezione aggiuntiva e verifica sempre l'output.

Risoluzione dei problemi

Perché mancano file nell'output?

Repomix rispetta .gitignore, regole ignore predefinite e pattern personalizzati. Controlla repomix.config.json, --ignore e le regole git.

Come rendere l'output riproducibile in team?

Crea e versiona una configurazione condivisa:

repomix --init

Domande frequenti aggiuntive

Repomix funziona con C#, Python, Java, Go, Rust o altri linguaggi?

Sì. Repomix legge i file del progetto e li formatta per gli strumenti IA, quindi può impacchettare repository scritti in qualsiasi linguaggio. La CLI richiede Node.js 20 o superiore. Alcune funzionalità avanzate, come la compressione del codice basata su Tree-sitter, dipendono dal supporto del parser per ciascun linguaggio.

Posso usare Repomix con Hermes Agent, OpenClaw o altri agent compatibili con MCP?

Sì. Repomix può essere eseguito come server MCP:

npx -y repomix --mcp

Per Hermes Agent, aggiungi Repomix come server MCP stdio in ~/.hermes/config.yaml:

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

Per OpenClaw o altri agent compatibili con MCP, usa lo stesso command e gli stessi args dove l'agent permette di configurare un server MCP stdio esterno. Se il tuo assistente supporta Agent Skills, puoi usare anche Repomix Explorer Skill.

Come uso Repomix per aiutare un assistente IA a capire una nuova libreria o framework?

Impacchetta il repository della libreria o la sua documentazione, poi usa l'output come materiale di riferimento per l'assistente IA:

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

Per uso ripetuto, puoi generare una directory Agent Skills riutilizzabile:

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

Come escludo CSS, test, output di build o altri file rumorosi?

Usa --ignore per comandi singoli:

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

Usa --include quando vuoi mantenere solo specifici percorsi di codice o documentazione:

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

Esiste un limite di dimensione del repository?

La CLI non ha un limite fisso di dimensione del repository, ma repository molto grandi possono essere limitati da memoria, dimensione dei file o limiti di upload e contesto dello strumento IA. Per progetti grandi, parti da pattern include mirati, controlla i file pesanti in token e dividi l'output se necessario:

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

Perché --include non include file da node_modules, directory di build o percorsi ignorati?

--include restringe i file che Repomix prova a impacchettare, ma le regole di ignore si applicano comunque. I file possono essere esclusi da .gitignore, .ignore, .repomixignore, pattern predefiniti integrati o repomix.config.json. In casi avanzati, opzioni come --no-gitignore o --no-default-patterns possono aiutare, ma usale con attenzione perché possono includere dipendenze, artefatti di build o altri file rumorosi.

Risorse correlate

• Utilizzo base
• Opzioni da riga di comando
• Compressione del codice
• Sicurezza