Format Output

Repomix mendukung empat format output:

• XML (default)
• Markdown
• JSON
• Plain Text

Format XML

repomix --style xml

Format XML dioptimalkan untuk pemrosesan AI:

Ini adalah representasi gabungan dari seluruh codebase...

<file_summary>
(Metadata dan instruksi AI)
</file_summary>

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

<files>
<file path="src/index.ts">
// Konten file di sini
</file>
</files>

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

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

Mengapa XML sebagai Format Default?

Repomix menggunakan XML sebagai format output default berdasarkan penelitian dan pengujian yang ekstensif. Keputusan ini didasarkan pada bukti empiris dan pertimbangan praktis untuk analisis kode yang dibantu AI.

Pilihan kami terhadap XML terutama dipengaruhi oleh rekomendasi resmi dari penyedia AI utama:

• Anthropic (Claude): Secara eksplisit merekomendasikan penggunaan tag XML untuk menyusun prompt, menyatakan bahwa "Claude terekspos pada prompt semacam itu selama pelatihan" (dokumentasi)
• Google (Gemini): Merekomendasikan format terstruktur termasuk XML untuk tugas kompleks (dokumentasi)
• OpenAI (GPT): Menganjurkan prompting terstruktur dalam skenario kompleks (pengumuman, cookbook)

Format Markdown

repomix --style markdown

Markdown menyediakan format yang mudah dibaca:

Ini adalah representasi gabungan dari seluruh codebase...

# File Summary
(Metadata dan instruksi AI)

# Directory Structure
```
src/
index.ts
utils/
helper.ts
```

# Files

## File: src/index.ts
```typescript
// Konten file di sini
```

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

Format JSON

repomix --style json

Format JSON menyediakan output terstruktur yang dapat diakses secara programatis dengan nama properti camelCase:

{
  "fileSummary": {
    "generationHeader": "File ini adalah representasi gabungan dari seluruh codebase, digabungkan menjadi satu dokumen oleh Repomix.",
    "purpose": "File ini berisi representasi terpacked dari keseluruhan konten repositori...",
    "fileFormat": "Konten diorganisir sebagai berikut...",
    "usageGuidelines": "- File ini harus diperlakukan sebagai read-only...",
    "notes": "- Beberapa file mungkin telah dikecualikan berdasarkan aturan .gitignore..."
  },
  "userProvidedHeader": "Teks header kustom jika ditentukan",
  "directoryStructure": "src/
  cli/
    cliOutput.ts
    index.ts
  config/
    configLoader.ts",
  "files": {
    "src/index.js": "// Konten file di sini",
    "src/utils.js": "// Konten file di sini"
  },
  "instruction": "Instruksi kustom dari instructionFilePath"
}

Keuntungan Format JSON

Format JSON ideal untuk:

• Pemrosesan programatis: Mudah di-parse dan dimanipulasi dengan library JSON di bahasa pemrograman apa pun
• Integrasi API: Konsumsi langsung oleh layanan web dan aplikasi
• Kompatibilitas tool AI: Format terstruktur yang dioptimalkan untuk machine learning dan sistem AI
• Analisis data: Ekstraksi informasi spesifik yang mudah menggunakan tools seperti jq

Bekerja dengan Output JSON Menggunakan jq

Format JSON memudahkan ekstraksi informasi spesifik secara programatis. Berikut adalah contoh umum:

Operasi File Dasar

# Daftar semua path file
cat repomix-output.json | jq -r '.files | keys[]'

# Hitung total jumlah file
cat repomix-output.json | jq '.files | keys | length'

# Ekstrak konten file spesifik
cat repomix-output.json | jq -r '.files["README.md"]'
cat repomix-output.json | jq -r '.files["src/index.js"]'

Filtering dan Analisis File

# Cari file berdasarkan ekstensi
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"))'

# Dapatkan file yang berisi teks spesifik
cat repomix-output.json | jq -r '.files | to_entries[] | select(.value | contains("function")) | .key'

# Buat daftar file dengan jumlah karakter
cat repomix-output.json | jq -r '.files | to_entries[] | "\(.key): \(.value | length) karakter"'

Ekstraksi Metadata

# Ekstrak struktur direktori
cat repomix-output.json | jq -r '.directoryStructure'

# Dapatkan informasi file summary
cat repomix-output.json | jq '.fileSummary.purpose'
cat repomix-output.json | jq -r '.fileSummary.generationHeader'

# Ekstrak header yang disediakan user (jika ada)
cat repomix-output.json | jq -r '.userProvidedHeader // "Tidak ada header disediakan"'

# Dapatkan instruksi kustom
cat repomix-output.json | jq -r '.instruction // "Tidak ada instruksi disediakan"'

Analisis Lanjutan

# Cari file terbesar berdasarkan panjang konten
cat repomix-output.json | jq -r '.files | to_entries[] | [.key, (.value | length)] | @tsv' | sort -k2 -nr | head -10

# Cari file yang mengandung pola spesifik
cat repomix-output.json | jq -r '.files | to_entries[] | select(.value | test("import.*react"; "i")) | .key'

# Ekstrak path file yang cocok dengan beberapa ekstensi
cat repomix-output.json | jq -r '.files | keys[] | select(test("\.(js|ts|jsx|tsx)$"))'

Format Plain Text

repomix --style plain

Struktur output:

Ini adalah representasi gabungan dari seluruh codebase...

================
File Summary
================
(Metadata dan instruksi AI)

================
Directory Structure
================
src/
  index.ts
  utils/
    helper.ts

================
Files
================

================
File: src/index.ts
================
// Konten file di sini

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

Penggunaan dengan Model AI

Setiap format bekerja dengan baik dengan model AI, tetapi pertimbangkan:

• Gunakan XML untuk Claude (akurasi parsing terbaik)
• Gunakan Markdown untuk keterbacaan umum
• Gunakan JSON untuk pemrosesan programatis dan integrasi API
• Gunakan Plain Text untuk kesederhanaan dan kompatibilitas universal

Kustomisasi

Atur format default di repomix.config.json:

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