Spine

repomap

AI エージェントのためのコードベースマップ：コードグラフ、検索、呼び出しパス、変更の影響範囲。API キーは不要です。

コードグラフ · ハイブリッド検索 · 呼び出しパス · 変更の影響範囲 · インタラクティブなグラフ UI。
単一の Rust バイナリ。ローカルで動作。API キーは不要。MIT。

npx -y @sylphx/repomap setup

ライブデモ · ドキュメント · クイックスタート · ツール · グラフ UI · ベンチマーク · 比較

_{excalidraw での実際の UI（687 ファイルを 0.5 秒未満でインデックス化）：検索、シンボルのコードと呼び出し元、そして変更の影響範囲を表示します。ブラウザーでお試しください。インストールは不要です。}

動作を確認する

任意のリポジトリで実行できます。これは repomap 自身のソース（v1.5.0、抜粋）での実際の出力です。pagerank を変更すると何が壊れるかを尋ねます。

$ npx -y @sylphx/repomap impact pagerank

# Impact (MEDIUM risk)
Changing: function pagerank (crates/repomap-core/src/graph.rs:639)
2 direct callers, 4 symbols affected in total across 6 files and 3 modules; 5 files importing the changed files; 1 test file to run.

## Direct callers (will break if the contract changes)
- method DbSchema.graph_json — crates/repomap-core/src/db.rs:1981
- function link — crates/repomap-core/src/graph.rs:122

## Indirect (depth 2)
- function assemble — crates/repomap-core/src/index.rs:700

ローカルでの呼び出し 1 回、API キー不要、そしてエージェントが file:line 形式で引用できる回答が得られます。

クイックスタート

npx -y @sylphx/repomap setup     # add repomap to Claude Code, Codex, Cursor, VS Code, Claude Desktop, Windsurf, Gemini CLI
npx -y @sylphx/repomap serve     # open the graph UI for the current repo

クライアントを 1 つ手動で設定しますか？Claude Code では claude mcp add repomap -- npx -y @sylphx/repomap mcp を実行してください。Cursor、VS Code、Codex、Docker 用の設定例もあります。

これだけです。--claude-hooks を追加すると、Claude Code の Grep と Glob も拡張できます。setup は利用中のクライアントを検出し、それぞれの MCP 設定を書き込み、変更内容をすべて表示します。再度実行しても、何も変更されません。あとはエージェントに 「repomap を使ってこのリポジトリをマップして」 と尋ねてください。

Cursor と VS Code にワンクリックでインストール

· VS Code にインストール

Node 18 以降が必要です。エディターでインストールを確認し、プロジェクトを開いてサーバーを有効にしてください。どちらのリンクもローカルで npx -y @sylphx/repomap mcp を実行します。API キーは必要ありません。

ターミナルから VS Code を使う場合：

code --add-mcp '{"name":"repomap","command":"npx","args":["-y","@sylphx/repomap","mcp"]}'

または、サーバーを .cursor/mcp.json に追加します：

{
  "mcpServers": {
    "repomap": {
      "command": "npx",
      "args": [
        "-y",
        "@sylphx/repomap",
        "mcp"
      ]
    }
  }
}

.vscode/mcp.json では、VS Code の servers 形式を使用します：

{
  "servers": {
    "repomap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sylphx/repomap",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "repomap": { "command": "npx", "args": ["-y", "@sylphx/repomap", "mcp"] }
  }
}

[mcp_servers.repomap]
command = "npx"
args = ["-y", "@sylphx/repomap", "mcp"]

{ "mcpServers": { "repomap": { "command": "docker", "args": ["run", "-i", "--rm", "-v", "/path/to/repo:/workspace:ro", "ghcr.io/sylphxai/repomap"] } } }

実証：SWE-bench Verified におけるファイルの特定

課題文を1回検索するだけで、SWE-bench Verified の課題の83.0%で、修正対象のすべてのファイルが上位10件に見つかります（semble：71.0%）。課題の解決ではなく、ファイルの検索性能です。

トレードオフ：semble の公開コード検索セットでは、NDCG@10 は 0.845 で、semble の 0.851 を下回ります。この評価では semble が優れています。あらゆるタスクで検索性能が高いという主張ではありません。測定済みの検索品質と制限事項。

エージェントは、ファイルの場所を把握するだけでも、grep、ls、ファイル全体の読み込みにコンテキストの大半を費やします。repomap は最初にマップを提示します。

