npmを使用してインストール
features: - icon: 🤖 title: AI最適化 details: コードベースをAIが理解・処理しやすい形式にフォーマット
Overview
🏆 オープンソースアワードノミネート
光栄です！RepomixがJSNation Open Source Awards 2025のPowered by AIカテゴリにノミネートされました。
これは皆様がRepomixを使用し、サポートしてくださったおかげです。ありがとうございます！
Repomixとは？
Repomixは、コードベース全体を単一のAIフレンドリーなファイルにパッケージ化する強力なツールです。コードレビュー、リファクタリング、プロジェクトに関するAIアシスタンスが必要な場合に、リポジトリ全体のコンテキストをAIツールと簡単に共有できます。
クイックスタート
Repomixを使用すると、コードベース全体を1ファイル（repomix-output.xml）にできます。
そのまま ChatGPT や Claude などのAIアシスタントに次のようなプロンプトと一緒に送ると、
このファイルはコードベース内のファイルを1つにまとめたものです。
コードのリファクタリングを行いたいので、まずはコードレビューをお願いします。
全体の内容を理解した上で、リファクタリングなどを進めることができます。
具体的な内容を提案すると、それに従って良い感じのコードを生成してくれます。Claude だと Artifacts 機能で複数のファイルが出力できるため、依存関係にある複数のコードも一緒に生成できます。
良いコーディング体験を！🚀
なぜRepomixか？
Repomixの強みは、ChatGPT、Claude、Gemini、Grokなどのお好きなサブスクリプションサービスで料金を気にせずに使えることです。また、コード全体を知っていることで、コードの調査などを行う上でファイルの探索が不要でより早く、時には正確に結果を得ることができます。
コードベース全体がコンテキストとして利用できることで、実装方針の相談、バグの調査、サードパーティライブラリのセキュリティのチェック、ドキュメントの生成など、あらゆることに使えます。
CLIの使用方法 {#using-the-cli-tool}
Repomixは強力な機能とカスタマイズオプションを提供するコマンドラインツールとして使用できます。
CLIツールはプライベートリポジトリにアクセスできます。これはローカルにインストールされたgitを使用するためです。
クイックスタート
任意のディレクトリで以下のコマンドを実行すると、 repomix-output.xml が生成され、それ以降の使い方は同様です。
npx repomix@latest
または、グローバルにインストールして繰り返し使用することもできます。
# npmを使用してインストール
npm install -g repomix
# または、yarnを使用
yarn global add repomix
# または、bunを使用
bun add -g repomix
# または、Homebrewを使用（macOS/Linux）
brew install repomix
# その後、任意のプロジェクトディレクトリで実行
repomix
CLIの使用方法
カレントディレクトリ全体をまとめる。
repomix
特定のディレクトリをまとめる。
repomix path/to/directory
glob パターンを使用して特定のファイルやディレクトリを指定。
repomix --include "src/**/*.ts,**/*.md"
特定のファイルやディレクトリを除外。
repomix --ignore "**/*.log,tmp/"
リモートリポジトリをまとめる。
# ショートハンド形式を使用
npx repomix --remote yamadashy/repomix
# 完全なURL（ブランチや特定のパスをサポート）
npx repomix --remote https://github.com/yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix/tree/main
# コミットのURLを使用
npx repomix --remote https://github.com/yamadashy/repomix/commit/836abcd7335137228ad77feb28655d85712680f1
設定ファイル（repomix.config.json）の初期化
repomix --init
生成されたファイルは、Claude、ChatGPT、Geminiなどの生成AIツールで使用できます。
Docker使用方法 🐳
Dockerを使用してRepomixを実行することも可能で、分離された環境でRepomixを実行したい場合に便利です。
基本的な使用方法
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix
特定のディレクトリをまとめる
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory
リモートリポジトリを処理し、outputディレクトリに出力
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix
出力フォーマット
出力フォーマットは4種類あり、xml, markdown, json, plain を選択できます。
LLMによっては得意・不得意があるので、適切なフォーマットを選択してください。
# XMLフォーマット（デフォルト）
repomix --style xml
# Markdownフォーマット
repomix --style markdown
# JSONフォーマット
repomix --style json
# プレーンテキストフォーマット
repomix --style plain
カスタマイズ
フォルダごとの永続的な設定のためにrepomix --initでrepomix.config.jsonを作成できます。
{
"output": {
"style": "markdown",
"filePath": "custom-output.md",
"removeComments": true,
"showLineNumbers": true,
"topFilesLength": 10
},
"ignore": {
"customPatterns": ["*.test.ts", "docs/**"]
}
}
実際の活用事例
LLMコード生成ワークフロー
開発者がRepomixを使用して既存のコードベースからコードコンテキストを抽出し、ClaudeやAiderなどのLLMを活用してインクリメンタルな改善、コードレビュー、自動ドキュメント生成を行う方法を共有しています。
LLM向け知識データパックの作成
著者たちはRepomixを使用して、ブログ、ドキュメント、書籍などの執筆コンテンツをLLM互換フォーマットにパッケージ化し、読者がAI駆動のQ&Aシステムを通じて専門知識と対話できるようにしています。
パワーユーザーガイド
Repomixは高度な用途向けの強力な機能を提供します。パワーユーザー向けの重要なガイドをご紹介します：
- MCPサーバー - AIアシスタント向けModel Context Protocol統合
- GitHub Actions - CI/CDワークフローでのコードベース自動パッケージング
- コード圧縮 - Tree-sitterベースのインテリジェント圧縮（約70%のトークン削減）
- ライブラリとして使用 - Node.jsアプリケーションへのRepomix統合
- カスタム指示 - 出力にカスタムプロンプトと指示を追加
- セキュリティ機能 - 組み込みSecretlint統合と安全性チェック
- ベストプラクティス - 実証済みの戦略でAIワークフローを最適化
その他の例
::: tip もっと詳しく知りたい場合は？ 💡 詳しい使い方はガイドをご覧ください。コード例やソースコードはGitHubリポジトリで確認できます。 :::
</div>