FAQ und Fehlerbehebung

Diese Seite hilft bei der Wahl des passenden Repomix-Workflows, beim Reduzieren großer Ausgaben und beim Vorbereiten von Codebasis-Kontext für KI-Assistenten.

Häufige Fragen

Wofür wird Repomix verwendet?

Repomix packt ein Repository in eine einzige KI-freundliche Datei. So können Sie ChatGPT, Claude, Gemini oder anderen Assistenten vollständigen Codebasis-Kontext für Code-Reviews, Fehlersuche, Refactoring, Dokumentation und Onboarding geben.

Funktioniert Repomix mit privaten Repositories?

Ja. Führen Sie Repomix lokal in einem Checkout aus, auf den Ihr Rechner bereits Zugriff hat:

repomix

Prüfen Sie die erzeugte Datei, bevor Sie sie an einen externen KI-Dienst weitergeben.

Kann Repomix öffentliche GitHub-Repositories ohne Klonen verarbeiten?

Ja. Verwenden Sie --remote mit Kurzform oder vollständiger URL:

npx repomix --remote yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix

Welches Ausgabeformat sollte ich wählen?

Nutzen Sie standardmäßig XML. Verwenden Sie Markdown für gut lesbare Gespräche, JSON für Automatisierung und Plain Text für maximale Kompatibilität. Sie können das Format mit --style ändern:

repomix --style markdown
repomix --style json

Siehe Ausgabeformate.

Token-Verbrauch reduzieren

Die erzeugte Datei ist zu groß. Was tun?

Grenzen Sie den Kontext ein:

repomix --include "src/**/*.ts,docs/**/*.md"
repomix --ignore "**/*.test.ts,dist/**"
repomix --compress
repomix --remove-comments

Kombinieren Sie Include- und Ignore-Muster mit Code-Komprimierung, wenn das Repository groß ist.

Was macht --compress?

--compress erhält wichtige Struktur wie Imports, Exports, Klassen, Funktionen und Interfaces, entfernt aber viele Implementierungsdetails. Das ist hilfreich, wenn ein Modell vor allem Architektur und Zusammenhänge verstehen soll.

Sicherheit und Datenschutz

Lädt die CLI meinen Code hoch?

Die Repomix-CLI läuft lokal und schreibt eine Ausgabedatei auf Ihrem Rechner. Website- und Browser-Erweiterungs-Workflows unterscheiden sich; lesen Sie dafür die Datenschutzerklärung.

Wie schützt Repomix vor Secrets?

Repomix nutzt Secretlint-basierte Sicherheitsprüfungen. Betrachten Sie diese als zusätzliche Schutzschicht und prüfen Sie die Ausgabe trotzdem selbst.

Fehlerbehebung

Warum fehlen Dateien in der Ausgabe?

Repomix respektiert .gitignore, Standard-Ignore-Regeln und eigene Ignore-Muster. Prüfen Sie repomix.config.json, --ignore und Ihre Git-Ignore-Regeln.

Wie mache ich die Ausgabe im Team reproduzierbar?

Erstellen und committen Sie eine gemeinsame Konfiguration:

repomix --init

Zusätzliche häufige Fragen

Funktioniert Repomix mit C#, Python, Java, Go, Rust oder anderen Sprachen?

Ja. Repomix liest die Dateien Ihres Projekts und formatiert sie für KI-Tools, daher kann es Repositories in jeder Programmiersprache packen. Für die CLI benötigen Sie Node.js 20 oder neuer. Einige erweiterte Funktionen, etwa Tree-sitter-basierte Code-Komprimierung, hängen von der Parser-Unterstützung der jeweiligen Sprache ab.

Kann ich Repomix mit Hermes Agent, OpenClaw oder anderen MCP-kompatiblen Agenten verwenden?

Ja. Repomix kann als MCP-Server laufen:

npx -y repomix --mcp

Für Hermes Agent fügen Sie Repomix als stdio-MCP-Server in ~/.hermes/config.yaml hinzu:

mcp_servers:
  repomix:
    command: "npx"
    args: ["-y", "repomix", "--mcp"]

Für OpenClaw oder andere MCP-kompatible Agenten verwenden Sie denselben Befehl und dieselben Argumente dort, wo der Agent externe stdio-MCP-Server konfiguriert. Wenn Ihr Assistent Agent Skills unterstützt, können Sie auch den Repomix Explorer Skill verwenden.

Wie helfe ich einem KI-Assistenten, eine neue Library oder ein Framework zu verstehen?

Packen Sie das Library-Repository oder seine Dokumentation und geben Sie die Ausgabe dem KI-Assistenten als Referenzmaterial:

npx repomix --remote owner/repo
npx repomix --remote owner/repo --include "docs/**,src/**"

Für wiederholte Nutzung können Sie daraus wiederverwendbare Agent Skills erzeugen:

npx repomix --remote owner/repo --skill-generate library-reference

Wie schließe ich CSS, Tests, Build-Ausgaben oder andere Stördateien aus?

Für einzelne Befehle verwenden Sie --ignore:

repomix --ignore "**/*.css,**/*.test.ts,dist/**,coverage/**"

Wenn nur bestimmte Quell- oder Dokumentationspfade bleiben sollen, verwenden Sie --include:

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

Gibt es ein Größenlimit für Repositories?

Die CLI hat kein festes Repository-Größenlimit, aber sehr große Repositories können durch Speicher, Dateigröße oder Upload- und Kontextlimits des KI-Tools begrenzt werden. Grenzen Sie große Projekte mit Include-Mustern ein, prüfen Sie tokenreiche Dateien und teilen Sie die Ausgabe bei Bedarf auf:

repomix --token-count-tree 1000
repomix --split-output 1mb

Warum enthält --include keine Dateien aus node_modules, Build-Verzeichnissen oder ignorierten Pfaden?

--include grenzt die Dateien ein, die Repomix packen soll, aber Ignore-Regeln gelten weiterhin. Dateien können durch .gitignore, .ignore, .repomixignore, integrierte Standardmuster oder repomix.config.json ausgeschlossen werden. Für spezielle Fälle können Optionen wie --no-gitignore oder --no-default-patterns helfen, sie können aber auch Abhängigkeiten, Build-Artefakte und andere Stördateien einschließen.

Weitere Ressourcen

• Grundlegende Verwendung
• Kommandozeilenoptionen
• Code-Komprimierung
• Sicherheit