repomix

Repomix スキル

Repomix はリポジトリ全体を、AI が扱いやすい単一のファイルにまとめます。Claude、ChatGPT、Gemini などの LLM にコードベースを渡すのに最適です。

使用する場面

次の場合に使用します：

• AI による分析のためにコードベースをパッケージ化する
• LLM のコンテキスト用にリポジトリのスナップショットを作成する
• サードパーティライブラリを分析する
• セキュリティ監査に備える
• ドキュメント生成用のコンテキストを作成する
• 大規模なコードベース全体にまたがるバグを調査する
• AI が扱いやすいコード表現を作成する

クイックスタート

インストールの確認

repomix --version

インストール

# npm
npm install -g repomix

# Homebrew (macOS/Linux)
brew install repomix

基本的な使い方

# Package current directory (generates repomix-output.xml)
repomix

# Specify output format
repomix --style markdown
repomix --style json

# Package remote repository
npx repomix --remote owner/repo

# Custom output with filters
repomix --include "src/**/*.ts" --remove-comments -o output.md

主な機能

リポジトリのパッケージ化

• 明確な区切りを備えた、AI に最適化された形式
• 複数の出力形式：XML、Markdown、JSON、プレーンテキスト
• Git を考慮した処理（.gitignore を尊重）
• LLM のコンテキスト管理のためのトークン数カウント
• 機密情報を対象としたセキュリティチェック

リモートリポジトリのサポート

クローンせずにリモートリポジトリを処理します：

# Shorthand
npx repomix --remote yamadashy/repomix

# Full URL
npx repomix --remote https://github.com/owner/repo

# Specific commit
npx repomix --remote https://github.com/owner/repo/commit/hash

コメントの削除

サポート対象言語（HTML、CSS、JavaScript、TypeScript、Vue、Svelte、Python、PHP、Ruby、C、C#、Java、Go、Rust、Swift、Kotlin、Dart、Shell、YAML）からコメントを削除します：

repomix --remove-comments

一般的な使用例

コードレビューの準備

# Package feature branch for AI review
repomix --include "src/**/*.ts" --remove-comments -o review.md --style markdown

セキュリティ監査

# Package third-party library
npx repomix --remote vendor/library --style xml -o audit.xml

ドキュメントの生成

# Package with docs and code
repomix --include "src/**,docs/**,*.md" --style markdown -o context.md

バグの調査

# Package specific modules
repomix --include "src/auth/**,src/api/**" -o debug-context.xml

実装計画

# Full codebase context
repomix --remove-comments --copy

コマンドラインリファレンス

ファイルの選択

# Include specific patterns
repomix --include "src/**/*.ts,*.md"

# Ignore additional patterns
repomix -i "tests/**,*.test.js"

# Disable .gitignore rules
repomix --no-gitignore

出力オプション

# Output format
repomix --style markdown  # or xml, json, plain

# Output file path
repomix -o output.md

# Remove comments
repomix --remove-comments

# Copy to clipboard
repomix --copy

設定

# Use custom config file
repomix -c custom-config.json

# Initialize new config
repomix --init  # creates repomix.config.json

トークン管理

Repomix は、個々のファイル、リポジトリ全体、形式ごとの出力について、トークン数を自動的にカウントします。

一般的な LLM のコンテキスト上限：

• Claude Sonnet 4.5：約200Kトークン
• GPT-4：約128Kトークン
• GPT-3.5：約16Kトークン

セキュリティに関する考慮事項

Repomix は Secretlint を使用して、機密データ（API キー、パスワード、認証情報、秘密鍵、AWS シークレット）を検出します。

ベストプラクティス：

1. 共有する前に、必ず出力を確認してください
2. 機密ファイルには .repomixignore を使用してください
3. 詳細不明のコードベースではセキュリティチェックを有効にしてください
4. .env ファイルのパッケージ化は避けてください
5. ハードコードされた認証情報がないか確認してください

必要に応じてセキュリティチェックを無効にします：

repomix --no-security-check

実装ワークフロー

ユーザーからリポジトリのパッケージ化を依頼された場合：

1. 要件の確認

   • 対象のリポジトリ（ローカル／リモート）を特定する
   • 必要な出力形式を確認する
   • 機密データに関する懸念事項を確認する

2. フィルターの設定

   • 関連ファイルの include パターンを設定する
   • 不要なファイルの ignore パターンを追加する
   • コメント削除を有効または無効にする

3. パッケージ化の実行

   • 適切なオプションを指定して repomix を実行する
   • トークン数を監視する
   • セキュリティチェックの結果を確認する

4. 出力の検証

   • 生成されたファイルを確認する
   • 機密データが含まれていないことを確認する
   • 対象の LLM のトークン上限を確認する

5. コンテキストの提供

   • パッケージ化されたファイルをユーザーに提供する
   • トークン数の概要を含める
   • 警告や問題があれば伝える

リファレンスドキュメント

詳細については、以下を参照してください：

• 設定リファレンス - 設定ファイル、include／exclude パターン、出力形式、高度なオプション
• 使用パターン - AI 分析ワークフロー、セキュリティ監査の準備、ドキュメント生成、ライブラリ評価

追加リソース

• GitHub：https://github.com/yamadashy/repomix
• ドキュメント：https://repomix.com/guide/
• MCP サーバー：AI アシスタントとの連携に利用可能