Befehlszeilenoptionen

Grundlegende Optionen

• -v, --version: Tool-Version anzeigen

CLI Ein-/Ausgabeoptionen

Option	Beschreibung
--verbose	Ausführliches Debug-Logging aktivieren (zeigt Dateiverarbeitung, Token-Anzahlen und Konfigurationsdetails)
--quiet	Alle Konsolenausgaben außer Fehler unterdrücken (nützlich für Skripting)
--stdout	Gepackte Ausgabe direkt an stdout statt in eine Datei schreiben (unterdrückt alle Protokollierung)
--stdin	Dateipfade von stdin lesen, einen pro Zeile (angegebene Dateien werden direkt verarbeitet)
--copy	Generierte Ausgabe nach der Verarbeitung in die Systemzwischenablage kopieren
--token-count-tree [threshold]	Dateibaum mit Token-Anzahlen anzeigen; optionaler Schwellenwert um nur Dateien mit mindestens N Token anzuzeigen (z.B. --token-count-tree 100)
--top-files-len <number>	Anzahl der größten Dateien in der Zusammenfassung (Standard: 5)

Repomix-Ausgabeoptionen

Option	Beschreibung
-o, --output <file>	Ausgabedateipfad (Standard: repomix-output.xml, "-" für stdout)
--style <style>	Ausgabeformat: xml, markdown, json oder plain (Standard: xml)
--output-file-path-style <style>	Darstellung der Dateipfade in der Ausgabe: target-relative oder cwd-relative (Standard: target-relative)
--parsable-style	Sonderzeichen escapen, um gültiges XML/Markdown sicherzustellen (nötig wenn die Ausgabe Code enthält, der die Formatierung bricht)
--compress	Wesentliche Code-Struktur (Klassen, Funktionen, Interfaces) mittels Tree-sitter-Parsing extrahieren
--output-show-line-numbers	Jede Zeile mit ihrer Zeilennummer in der Ausgabe versehen
--no-file-summary	Datei-Zusammenfassungsbereich aus der Ausgabe weglassen
--no-directory-structure	Verzeichnisbaum-Visualisierung aus der Ausgabe weglassen
--no-files	Nur Metadaten ohne Dateiinhalte generieren (nützlich für Repository-Analyse)
--remove-comments	Alle Code-Kommentare vor dem Packen entfernen
--remove-empty-lines	Leerzeilen aus allen Dateien entfernen
--truncate-base64	Lange Base64-Datenstrings kürzen, um die Ausgabegröße zu reduzieren
--header-text <text>	Benutzerdefinierten Text am Anfang der Ausgabe einfügen
--instruction-file-path <path>	Pfad zu einer Datei mit benutzerdefinierten Anweisungen, die in die Ausgabe aufgenommen werden
--split-output <size>	Ausgabe in mehrere nummerierte Dateien aufteilen (z.B. repomix-output.1.xml); Größe wie 500kb, 2mb oder 1.5mb
--include-empty-directories	Ordner ohne Dateien in die Verzeichnisstruktur aufnehmen
--include-full-directory-structure	Gesamten Repository-Baum im Verzeichnisstruktur-Abschnitt anzeigen, auch bei Verwendung von --include-Mustern
--no-git-sort-by-changes	Dateien nicht nach Git-Änderungshäufigkeit sortieren (Standard: meistgeänderte Dateien zuerst)
--include-diffs	Git-Diff-Abschnitt mit Arbeitsbaum- und gestuften Änderungen hinzufügen
--include-logs	Git-Commit-Historie mit Nachrichten und geänderten Dateien hinzufügen
--include-logs-count <count>	Anzahl der letzten Commits, die mit --include-logs eingeschlossen werden (Standard: 50)

Dateiauswahloptionen

Option	Beschreibung
--include <patterns>	Nur Dateien einschließen, die diesen Glob-Mustern entsprechen (kommagetrennt, z.B. "src/**/*.js,*.md")
-i, --ignore <patterns>	Zusätzliche Muster zum Ausschließen (kommagetrennt, z.B. "*.test.js,docs/**")
--no-gitignore	.gitignore-Regeln nicht zum Filtern von Dateien verwenden
--no-dot-ignore	.ignore-Regeln nicht zum Filtern von Dateien verwenden
--no-default-patterns	Eingebaute Ignoriermuster (node_modules, .git, Build-Verzeichnisse, usw.) nicht anwenden

Remote-Repository-Optionen

Option	Beschreibung
--remote <url>	Remote-Repository klonen und packen (GitHub-URL oder user/repo-Format)
--remote-branch <name>	Spezifischen Branch, Tag oder Commit verwenden (Standard: Standard-Branch des Repositories)
--remote-trust-config	Konfigurationsdateien aus Remote-Repositories vertrauen und laden. Eine vertrauenswürdige Konfiguration kann Befehle ausführen und lokale Dateien lesen, verwenden Sie diese Option daher nur für Repositories, denen Sie vollständig vertrauen (aus Sicherheitsgründen standardmäßig deaktiviert). Auf einem interaktiven Terminal wird die Konfiguration angezeigt und eine Bestätigung angefordert

Konfigurationsoptionen

