dotrepo

dotrepo

リポジトリの目的、ビルド・テストコマンド、ドキュメント、オーナーを確認できます。

dotrepo は、参照ツールチェーンと公開インデックスを備えたオープンなリポジトリメタデータプロトコルです。エージェントやツールに、MCP 経由またはローカルの .repo ファイルから、これらの情報を JSON として提供します。各レコードには情報源と信頼性のコンテキストが含まれているため、回答を利用するか、上流を確認するかを判断できます。

試してみる：ripgrep の概要を把握する

インストールやリポジトリのクローンを行わずに、インデックス済みのプロファイルを取得します。

curl -sS https://dotrepo.org/v0/repos/github.com/BurntSushi/ripgrep/profile.json

レスポンスには、目的、実行、ドキュメント、所有者の情報がまとめられています。タスクで必要なフィールドとともに、record.generatedAt、record.freshnessStatus、競合を確認してください。freshness.generatedAt はエクスポートの日時であり、情報源の事実の日時ではありません。回答がない、古い、または競合している場合は、上流を確認する必要があります。返されたコマンドは確認対象のデータであり、実行許可ではありません。

エージェントを接続する

Rust ツールチェーンを使って安定版の MCP サーバーをインストールするか、 安定版リリースバンドルを使用してください。

cargo install dotrepo-mcp --version 1.0.3 --locked

mcpServers 設定を使用するクライアントの場合：

{
  "mcpServers": {
    "dotrepo": { "command": "dotrepo-mcp", "args": [] }
  }
}

次の引数を指定して dotrepo.lookup を呼び出すよう、クライアントに依頼してください。

{
  "repositoryUrl": "https://github.com/BurntSushi/ripgrep",
  "path": "repo.test"
}

CLI、LSP、VS Code 拡張機能についてはインストールガイドを、フォールバックルールと実行可能なクライアントについてはコンシューマー統合ガイドを参照してください。

バージョンは重要です： 安定版リリースは v1.0.3 です。このブランチは公開済みのプレリリース 2.0.0-rc.1 です。安定版には、上限付きコマンド抽出の修正、昇格時の書き込み防止ガード、レスポンスサイズの上限が含まれています。新しいフィールド証拠スキーマ、実行コンテキスト、追加の MCP ターゲットチェックは main に残っています。 バージョン比較と安定版ドキュメントを参照してください。

利用できること

• リポジトリの概要把握： 調査するソースファイルを決める前に、目的、ドキュメント、オーナー、報告されたコマンドを確認できます
• エージェント統合： 最初に検索し、信頼性と情報の古さを保持したうえで、回答がタスクのニーズを満たさない場合は上流にフォールバックできます
• メンテナーメタデータ： ネイティブの .repo ファイルと、サポートされているドキュメントブロックを、検証や生成された領域のチェックと整合させられます
• リポジトリの検出： 公開 APIを通じて、事実に基づくプロファイルを検索・比較し、リポジトリ間の関係をたどれます

インデックス化されたオーバーレイは公開ソース資料から生成されるため、リポジトリがインデックスに表示されるために、メンテナーが dotrepo を採用する必要はありません。ネイティブの .repo を使えば、メンテナーが管理できます。通常の生成レコードは機械的にチェックされますが、verified は人によるレビュー済みであることや、すべてのフィールドが正しいことを意味しません。

リポジトリにレコードを追加する

リリースバンドルから安定版 CLI をインストールするか、 cargo install dotrepo-cli --version 1.0.3 --locked を実行してから、次のようにします。

# Start from existing README.md, CODEOWNERS, and SECURITY.md:
dotrepo --root <repo> import
# Review the generated .repo, then:
dotrepo --root <repo> validate
dotrepo --root <repo> query repo.build --raw
dotrepo --root <repo> trust
dotrepo --root <repo> generate --check

空のひな形から始めるには、import ではなく init を使用してください。 安定版メンテナーガイドでは導入手順を説明しています。同期の境界では、dotrepo が管理できるファイルと領域について説明しています。

制限事項と根拠

• メタデータは全体像の把握に役立ちます。アーキテクチャの調査、適合性の判断、デバッグ、コード変更には、引き続きソースの確認が必要です
• 網羅性、正確性、完全性、新しさはそれぞれ別のものです。verified とマークされていても、記録が不完全、古い、または誤っている場合があります。保持されたフィールドレベルの根拠を確認できるのは、生成時のバージョンとクロールで保存された場合に限られます。信頼モデルを参照してください
• 測定ページでは、フィールドの存在状況とモデル化されたリクエスト数を報告しています。これらは、正確性やエンドツーエンドで測定したエージェントの節約量を示すものではありません
• 直接比較ベンチマークでは、GitHub API と README を基準にした勝敗を記録しています。そこで使われている例の修正は回帰の根拠にはなりますが、一般化できることの証明にはなりません
• 独立した利用者による継続的な採用は、依然として未達成の成功基準です。リポジトリ内のクライアントや AI インタビューだけでは、外部の需要を裏付けられません

次に読む

• ドキュメントの案内とリリース互換性
• MCP ツール、検証範囲、バージョンの境界を含むツールチェーンとプロトコルのリファレンス
• ホスト型 API の例、公開アーキテクチャ、および自プロジェクトでの調査とその後のパイロット
• 信頼モデルと権限ルール
• ロードマップ、コントリビューション、インデックスの運用

実装に取り組む場合は、ロードマップの作業項目とチーム実行ガイドから始めてください。リポジトリのガイダンスが契約を定め、生成されたレポートと日付入りのアーカイブが成果の根拠を記録します。

リポジトリの Python ツールでは uv を使用します。uv venv、uv sync --dev --locked を実行してから、スクリプトとテストを uv run 経由で実行してください。