FAQとトラブルシューティング
このページでは、Repomixの使い分け、出力サイズの削減、AIアシスタントに渡すコードベースコンテキストの準備について、よくある質問に答えます。
よくある質問
Repomixは何に使いますか？
Repomixはリポジトリを1つのAIフレンドリーなファイルにまとめます。ChatGPT、Claude、Geminiなどにコードベース全体の文脈を渡し、コードレビュー、バグ調査、リファクタリング、ドキュメント作成、オンボーディングに使えます。
プライベートリポジトリでも使えますか？
はい。ローカルでアクセスできるチェックアウト内でRepomixを実行します。
repomix外部のAIサービスに渡す前に、生成されたファイルを必ず確認してください。
クローンせずに公開GitHubリポジトリを処理できますか？
はい。--remote に短縮形式または完全なURLを指定します。
npx repomix --remote yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomixどの出力形式を選べばよいですか？
迷ったらデフォルトのXMLを使ってください。読みやすさを重視する会話ではMarkdown、自動処理ではJSON、最大限の互換性が必要な場合はプレーンテキストが向いています。
repomix --style markdown
repomix --style json詳しくは出力フォーマットを参照してください。
トークン使用量の削減
生成ファイルが大きすぎます。どうすればよいですか？
対象範囲を絞ります。
repomix --include "src/**/*.ts,docs/**/*.md"
repomix --ignore "**/*.test.ts,dist/**"
repomix --compress
repomix --remove-comments大きなリポジトリでは、include/ignoreパターンとコード圧縮を組み合わせるのが有効です。
--compress は何をしますか？
--compress はimport、export、クラス、関数、インターフェースなどの重要な構造を残しつつ、多くの実装詳細を省きます。モデルにアーキテクチャや全体像を理解させたい場合に便利です。
セキュリティとプライバシー
CLIはコードをアップロードしますか？
Repomix CLIはローカルで実行され、出力ファイルを手元のマシンに書き込みます。Webサイトやブラウザ拡張の挙動は異なるため、プライバシーポリシーを確認してください。
シークレット混入はどう防ぎますか？
RepomixはSecretlintベースの安全チェックを使います。ただし補助的な防御として考え、出力内容は必ず自分で確認してください。
トラブルシューティング
出力にファイルが含まれません。
Repomixは.gitignore、既定のignoreルール、カスタムignoreパターンを尊重します。repomix.config.json、--ignore、gitのignore設定を確認してください。
チームで同じ出力を再現するには？
共有設定を作成してコミットします。
repomix --init追加のよくある質問
RepomixはC#、Python、Java、Go、Rustなどのリポジトリでも使えますか？
はい。Repomixはプロジェクト内のファイルを読み取り、AIツール向けに整形するため、任意のプログラミング言語のリポジトリをパックできます。CLIの実行にはNode.js 20以降が必要です。一部の高度な機能、たとえばTree-sitterベースのコード圧縮は、言語パーサーの対応状況によって結果が異なる場合があります。
Hermes Agent、OpenClaw、その他のMCP対応エージェントで使えますか？
はい。RepomixはMCPサーバーとして実行できます。
npx -y repomix --mcpHermes Agentでは ~/.hermes/config.yaml にstdio MCPサーバーとして追加できます。
mcp_servers:
repomix:
command: "npx"
args: ["-y", "repomix", "--mcp"]OpenClawなどのMCP対応エージェントでは、外部stdio MCPサーバーを設定できる箇所で同じcommand/argsを使います。Agent Skills形式に対応している場合は、Repomix Explorer Skillも利用できます。
新しいライブラリやフレームワークをAIアシスタントに理解させるには？
ライブラリのリポジトリやドキュメントをRepomixでパックし、その出力を参照資料としてAIに渡します。
npx repomix --remote owner/repo
npx repomix --remote owner/repo --include "docs/**,src/**"繰り返し使う場合は、再利用可能なAgent Skillsとして生成することもできます。
npx repomix --remote owner/repo --skill-generate library-referenceCSS、テスト、ビルド出力などのノイズを除外するには？
一度だけ指定する場合は --ignore を使います。
repomix --ignore "**/*.css,**/*.test.ts,dist/**,coverage/**"特定のソースやドキュメントだけ残したい場合は --include を使います。
repomix --include "src/**/*.ts,docs/**/*.md"リポジトリサイズに制限はありますか？
CLIには固定のリポジトリサイズ制限はありませんが、大きなリポジトリではメモリ、ファイルサイズ、AIツールのアップロード制限やコンテキスト制限に影響されます。大規模プロジェクトでは対象パターンを絞り、トークンの大きいファイルを確認し、必要なら出力を分割してください。
repomix --token-count-tree 1000
repomix --split-output 1mb--include しても node_modules やignore対象のパスが含まれないのはなぜですか？
--include はパック対象を絞り込みますが、ignoreルールは引き続き適用されます。.gitignore、.ignore、.repomixignore、組み込みのデフォルトパターン、repomix.config.json によって除外される場合があります。必要な場合は --no-gitignore や --no-default-patterns を検討できますが、依存関係やビルド成果物まで含まれやすくなるため注意してください。