Ausgabeformate

Repomix unterstützt vier Ausgabeformate:

• XML (Standard)
• Markdown
• JSON
• Klartext

XML-Format

repomix --style xml

Das XML-Format ist für die KI-Verarbeitung optimiert:

Diese Datei ist eine zusammengeführte Darstellung der gesamten Codebasis...

<file_summary>
(Metadaten und KI-Anweisungen)
</file_summary>

<directory_structure>
src/
  index.ts
  utils/
    helper.ts
</directory_structure>

<files>
<file path="src/index.ts">
// Dateiinhalt hier
</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>

Warum XML als Standardformat?

Repomix verwendet XML als Standard-Ausgabeformat basierend auf umfangreichen Forschungen und Tests. Diese Entscheidung gründet auf empirischen Belegen und praktischen Überlegungen für KI-unterstützte Codeanalyse.

Unsere Wahl von XML wird hauptsächlich von offiziellen Empfehlungen großer KI-Anbieter beeinflusst:

• Anthropic (Claude): Empfiehlt explizit die Verwendung von XML-Tags zur Strukturierung von Prompts und erklärt, dass "Claude während des Trainings solchen Prompts ausgesetzt war" (Dokumentation)
• Google (Gemini): Empfiehlt strukturierte Formate einschließlich XML für komplexe Aufgaben (Dokumentation)
• OpenAI (GPT): Befürwortet strukturiertes Prompting in komplexen Szenarien (Ankündigung, Cookbook)

Markdown-Format

repomix --style markdown

Markdown bietet lesbare Formatierung:

Diese Datei ist eine zusammengeführte Darstellung der gesamten Codebasis...

# Dateizusammenfassung
(Metadaten und KI-Anweisungen)

# Verzeichnisstruktur
```text
src/
  index.ts
  utils/
    helper.ts
```

# Dateien

## Datei: src/index.ts
```typescript
// Dateiinhalt hier
```

# 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
```

JSON-Format

repomix --style json

Das JSON-Format bietet strukturierte, programmatisch zugängliche Ausgabe mit camelCase-Eigenschaftsnamen:

{
  "fileSummary": {
    "generationHeader": "Diese Datei ist eine zusammengeführte Darstellung der gesamten Codebasis, die von Repomix in ein einziges Dokument kombiniert wurde.",
    "purpose": "Diese Datei enthält eine gepackte Darstellung des gesamten Repository-Inhalts...",
    "fileFormat": "Der Inhalt ist wie folgt organisiert...",
    "usageGuidelines": "- Diese Datei sollte als schreibgeschützt behandelt werden...",
    "notes": "- Einige Dateien wurden möglicherweise aufgrund von .gitignore-Regeln ausgeschlossen..."
  },
  "userProvidedHeader": "Benutzerdefinierter Header-Text falls angegeben",
  "directoryStructure": "src/
  cli/
    cliOutput.ts
    index.ts
  config/
    configLoader.ts",
  "files": {
    "src/index.js": "// Dateiinhalt hier",
    "src/utils.js": "// Dateiinhalt hier"
  },
  "instruction": "Benutzerdefinierte Anweisungen aus instructionFilePath"
}

Vorteile des JSON-Formats

Das JSON-Format ist ideal für:

• Programmatische Verarbeitung: Einfaches Parsen und Manipulieren mit JSON-Bibliotheken in jeder Programmiersprache
• API-Integration: Direkte Nutzung durch Webdienste und Anwendungen
• KI-Tool-Kompatibilität: Strukturiertes Format optimiert für maschinelles Lernen und KI-Systeme
• Datenanalyse: Unkomplizierte Extraktion spezifischer Informationen mit Tools wie jq

Arbeiten mit JSON-Ausgabe mit jq

Das JSON-Format macht es einfach, spezifische Informationen programmatisch zu extrahieren. Hier sind häufige Beispiele:

Grundlegende Dateioperationen

# Alle Dateipfade auflisten
cat repomix-output.json | jq -r '.files | keys[]'

# Gesamtanzahl der Dateien zählen
cat repomix-output.json | jq '.files | keys | length'

# Spezifischen Dateiinhalt extrahieren
cat repomix-output.json | jq -r '.files["README.md"]'
cat repomix-output.json | jq -r '.files["src/index.js"]'

Dateifilterung und -analyse

# Dateien nach Erweiterung finden
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"))'

# Dateien mit spezifischem Text finden
cat repomix-output.json | jq -r '.files | to_entries[] | select(.value | contains("function")) | .key'

# Dateiliste mit Zeichenzählung erstellen
cat repomix-output.json | jq -r '.files | to_entries[] | "\(.key): \(.value | length) Zeichen"'

Metadaten-Extraktion

# Verzeichnisstruktur extrahieren
cat repomix-output.json | jq -r '.directoryStructure'

# Dateizusammenfassungsinformationen abrufen
cat repomix-output.json | jq '.fileSummary.purpose'
cat repomix-output.json | jq -r '.fileSummary.generationHeader'

# Benutzerdefinierte Header extrahieren (falls vorhanden)
cat repomix-output.json | jq -r '.userProvidedHeader // "Kein Header angegeben"'

# Benutzerdefinierte Anweisungen abrufen
cat repomix-output.json | jq -r '.instruction // "Keine Anweisungen angegeben"'

Erweiterte Analyse

# Größte Dateien nach Inhaltslänge finden
cat repomix-output.json | jq -r '.files | to_entries[] | [.key, (.value | length)] | @tsv' | sort -k2 -nr | head -10

# Nach Dateien mit spezifischen Mustern suchen
cat repomix-output.json | jq -r '.files | to_entries[] | select(.value | test("import.*react"; "i")) | .key'

# Dateipfade mit mehreren Erweiterungen extrahieren
cat repomix-output.json | jq -r '.files | keys[] | select(test("\.(js|ts|jsx|tsx)$"))'

Klartext-Format

repomix --style plain

Ausgabestruktur:

Diese Datei ist eine zusammengeführte Darstellung der gesamten Codebasis...

================
Dateizusammenfassung
================
(Metadaten und KI-Anweisungen)

================
Verzeichnisstruktur
================
src/
  index.ts
  utils/
    helper.ts

================
Dateien
================

================
Datei: src/index.ts
================
// Dateiinhalt hier

================
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

Verwendung mit KI-Modellen

Jedes Format funktioniert gut mit KI-Modellen, aber berücksichtigen Sie:

• Verwenden Sie XML für Claude (beste Parsing-Genauigkeit)
• Verwenden Sie Markdown für allgemeine Lesbarkeit
• Verwenden Sie JSON für programmatische Verarbeitung und API-Integration
• Verwenden Sie Klartext für Einfachheit und universelle Kompatibilität

Anpassung

Setzen Sie das Standardformat in repomix.config.json:

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