• どこにありますか？ シンボル名、関数内の単語、コードの意味を照合し、一致した行も示すハイブリッド検索です。「失敗したリクエストはどこで再試行されますか」や parseConfig のように質問できます。
• これは何ですか？ 1 回の呼び出しで、シンボルのコード、呼び出し元と呼び出し箇所の行、呼び出し先、サブタイプ、到達するテストを取得できます。
• A から B へはどうつながっていますか？ 各段階に file:line の参照が付いた、最短の呼び出しパスを確認できます。
• これを変更すると何が壊れますか？ 直接および間接の呼び出し元、インポートしているファイル、影響を受けるモジュール、実行するテスト、リスクレベルを確認できます。コミット前に git diff を指定してください。
• このリポジトリはどのような構成ですか？ フォルダーだけでなく、実際の依存関係から特定したモジュール、中心的なファイル、最も使用されているシンボル、エントリポイントを確認できます。

これらはすべてローカルインデックスから取得します。tree-sitter による解析、解決済みのインポートおよび呼び出しグラフ、PageRank、Louvain コミュニティ、AST チャンクに対する BM25、小型の静的コード埋め込みモデル（33 MB。Hugging Face から一度ダウンロードすれば、その後はオフラインで動作）を使用します。マシンの外にデータが送られることはなく、API も呼び出されません。ネットワークリクエストはモデルのダウンロードのみです（スキップするには REPOMAP_EMBED=0 を設定します）。

エージェントが利用できる機能

それぞれ役割が明確な 6 つのツールです。

回答は簡潔なテキストで、file:line を示すため、トークンの消費を抑えられます。構造化出力を得るには format: "json" を渡してください。

> impact target=decode

# Impact (LOW risk)
Changing: function decode (src/auth/token.ts:14)
1 direct caller, 3 symbols affected in total across 3 files and 2 modules; 1 file importing the changed files; no tests reach this.

## Direct callers (will break if the contract changes)
- function verifyToken — src/auth/token.ts:8

## Indirect (depth 2)
- method SessionStore.refresh — src/auth/session.ts:5

## Indirect (depth 3)
- function handleRefresh — src/api/router.ts:6

## Importing files
- src/auth/session.ts

同じコマンドをターミナルでも使用できます：repomap map、repomap search "…"、repomap context X、repomap trace A B、repomap impact --changed、repomap db。

グラフ UI

npx -y @sylphx/repomap serve            # live, with code preview
npx -y @sylphx/repomap export           # repomap.html: one self-contained file you can publish

影響範囲。 ファイルを選択して i キーを押すと、そのファイルに依存するものが深さ別にハイライト表示され、クリックしてたどれるリストも表示されます。	コード。 シンボルをクリックすると、そのソース、呼び出し元、呼び出し先が表示されます。Open ↗ をクリックすると、エディターまたは GitHub に移動します。

• WebGL レンダリング（Sigma.js）により、数万件のファイルやエッジがあってもスムーズに動作します
• モジュールは実際の依存関係に基づいて色分け・クラスタリングされ、ファイルサイズは PageRank で示されます。テスト、サンプル、ドキュメントは控えめに表示され、ワンクリックで確認できます
• / でファイル、シンボル、コードを検索し、d で依存関係を表示し、f でビューに合わせて表示します
• モジュールをクリックするとフォーカスし、Shift を押しながらクリックすると非表示にできます。テスト、エッジ、ラベルも切り替えられます
• export を実行すると、ディープリンク（#path/to/file）とコミットに固定された GitHub リンクを含む HTML ファイルを 1 つ出力します。README、Wiki、設計レビューに適しています。

データベースマップ

npx -y @sylphx/repomap db                              # from migrations / Prisma / Drizzle / SQLAlchemy / Diesel / Django
npx -y @sylphx/repomap db --url-env DATABASE_URL       # live Postgres, MySQL or SQLite, read-only
npx -y @sylphx/repomap db users                        # one table: columns, indexes, who references it, where it is queried
npx -y @sylphx/repomap db --serve                      # the same graph UI, for tables and foreign keys

repomap はリポジトリからスキーマを読み込みます。SQL マイグレーション（適用順に読み込み、down マイグレーションはスキップ）、schema.prisma、Drizzle の pgTable／mysqlTable／sqliteTable、SQLAlchemy および Flask-SQLAlchemy のモデル、Diesel の table!、Django の models.py（フィールド、ForeignKey／ManyToManyField、Meta、暗黙的な結合テーブル）が対象です。稼働中のデータベースをイントロスペクションすることもできます。各テーブルは、そのテーブルをクエリするコードに紐づけられます。対象となるのは、raw SQL（FROM users）、Prisma（prisma.user.findMany）、Diesel（users::table）、Django（Post.objects…）、およびインポート元のファイルで使用されている ORM モデルやテーブルです。

稼働中のデータベースへの接続は、厳密に読み取り専用です。

