Repomix

^{Special thanks to:}

Warp, built for coding with multiple AI agents
Available for MacOS, Linux, & Windows

Tuple, the premier screen sharing app for developers on macOS and Windows.

🏆 Nomination agli Open Source Awards ​

Siamo onorati! Repomix è stato nominato nella categoria Powered by AI ai JSNation Open Source Awards 2025.

Questo non sarebbe stato possibile senza tutti voi che usate e supportate Repomix. Grazie!

Cos'è Repomix? ​

Repomix è uno strumento potente che impacchetta l'intera tua codebase in un singolo file compatibile con l'IA. Che tu stia lavorando a revisioni del codice, refactoring o abbia bisogno di assistenza IA per il tuo progetto, Repomix rende facile condividere tutto il contesto del tuo repository con gli strumenti IA.

Avvio Rapido ​

Una volta generato un file compresso (repomix-output.xml) con Repomix, puoi inviarlo a un assistente IA (come ChatGPT, Claude) con un'istruzione come:

Questo file contiene tutti i file del repository combinati in uno solo.
Vorrei fare refactoring del codice, quindi per favore esaminalo prima.

L'IA analizzerà la tua intera codebase e fornirà informazioni dettagliate:

Quando discuti modifiche specifiche, l'IA può aiutarti a generare codice. Con funzionalità come gli Artefatti di Claude, puoi anche ricevere più file interdipendenti:

Buona programmazione! 🚀

Perché Repomix? ​

La forza di Repomix risiede nella sua capacità di funzionare con servizi in abbonamento come ChatGPT, Claude, Gemini, Grok senza preoccuparsi dei costi, fornendo al contempo un contesto completo della codebase che elimina la necessità di esplorare i file, rendendo l'analisi più veloce e spesso più precisa.

Con l'intera codebase disponibile come contesto, Repomix permette un'ampia gamma di applicazioni tra cui pianificazione dell'implementazione, investigazione di bug, verifiche di sicurezza di librerie di terze parti, generazione di documentazione e molto altro.

Utilizzo dello Strumento CLI ​

Repomix può essere usato come strumento a linea di comando, offrendo potenti funzionalità e opzioni di personalizzazione.

Lo strumento CLI può accedere ai repository privati poiché utilizza il Git installato localmente.

Avvio Rapido ​

Puoi provare Repomix istantaneamente nella directory del tuo progetto senza installazione:

npx repomix@latest

Oppure installalo globalmente per un uso ripetuto:

# Installazione con npm
npm install -g repomix

# O con yarn
yarn global add repomix

# O con bun
bun add -g repomix

# O con Homebrew (macOS/Linux)
brew install repomix

# Poi eseguilo in qualsiasi directory di progetto
repomix

Tutto qui! Repomix genererà un file repomix-output.xml nella tua directory corrente, contenente l'intero repository in un formato adatto all'IA.

Utilizzo ​

Per impacchettare l'intero repository:

repomix

Per impacchettare una directory specifica:

repomix path/to/directory

Per impacchettare file o directory specifici usando pattern glob:

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

Per escludere file o directory specifici:

repomix --ignore "**/*.log,tmp/"

Per impacchettare un repository remoto:

# Usando il formato abbreviato
npx repomix --remote yamadashy/repomix

# Usando l'URL completo (supporta branch e percorsi specifici)
npx repomix --remote https://github.com/yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix/tree/main

# Usando l'URL di un commit
npx repomix --remote https://github.com/yamadashy/repomix/commit/836abcd7335137228ad77feb28655d85712680f1

Per inizializzare un nuovo file di configurazione (repomix.config.json):

repomix --init

Una volta generato il file compresso, puoi usarlo con strumenti di IA generativa come Claude, ChatGPT e Gemini.

Utilizzo con Docker ​

Puoi anche eseguire Repomix con Docker 🐳 È utile se vuoi eseguire Repomix in un ambiente isolato o preferisci usare i container.

Utilizzo base (directory corrente):

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix

Per impacchettare una directory specifica:

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory

Elaborare un repository remoto e salvare in una directory output:

docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix

Formati di Output ​

Scegli il tuo formato di output preferito:

# Formato XML (predefinito)
repomix --style xml

# Formato Markdown
repomix --style markdown

# Formato JSON
repomix --style json

# Formato testo semplice
repomix --style plain

Personalizzazione ​

Crea un repomix.config.json per impostazioni persistenti:

{
  "output": {
    "style": "markdown",
    "filePath": "custom-output.md",
    "removeComments": true,
    "showLineNumbers": true,
    "topFilesLength": 10
  },
  "ignore": {
    "customPatterns": ["*.test.ts", "docs/**"]
  }
}

Casi d'Uso Reali ​

Workflow di Generazione Codice con LLM ​

Uno sviluppatore condivide come usa Repomix per estrarre il contesto del codice da codebase esistenti, poi sfrutta questo contesto con LLM come Claude e Aider per miglioramenti incrementali, revisioni del codice e generazione automatizzata di documentazione.

Creazione di Pacchetti di Conoscenza per gli LLM ​

Gli autori usano Repomix per impacchettare i loro contenuti scritti—blog, documentazione e libri—in formati compatibili con gli LLM, permettendo ai lettori di interagire con la loro esperienza tramite sistemi di domanda e risposta alimentati dall'IA.

Scopri altri casi d'uso →

Guida per Utenti Avanzati ​

Repomix offre funzionalità potenti per casi d'uso avanzati. Ecco alcune guide essenziali per utenti avanzati:

• Server MCP - Integrazione del Model Context Protocol per assistenti IA
• GitHub Actions - Automatizza l'impacchettamento delle codebase nei workflow CI/CD
• Compressione Codice - Compressione intelligente basata su Tree-sitter (~70% di riduzione token)
• Usare come Libreria - Integra Repomix nelle tue applicazioni Node.js
• Istruzioni Personalizzate - Aggiungi prompt e istruzioni personalizzate agli output
• Funzionalità di Sicurezza - Integrazione Secretlint incorporata e controlli di sicurezza
• Best Practice - Ottimizza i tuoi workflow IA con strategie comprovate

Altri Esempi ​