リポジトリをまるっとAIに食わせるRepomixの話

下記イベントの登壇資料です。
#さくらのAI Meetup vol.9「AIコーディングエージェント活用」

https://sakura-tokyo.connpass.com/event/346616/

GitHubなどのコードリポジトリを1つのファイルにまとめてAIに解析させる「Repomix」の概要と使い方を解説した資料です。

.gitignoreに従ったファイル収集やSecretlintによるセキュアなファイルの除外機能、XML/Markdown/テキストなど複数の出力形式に対応した特徴を紹介しています。

開発背景や実際の使用例、Tree-sitterを活用したコード圧縮機能による最適化、他のAIコーディングツールとの使い分けについても触れており、AIを活用したコード分析や修正の効率化に関心のあるエンジニア向けの内容となっています。

Transcript

1. リポジトリをまるっと AIに食わせる Repomixの話 @yamadashy さくらのAI Meetup vol.9「AIコーディングエージェント活用」
2. 私 やまだし @yamadashy • これまで作ったもの ◦ 企業テックブログRSS ◦ Slack Channels Grouping ◦ Repomix ◦ …etc • 仕事ではPHPer • 年一でフルorハーフマラソン 2
3. 今日話すこと • Repomixの概要 • RepomixとClaudeを組み合わせたコーディング体験 • ※ かなりエンジニア向けの話です 3
4. APIのコスト、気になりませんか？ 4 クレジットが足りない
5. 去年のある日 • 開発にCline（当時はClaude-dev）やAiderなどを使っていた • APIの料金が常に心配 ◦ 昼飯代相当が飛んでいく 💸 ◦ 今は資本で殴るべきタイミングなのはわかってはいるが... ▪ Clineが違う方向に向かってしまいresetするときの、あの切なさ 5
6. 去年のある日 ケチってClaudeのWeb版に1ファイルずつ貼り付ける日々... 6
7. 去年のある日 ケチってClaudeのWeb版に1ファイルずつ貼り付ける日々... 「全部1ファイルにしたらいい感じに読み込んでくれるのでは？」 7
8. 去年のある日 ケチってClaudeのWeb版に1ファイルずつ貼り付ける日々... 「全部1ファイルにしたらいい感じに読み込んでくれるのでは？」 思いのほかうまくいった 8
9. 作ったもの（ Repomix） コードベースをLLM向けに1ファイルにまとめるCLIツール • .gitignore に従う • Secretlint でセキュアなファイルを除外 超シンプル！ 9
10. 使い方 1. npx repomix を実行 2. repomix-output.xml ができる 3. pbcopy などでファイルをコピー 10
11. 使い方 1. Claudeに貼り付け 2. 指示を出す 11 <プロンプト例> このファイルはリポジトリのファ イルを1つにしたものです。 コードのリファクタをしたいので まずコードを確認してください。
12. 使い方 具体的な提案をすると、それに 従って良い感じのコード(artifact)を 生成してくれます。 出力をコピーしてコードに 貼り付けます。 12
13. 日本で使ってる方はまだ少なそうだが 使用者の声（翻訳） 13
14. Q. Cline, Cursor で良くないか？ A. 要件によって使い分けるのが良いと思います。 そもそもRepomixはエージェントではないので比べるものではありません。 Cursor, Cline, Claude Code など多くのAIコーディング支援の選択肢がある中で、 一概にどれが良いかで語らずに、要件次第で使い分けるのが良いと思います。 14
15. エージェントと比べた Repomixの使い所 • インプットを選ばない • 体感だが、すべてのコードを知っているだけあって分析力は◎ ◦ バグの特定が早い（これも体感） • Cline における Plan として使える 15
16. ClineにおけるPlanとして使う 16 結果の精度は変わらないが、ファイルを読み込まずに判断できる点で多少早い
17. Repomixの道のり 17
18. Repomixの道のり • Qiitaに投稿しても全く伸びなかった • 公開してから気づく、あまりにも多い競合 • code2prompt, files-to-prompt, 1filellm, ai-digest, ingest, repo2file, … • Redditに似たものを投稿すると少し皮肉られる • 「アイデアは10000人、実現は100人、継続は1人」 な時代は終わり 18 Repomixの50番目の 味（亜種）へようこそ
19. Redditでの活動 • 「良いものを作れば広まる」は幻想なので地道に布教活動 • Redditのスレで困ってそうな方に積極的なアウトリーチ ◦ 少しずつ共感者を増やす => 勝手に紹介してくれる 19 1つにパックするツールを作り ました！ これをClaudeに読み込ませれ ばコード修正が効率的になる 可能性があります！
20. Redditでの活動 • 一歩間違うとスパムだが、かなり効果的 ◦ 日本では記事かXでバズる、口コミで広まるぐらいしかない ◦ 自分で広まる機会を増やせるRedditはおすすめしたい ▪ 節度は重要 20
22. そして、改名 • 元の名前は「Repopack」 • 海外から商標問題の指摘 • 妻に雑談していたら10分後には弁理士への相談予約していた • 学び ◦ ドメインやGitHubのプロジェクトは調べておくこと ◦ 権利関係で困ったらひとまず日本弁理士会の無料相談へ 22
23. 23 そして... ミームコインが勝手に作られ始める（スター数が多いレポの宿命らしい）
24. 技術面とデモ 24
25. CLI • .gitignore に従う • Secretlint でセキュアなファイルを除外 • configファイルで細かく設定可能 • 複数フォーマット: XML, Markdown, テキスト ◦ XMLはAnthropicが推奨 • Git履歴に基づく優先度ソート ◦ LLMは後半の内容が出力に反映されやすい (参考) • コード圧縮機能 ◦ Tree-sitter でコードの一部を抽出 • MCP 25
26. ウェブサイト • フロントエンド： Vitepress + Cloudflare Pages ◦ 無料プランでも十分な機能 ◦ デプロイが早く、開発効率が良い ◦ PRごとにプレビューURLを自動生成 • バックエンド： Hono.js + Cloud Run ◦ シンプルな実装でAPI構築が容易 ◦ gitコマンド実行が必要なのでCloud Run採用 ◦ CloudflareのDNSでオリジン保護 26
27. Tree-sitter によるコード抽出 • --compress : 実装の詳細を省いた状態にする • import • Interface, Type • クラス • コメント • メソッドの定義（実装を省く） 27
29. Tree-sitter によるコード抽出 • 大体半分のサイズに • 使い所 ◦ ドキュメントが整備されていないライブラリの使い方を聞く ◦ ライブラリのアーキテクチャ理解 29 リポジトリ そのまま compress cline/cline 450 K 208 K vuejs/core 1.3 M 0.6 M facebook/react 5.7 M 2.9 M yamadashy/repomix 240 K 14 K
30. Tree-sitter 自体を試してみたい方 • こんなクエリを書くとタグ付け(@)したものをキャプチャとして抽出できる • Tree-sitterを試してみたい方の参考資料 ◦ laiso さん： Tree-sitterを使ってコードベースから関数定義を抽出する ◦ Aider： Building a better repository map with tree sitter ◦ Cline： src/services/tree-sitter/ 30
31. MCP対応 以下の機能を持つ • コードをまとめる ◦ ローカル ◦ リモート • Read-OnlyなFS ◦ Secretlint付き （まだおもちゃです） 31
32. デモ • Claude Web版 • Claude DesktopでのMCP • 他のモデル ◦ ChatGPT o3-mini-high ◦ Gemini 2.0 Pro Experimental 32
33. モデルごとの個人的な使い分け • Claude 3.7/3.5 Sonnet ◦ コーディング。基本はこれ一択 ◦ ただし、制限があるので他のモデルも併用 • ChatGPT o3-mini-high ◦ コミュニティのやりとり • Gemini 2.0 Pro Experimental (Google AI Studio) ◦ 無料かつコンテキスト長2Mトークンを活かした分析と雑用 33
34. 最後に小ネタ Cline/Cursor などにやらせると楽シリーズ • リリースノートの作成 ◦ の結果を貼り付けて書いてもらう ◦ .clinerules に「ghでPR, Issuesの詳細を確認して書いて」と書く • ドキュメントの多言語翻訳 ◦ 細かい精度は未検証だが、英語→日本語 はAI感はありつつ悪くない • lint / 静的解析の修正 ◦ Biome, ESLint はうまくいく ◦ PHPStanの修正はまだ人間の役目らしい 34
35. おわりに • Repomixのこれから ◦ 大規模プロジェクトへの対応 ▪ ClineやCursorに任せつつ、できるだけのことはする ▪ 例：特定ファイルの依存関係のみを取得 ◦ 他ツールとの連携部分の強化（MCPなど） ◦ マネタイズ...！ 35 @yamadashy