• Postgres は、サーバーによる確認が必要な READ ONLY トランザクションを実行します。
• MySQL は START TRANSACTION READ ONLY トランザクションを実行します。
• SQLite は query_only を使用して読み取り専用で開きます。

読み取るのはカタログのメタデータのみで、テーブルの行は読み取りません。接続文字列は引数または環境変数から取得し、保存も表示もされません。エージェントは db MCP ツールを通じて同じデータを取得できます。URL 自体ではなく、url_env を渡してください。

エージェント対応度スコア

npx -y @sylphx/repomap score

このスコアは、リポジトリで AI エージェントがどれだけ作業しやすいかを 0〜100 で評価します。次の 8 項目を確認します。

• エージェントへの指示（AGENTS.md／CLAUDE.md とその有用性）
• 見つけやすいビルドおよびテスト用コマンド
• テストカバレッジ
• CI
• モジュール境界
• ファイルサイズ
• ドキュメント
• 型

基準に達していない各項目には、具体的な修正方法が示されます。最後に、README 用のバッジ行が出力されます。CI では --min 70 を使用してください。--update-readme README.md を実行すると、バッジが更新されます。

GitHub Action を使ってバッジを最新の状態に保てます。

# .github/workflows/agent-ready.yml
on: { push: { branches: [main] } }
permissions: { contents: write, pull-requests: write }
jobs:
  score:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: SylphxAI/repomap@v1
        with:
          update-readme: true   # opens or updates one PR with the fresh badge
          min-score: 0          # set e.g. 70 to fail below a bar

Claude Code フック

npx -y @sylphx/repomap setup --claude-hooks

これは任意で、再度実行しても安全です。setup --remove で削除できます。PreToolUse フックをインストールすると、Claude Code が Grep または Glob を実行するたびに、repomap がシンボルの定義場所、呼び出し元、および所属モジュールを追加します。応答は数十ミリ秒で、検索をブロックすることはありません。

repomap (code map) for this search:
- function `compose` defined at src/compose.ts:15 (module router); 3 callers: Hono.route (src/hono-base.ts:228), Hono.#dispatch (src/hono-base.ts:452), every (src/middleware/combine/index.ts:102)

言語

シンボル、呼び出し、インポート、継承の解析には tree-sitter を使用します。TypeScript、TSX、JavaScript、Python、Go、Rust、Java、Kotlin、Swift、C、C++、C#、Ruby、PHP。 検索対象には Markdown、YAML、TOML、JSON、SQL、シェル、Protobuf、GraphQL、HTML/CSS、Vue、Svelte、Scala なども含まれます。

モジュールはコアコード内からのみ検出されます。テスト、サンプル、ドキュメント、ベンチマークは別々に分類されるため、モジュールとして扱われたり、モジュールの範囲を曖昧にしたりすることはありません。

インポートの解決では、相対パス、@/ エイリアス、npm ワークスペースパッケージ、Python パッケージと相対インポート、Go モジュール、Rust の mod／use／ワークスペースクレート、Java／PHP の名前空間、C/C++ のインクルード、Ruby の require を理解します。.gitignore と .repomapignore の両方が尊重されます。

質問の意図を理解する検索

semble の公開コード検索ベンチマーク（63 リポジトリ、19 言語、1,251 件の質問）では、repomap の search は NDCG@10 で 0.845 を記録し、同じランナーでの semble の 0.851 に迫っています。repomap の以前のスコアは 0.851 でした。課題箇所の特定力を高めることで、このベンチマークでは約 0.006 の低下が生じています。大規模リポジトリに関する当社の 60 件の質問では、repomap は 0.846、semble は 0.799 ですが、VS Code では依然として semble が優位です。137M パラメーターの CodeRankEmbed モデルの公開スコアは 0.839、標準の BM25 は 0.673 です（引用値であり、再実行したものではありません）。

ファイルの特定（SWE-bench Verified の 500 件の課題で、課題文を使って search を 1 回実行）では、repomap は課題の 83.0% で修正対象のファイルすべてを上位 10 件に含めています（Acc@10。5 件では 74.8%、1 件では 48.8%）。これに対し、semble は 71.0% / 61.6% / 34.0% です。この変更以前の repomap のスコアは 62.2% / 51.8% / 23.6% でした。標準の BM25 は上位 10 件で 55.8%、埋め込みを無効にした repomap は 77.6% です。同じ実行環境でのインデックス作成／クエリの中央値は 1.682 秒 / 54.4 ms で、以前のバイナリの 1.686 秒 / 59.8 ms、semble の 12.813 秒 / 354.4 ms と比べて優れています。デフォルト値は、互いに重複しない 300 件のチューニング用分割データでのみ選定し、その後固定してから Verified の測定を 1 回実施しました。LocAgent などのエージェントシステムは、LLM を処理に含む別のサブセットでより高い数値を報告していますが、これらは引用値であり、再実行したものではありません。