Option	Beschreibung
-c, --config <path>	Benutzerdefinierte Konfigurationsdatei statt repomix.config.json verwenden
--init	Neue repomix.config.json-Datei mit Standardwerten erstellen
--global	Mit --init, Konfiguration im Home-Verzeichnis statt im aktuellen Verzeichnis erstellen

Sicherheitsoptionen

• --no-security-check: Scannen nach sensiblen Daten wie API-Schlüsseln und Passwörtern überspringen

Token-Anzahl-Optionen

• --token-count-encoding <encoding>: Tokenizer-Modell für Zählung: o200k_base (GPT-4o), cl100k_base (GPT-3.5/4), etc. (Standard: o200k_base)
• --token-budget <number>: Mit einem von Null verschiedenen Exit-Code fehlschlagen, wenn die gepackte Ausgabe N Token überschreitet. Nützlich als Schutz in CI-Pipelines und Agent-Workflows, um die Ausgabe innerhalb des Kontextfensters eines Zielmodells zu halten. Die Ausgabe wird trotzdem generiert; nur der Exit-Code signalisiert die Überschreitung.

MCP-Optionen

• --mcp: Als Model Context Protocol Server für AI-Tool-Integration ausführen
• --sandbox [dir]: (mit --mcp) Beschränkt die Datei-Tools des MCP-Servers auf ein Workspace-Verzeichnis (Standard: das Arbeitsverzeichnis; z.B. --sandbox path/to/project). Jeder Pfad ist relativ zu dieser Wurzel, absolute Pfade/Host-Pfade werden abgelehnt, und Remote-Packing, Skill-Generierung sowie das Anhängen externer Ausgaben sind deaktiviert. Siehe MCP-Server.

Agent Skills Generierungsoptionen

Option	Beschreibung
--skill-generate [name]	Claude Agent Skills Format-Ausgabe ins Verzeichnis .claude/skills/<name>/ generieren (Name wird automatisch generiert, wenn weggelassen)
--skill-project-name <name>	Den in generierten Skills-Beschreibungen verwendeten Projektnamen überschreiben
--skill-output <path>	Skill-Ausgabeverzeichnis direkt angeben (überspringt die Standortauswahl)
-f, --force	Alle Bestätigungsaufforderungen überspringen (Skill-Verzeichnis überschreiben, Vertrauen in Remote-Konfiguration)

Watch-Modus-Optionen

• -w, --watch: Auf Dateiänderungen achten und automatisch neu packen. Neue, geänderte und gelöschte Dateien werden erkannt, schnell aufeinanderfolgende Änderungen werden entprellt (300 ms), und nach jedem Neuaufbau wird ein Zeitstempel ausgegeben. Mit Ctrl+C beenden.

Der Watch-Modus funktioniert nur mit lokalen Verzeichnissen und kann daher nicht mit --remote, einer als Positionsargument übergebenen Remote-Repository-URL, --stdout, --stdin, --split-output, --skill-generate oder --copy kombiniert werden. Diese Einschränkungen gelten unabhängig davon, ob die Option über die Befehlszeile oder in Ihrer Konfigurationsdatei gesetzt wird.

Verwandte Ressourcen

• Konfiguration - Optionen in der Konfigurationsdatei statt CLI-Flags setzen
• Ausgabeformate - Details zu XML, Markdown, JSON und Klartext
• Code-Komprimierung - Wie --compress mit Tree-sitter funktioniert
• Sicherheit - Was --no-security-check deaktiviert

Beispiele

# Grundlegende Nutzung
repomix

# Benutzerdefinierte Ausgabedatei und Format
repomix -o my-output.xml --style xml

# Ausgabe an stdout
repomix --stdout > custom-output.txt

# Ausgabe an stdout, dann an anderen Befehl weiterleiten (z.B. simonw/llm)
repomix --stdout | llm "Bitte erklären Sie, was dieser Code macht."

# Benutzerdefinierte Ausgabe mit Komprimierung
repomix --compress

# Spezifische Dateien mit Mustern verarbeiten
repomix --include "src/**/*.ts,*.md" --ignore "*.test.js,docs/**"

# Remote-Repository mit Branch
repomix --remote https://github.com/user/repo/tree/main

# Remote-Repository mit Commit
repomix --remote https://github.com/user/repo/commit/836abcd7335137228ad77feb28655d85712680f1

# Remote-Repository mit Kurzform
repomix --remote user/repo

# Remote-Repository mit Kurzform (automatisch erkannt, kein --remote nötig)
repomix user/repo

# Dateiliste mit stdin
find src -name "*.ts" -type f | repomix --stdin
git ls-files "*.js" | repomix --stdin
echo -e "src/index.ts\nsrc/utils.ts" | repomix --stdin

# Git-Integration
repomix --include-diffs  # Git-Diffs für ungespeicherte Änderungen einschließen
repomix --include-logs   # Git-Logs einschließen (standardmäßig die letzten 50 Commits)
repomix --include-logs --include-logs-count 10  # Letzten 10 Commits einschließen
repomix --include-diffs --include-logs  # Sowohl Diffs als auch Logs einschließen

# Token-Anzahl-Analyse
repomix --token-count-tree
repomix --token-count-tree 1000  # Nur Dateien/Verzeichnisse mit 1000+ Tokens anzeigen

# Watch-Modus: bei Dateiänderungen automatisch neu packen
repomix --watch
repomix -w --include "src/**/*.ts"