Formati di Output

Repomix supporta quattro formati di output:

• XML (predefinito)
• Markdown
• JSON
• Testo semplice

Formato XML

repomix --style xml

Il formato XML è ottimizzato per l'elaborazione da parte dell'IA:

Questo file è una rappresentazione unificata dell'intera codebase...
<file_summary>
(Metadati e istruzioni per l'IA)
</file_summary>
<directory_structure>
src/
  index.ts
  utils/
    helper.ts
</directory_structure>
<files>
<file path="src/index.ts">
// Contenuto del file qui
</file>
</files>

<git_logs>
2025-08-20 00:47:19 +0900|feat(cli): Add --include-logs option for git commit history
README.md
src/cli/cliRun.ts
src/core/git/gitCommand.ts
src/core/git/gitLogHandle.ts
src/core/output/outputGenerate.ts

2025-08-21 00:09:43 +0900|Merge pull request #795 from yamadashy/chore/ratchet-update-ci
.github/workflows/ratchet-update.yml
</git_logs>

Perché XML come formato predefinito?

Repomix usa XML come formato di output predefinito basandosi su ricerche e test approfonditi. Questa decisione si fonda su prove empiriche e considerazioni pratiche per l'analisi del codice assistita dall'IA.

La nostra scelta di XML è principalmente influenzata dalle raccomandazioni ufficiali dei principali fornitori di IA:

• Anthropic (Claude): Raccomanda esplicitamente l'uso di tag XML per strutturare i prompt, affermando che "Claude è stato esposto a tali prompt durante l'addestramento" (documentazione)
• Google (Gemini): Raccomanda formati strutturati incluso XML per compiti complessi (documentazione)
• OpenAI (GPT): Sostiene il prompting strutturato in scenari complessi (annuncio, cookbook)

Formato Markdown

repomix --style markdown

Il Markdown offre una formattazione leggibile:

Questo file è una rappresentazione unificata dell'intera codebase...
# Riepilogo File
(Metadati e istruzioni per l'IA)
# Struttura Directory
```
src/
index.ts
utils/
helper.ts
```
# File
## File: src/index.ts
```typescript
// Contenuto del file qui
```

# Log Git
```
2025-08-20 00:47:19 +0900|feat(cli): Add --include-logs option for git commit history
README.md
src/cli/cliRun.ts
src/core/git/gitCommand.ts
src/core/git/gitLogHandle.ts
src/core/output/outputGenerate.ts

2025-08-21 00:09:43 +0900|Merge pull request #795 from yamadashy/chore/ratchet-update-ci
.github/workflows/ratchet-update.yml
```

Formato JSON

repomix --style json

Il formato JSON fornisce un output strutturato e accessibile programmaticamente con nomi di proprietà in camelCase:

{
  "fileSummary": {
    "generationHeader": "Questo file è una rappresentazione unificata dell'intera codebase, combinata in un singolo documento da Repomix.",
    "purpose": "Questo file contiene una rappresentazione compatta del contenuto dell'intero repository...",
    "fileFormat": "Il contenuto è organizzato come segue...",
    "usageGuidelines": "- Questo file dovrebbe essere trattato come di sola lettura...",
    "notes": "- Alcuni file potrebbero essere stati esclusi secondo le regole .gitignore..."
  },
  "userProvidedHeader": "Testo di intestazione personalizzato se specificato",
  "directoryStructure": "src/
  cli/
    cliOutput.ts
    index.ts
  config/
    configLoader.ts",
  "files": {
    "src/index.js": "// Contenuto del file qui",
    "src/utils.js": "// Contenuto del file qui"
  },
  "instruction": "Istruzioni personalizzate da instructionFilePath"
}

Vantaggi del Formato JSON

Il formato JSON è ideale per:

• Elaborazione programmatica: Facile da analizzare e manipolare con librerie JSON in qualsiasi linguaggio di programmazione
• Integrazione API: Consumo diretto da servizi web e applicazioni
• Compatibilità strumenti IA: Formato strutturato ottimizzato per machine learning e sistemi IA
• Analisi dati: Estrazione semplice di informazioni specifiche con strumenti come jq

Lavorare con l'Output JSON usando jq

Il formato JSON facilita l'estrazione programmatica di informazioni specifiche. Ecco esempi comuni:

Operazioni Base sui File

# Elenca tutti i percorsi dei file
cat repomix-output.json | jq -r '.files | keys[]'

# Conta il numero totale di file
cat repomix-output.json | jq '.files | keys | length'

# Estrai il contenuto di un file specifico
cat repomix-output.json | jq -r '.files["README.md"]'
cat repomix-output.json | jq -r '.files["src/index.js"]'

Filtraggio e Analisi File

# Trova file per estensione
cat repomix-output.json | jq -r '.files | keys[] | select(endswith(".ts"))'
cat repomix-output.json | jq -r '.files | keys[] | select(endswith(".js") or endswith(".ts"))'

# Ottieni file contenenti testo specifico
cat repomix-output.json | jq -r '.files | to_entries[] | select(.value | contains("function")) | .key'

# Crea una lista di file con conteggio caratteri
cat repomix-output.json | jq -r '.files | to_entries[] | "\(.key): \(.value | length) caratteri"'

Estrazione Metadati

# Estrai la struttura delle directory
cat repomix-output.json | jq -r '.directoryStructure'

# Ottieni le informazioni del riepilogo file
cat repomix-output.json | jq '.fileSummary.purpose'
cat repomix-output.json | jq -r '.fileSummary.generationHeader'

# Estrai l'intestazione fornita dall'utente (se esiste)
cat repomix-output.json | jq -r '.userProvidedHeader // "Nessuna intestazione fornita"'

# Ottieni le istruzioni personalizzate
cat repomix-output.json | jq -r '.instruction // "Nessuna istruzione fornita"'

Analisi Avanzata

# Trova i file più grandi per lunghezza del contenuto
cat repomix-output.json | jq -r '.files | to_entries[] | [.key, (.value | length)] | @tsv' | sort -k2 -nr | head -10

# Cerca file contenenti pattern specifici
cat repomix-output.json | jq -r '.files | to_entries[] | select(.value | test("import.*react"; "i")) | .key'

# Estrai percorsi di file corrispondenti a multiple estensioni
cat repomix-output.json | jq -r '.files | keys[] | select(test("\.(js|ts|jsx|tsx)$"))'

Formato Testo Semplice

repomix --style plain

Struttura di output:

Questo file è una rappresentazione unificata dell'intera codebase...
================
Riepilogo File
================
(Metadati e istruzioni per l'IA)
================
Struttura Directory
================
src/
  index.ts
  utils/
    helper.ts
================
File
================
================
File: src/index.ts
================
// Contenuto del file qui

================
Log Git
================
2025-08-20 00:47:19 +0900|feat(cli): Add --include-logs option for git commit history
README.md
src/cli/cliRun.ts
src/core/git/gitCommand.ts
src/core/git/gitLogHandle.ts
src/core/output/outputGenerate.ts

2025-08-21 00:09:43 +0900|Merge pull request #795 from yamadashy/chore/ratchet-update-ci
.github/workflows/ratchet-update.yml

Utilizzo con i Modelli IA

Ogni formato funziona bene con i modelli IA, ma considera:

• Usa XML per Claude (migliore precisione nell'analisi)
• Usa Markdown per una migliore leggibilità generale
• Usa JSON per l'elaborazione programmatica e l'integrazione API
• Usa testo semplice per semplicità e compatibilità universale

Personalizzazione

Imposta il formato predefinito in repomix.config.json:

{
  "output": {
    "style": "xml",
    "filePath": "output.xml"
  }
}