GPU、ベクトルデータベース、API キーは不要です。33 MB の静的コードモデルが CPU 上で、BM25 やシンボル名とともに動作します。

高速

インデックスは並列に作成され、ファイルごとにキャッシュされるため、初回実行後は変更されたファイルだけが再解析されます。MCP サーバーはグラフをメモリ上に保持し、ファイルの変更時に更新します。

4 vCPU の GitHub ホスト型ランナーで測定しました（測定方法と全表）。

比較

LSP による正確なリファクタリング編集を求める場合は Serena を選んでください。repomap は、ベクトルデータベースや API キーを使わないセマンティック検索を含め、セットアップ不要でコードベースを理解し、ナビゲートするためのツールです。職場で利用できるライセンスも採用しています。検索品質は、ベンチマークに記載された公開ベンチマークで測定しています。

無料

repomap のすべての機能は、マルチリポジトリのワークスペース（--workspace）や、自分の CI での impact を含め、MIT ライセンスのもとで無料です。ライセンスキーも有料プランもありません。

CLI

repomap setup [--client cursor,codex] [--claude-hooks] [--dry-run] [--remove]
repomap serve [dir] [--port 7878] [--no-open]
repomap export [dir] [--out repomap.html] [--json]
repomap map [dir-to-focus] [-C root] [--tokens 1000] [--json]
repomap search <query> [--path src/] [--kind function] [--limit 10]
repomap context <target> [--code-lines 60]
repomap trace <from> [to] [--callers] [--depth 3]
repomap impact [targets…] [--changed] [--base main]
repomap db [table] [--url-env VAR | --url URL] [--serve | --out db.html] [--json]
repomap score [dir] [--json] [--min N] [--update-readme README.md [--insert]]
repomap index [dir] [--no-cache] [--json]
repomap mcp [--root dir]

macOS（arm64、x64）、Linux glibc（x64、arm64）、Windows x64 向けのバイナリは、npm のオプショナル依存関係として提供されています。また、各 GitHub リリースにも添付されています。ソースからインストールする場合：cargo install --git https://github.com/SylphxAI/repomap sylphx-repomap。

Spine、Locus、CodeRAG からの移行

@sylphx/spine、@sylphx/locus、@sylphx/coderag は @sylphx/repomap の薄いエイリアスで、以前のツール名も引き続き使用できます。名称の対応関係と切り替え方法については、移行ガイドをご覧ください。

貢献

cargo test --workspace          # engine + CLI tests
bun install && bun run build:ui # rebuild the UI bundle (ui/ -> crates/repomap/assets/)
cargo run -p sylphx-repomap -- serve .

Issue や PR を歓迎します。特に、新しい言語のサポートは大いに役立ちます。crates/repomap-core/src/lang.rs に文法とクエリを追加してください。

Sylphx のその他のプロジェクト

• anymd：PDF、Word、PowerPoint、Excel、EPUB、HTML、画像など、あらゆるファイルを AI エージェント向けの整った Markdown に変換します。
• lockdocs：ロックファイルから、正確なバージョンのライブラリドキュメントを取得します。ローカルで動作し、オフラインで使用でき、レート制限もありません。
• skills：Claude Code と Codex 向けの実戦で検証されたエージェントスキルを、1 つのコマンドでインストールできます。
• readme-mark：1 つの URL から、美しい README 画像（バナー、バッジ、アイコン、統計カード）を作成します。

Sylphx のその他のプロジェクト：https://sylphx.com/open-source

スター履歴

プライバシー

repomap はお使いのマシン上で動作します。インデックス作成、検索、すべてのクエリはコードをローカルで読み取り、外部には一切送信しません。repomap が行うネットワークリクエストは、初回の検索時に Hugging Face から埋め込みモデルを一度ダウンロードするだけです。コードは送信されません。これをスキップしてキーワード検索のみを使うには、REPOMAP_EMBED=0 を設定してください。repomap export のファイルに含まれるのはパス、シンボル名、行番号であり、ソースコードは含まれません。詳細な境界については、SECURITY.mdをご覧ください。

サポート

ご質問、バグの報告、チームへの導入については、[email protected] にメールするか、Issue を作成してください。

MIT ライセンス。© Sylphx Limited。イングランドおよびウェールズで登記、会社番号 16438428。登記上の事務所：128 City Road, London EC1V 2NX, United Kingdom。メール：[email protected]。プライバシー · 利用規約 · sylphx.com