m1nd

コーディングエージェントに検証可能な地図を

m1nd は、MCP コーディングエージェント向けのローカルコードグラフと、証拠にひも付いたメモリーです。 関連するコードを見つけ、変更の影響を調べ、検証済みの調査結果を次のセッションに引き継げます。回答には信頼性を示す情報と明示的な不足点が含まれるため、エージェントは追加で確認すべき内容を把握できます。

なじみのないリポジトリ、複数ファイルにまたがる変更、または繰り返し行われるエージェントセッションに取り組む開発者向けに作られています。既存の MCP ホストを使用できます。ランタイムは Rust で、ライセンスは MIT です。

使い始める · ワークフロー · 制限事項 · ドキュメント

エージェントに追加する理由

• まずリポジトリの構造を把握できます。 north は、タスクのコンテキスト、範囲を限定したソース抜粋、バインディングの信頼性、過去のメモリー、推奨される次のアクションをまとめます。seek は候補を見つけ、impact は編集前にその周辺を調べるのに役立ちます。
• 調査結果をコードにひも付けたままにできます。 memorize は、証拠のパスと出所情報を添えて主張を保存します。次のセッションでそれらを呼び出し、今も当てはまるか確認できます。
• エージェント間でコンテキストを共有できます。 サービスとして稼働するローカルオーナーは、接続されたクライアントと1つのグラフを共有できます。プレゼンスと重複に関する警告は、エージェントの連携に役立ちますが、あくまで参考情報であり、ロックではありません。
• 不確実性を把握できます。 reverify、abstain、insufficient_evidence は有用な結果です。グラフ上のつながりはコードを調べる理由であって、変更が安全である証明ではありません。

グラフとメモリーはお使いのマシン上に保存されます。グラフへのクエリに LLM API キーは必要ありません。インストール、更新、任意のモデルのダウンロード、ネットワークを介するドキュメントプロバイダーでは、ネットワークを使用したり、設定済みのエンドポイントにドキュメントを送信したりする場合があります。MCP ホストには独自のデータポリシーがあります。

使い始める

バージョンが重要です： GitHub／ネイティブ版 1.6.5、crates.io パッケージ、npm 1.6.5 は、不変のコミット 363bc97f2336c73e90802916804dccd2109c5746 から公開されています。2026-10-12 時点で npm の latest は 1.6.5 です。PR580 でマージされた学習イベントの分離は、ソースのパッケージバージョンが引き続き 1.6.5 と表示されていても、未リリースです。

公開済みの 1.6.5：最初の結果を得る

Node.js 18 以降と、読み取り可能なリポジトリが必要です。署名済みのネイティブ版 1.6.5 アーティファクトをインストールしてから、リポジトリ内で次の POSIX シェルの手順を実行します：

export M1ND_BINARY="$HOME/.local/share/m1nd/versions/1.6.5/m1nd-mcp"
"$M1ND_BINARY" --version
# Require native 1.6.5 at 363bc97f2336c73e90802916804dccd2109c5746.
(
  unset M1ND_RUNTIME_DIR M1ND_MCP_ARGS
  npx -y @maxkle1nz/[email protected] agent first-minute --repo . \
    --binary "$M1ND_BINARY" --query "where is configuration loaded?" --json
)

first-minute は、まず対象をカバーするサービス稼働中のオーナーを探します。該当するオーナーが見つからない場合、一致するラッパー／ネイティブランタイムが、ランチャーから許可された正確なリポジトリのみを外部のプライベートキャッシュ内に準備します。ソースファイルは入力として扱われます。自動分離キャッシュを再利用する場合に限り、CLI は取得の前に宣言済みのルートを更新します。接続されたオーナーの鮮度は、そのオーナー独自のセマンティクスに従います。選択されたクライアントバイナリから推測せず、オーナーのバージョン、リポジトリのバインディング、鮮度を確認してください。runtime.boot、返されたソース位置、不足点を確認してください。これは、共有ブレインの作成、バインディングの移動、汎用の ingest 呼び出しを許可するものではありません。

MCP ホストを接続するには、1.6.5 クイックスタートに従ってください。stdio を直接利用するには、明示的なワークスペースの許可と、既存の外部プライベートランタイムが必要です。共有オーナーには別途、準備と権限の要件があります。エージェントの自律性を参照してください。

過去の固定バージョン 1.6.3：インストール、準備、接続

Node.js 18 以降、MCP ホスト、リポジトリが必要です。まず、署名済みのネイティブ 1.6.3 アーティファクトをインストールしてください。このガイドでは cosign と正確なリリース URL を使用します。ビルド済みの 1.6.3 リリースは、Linux x86_64 と macOS x86_64／ARM64 に対応しています。使用するリポジトリから、以下の POSIX シェルの手順を実行してください。ラッパーのバージョンは意図的に固定されています。

# After the signed installation guide, select the exact native binary.
export M1ND_BINARY="$HOME/.local/share/m1nd/versions/1.6.3/m1nd-mcp"
"$M1ND_BINARY" --version

# Confirm this binary reports native 1.6.3 before continuing.
# Bind the human ceremony and host to the same explicit repository runtime.
export M1ND_RUNTIME_DIR="$(pwd -P)/.m1nd"
# Run this yourself in a terminal, once for an empty runtime.
npx -y @maxkle1nz/[email protected] init --birth . --binary "$M1ND_BINARY"

# Preview your host configuration before applying it.
npx -y @maxkle1nz/[email protected] hosts plan --host claude --project . --binary "$M1ND_BINARY"
npx -y @maxkle1nz/[email protected] hosts apply --host claude --project . --binary "$M1ND_BINARY" --yes

claude を、codex や cursor などのホストに置き換えてください。表示される手順に従ってください。一部のホスト管理対象の設定やフックは、自動的に書き込まれるのではなく、インストール用に表示されます。設定を変更した後は、ホストを再起動するか、再接続してください。ホストごとの動作については、ホスト統合マトリックスを参照してください。

再接続する前に、echo "$M1ND_RUNTIME_DIR" で表示されるものと同じ絶対パスを、生成された MCP サーバー環境に M1ND_RUNTIME_DIR として追加してください。生成された M1ND_WORKSPACE_ROOT はそのままにしてください。hosts apply はランタイムセレクターを追加しません。これを設定しないと、別の場所から起動したホストが異なるグラフを開く可能性があります。

この手順はネイティブ 1.6.3 を対象としています。npm ラッパーだけを固定しても、update apply は固定されません。このコマンドはレジストリのチャンネルに従うため、ここでは意図的に対象外としています。選択したバイナリが別のバージョンを報告する場合は、続行する前にそのリリースのセットアップ要件を確認してください。作成コマンドは人間がターミナルで実行する手順であり、エージェントがツール呼び出しで実行するものではありません。実行結果には、brain: "owner_bound_graph"、意図した born_root、store_dir 内の正確なランタイム、および node_count > 0 が含まれている必要があります。拒否された場合は、別のランタイムを置き換えたり ingest を強制したりせず、診断に従ってください。ソースからビルドする場合は、以下の別のコントリビューター向け手順を使用してください。

最初に役立つ結果を得る

接続したエージェントに次のように依頼してください。

m1nd を使って、このリポジトリの概要を把握してください。設定が読み込まれる場所を見つけ、関連するソースの場所を示し、さらに確認が必要な点を教えてください。ファイルは編集しないでください。

エージェントはまず north を呼び出し、必要に応じて seek とソースの調査を行います。成功とは、回答が正しいリポジトリを対象としており、実際に開けるコードを示していることです。 現在のキャリブレーション封じ込めの下では、reverify の判定が想定されます。根拠を確認してください。グラフがない場合やワークスペースへのバインドが誤っている場合は復旧が必要です。結果が空の場合は、別のクエリが必要かもしれません。

クイックスタートのトラブルシューティングでは、バイナリが見つからない場合、ホスト設定、バインドエラーを扱います。最初のクエリでは、実際の MCP 呼び出しを紹介しています。

未リリースの main：学習イベントの分離

未リリースの学習修正をテストするコントリビューターは、PR580 を明示的に含む main のリビジョンを選択し、それに対応するラッパーとネイティブランタイムを使用してください。バージョン文字列だけでは、修正が含まれていることは確認できません。--binary は CLI が使用する実行ファイルを選択しますが、デフォルトの検出では、より古い対象範囲のオーナーに接続されることがあります。正確にこのリビジョンを自動分離キャッシュで実行するには、--no-attach を使用し、環境内のランタイム／アタッチ上書きをクリアしてください。

git clone https://github.com/maxkle1nz/m1nd.git
cd m1nd
git checkout --detach 74d0348c9a5a1e0d5d5e5b5a784ee4f3771d0808
cargo build --release -p m1nd-mcp
./target/release/m1nd-mcp --version
(
  unset M1ND_RUNTIME_DIR M1ND_MCP_ARGS M1ND_ATTACH_URL
  node npm/bin/m1nd.js agent first-minute --repo /absolute/path/to/your/repo \
    --binary ./target/release/m1nd-mcp --no-attach --query "map this repo" --json
)

PR580 の学習セマンティクスは main で利用できますが、シール済みの 1.6.5 アーティファクトには含まれていません。自動分離準備はすでに 1.6.5 でリリースされており、PR580 のプレビュー機能ではありません。ランチャーの仕様を参照してください。コントリビューター開発キットでは、開発用にチェックアウト内にプライベートな状態を用意できます。

次に試すこと

タスク	まず試すこと	実行前に確認すること
見慣れないコードを理解する	north → seek → surgical_context	返されたソースを開き、ワークスペースのバインディングと信頼エンベロープを確認します。
複数ファイルにまたがる変更を計画する	返されたノードに対して impact と why を実行します	呼び出し元とインポートをソース／コンパイラのツールで確認します。未解決のエッジは情報の不足を示します。
調査を再開する	north、boot_memory、または trail_resume	主張を再利用する前に、根拠、作成者、経過時間、古い情報を示すフラグがないか確認します。
検証済みの知見を保存する	リポジトリ相対の根拠パスを指定して memorize	エージェントが未検証のまま導き出した結論ではなく、実際に検証した内容を保存します。
複数のエージェントを調整する	サーブされたオーナーを1つ用意し、クライアントを接続します	重複に関する通知は調整を求めるものであり、編集を禁止するものではありません。

実例、ユースケース、ツールリファレンスを参照してください。デフォルトのツールメニューは意図的に小さくしています。help で完全なレジストリを確認できます。M1ND_TOOL_TIER=full を設定すると、表示されるメニューが拡張されます。公開済みの 1.6.5 では、コア機能にセッション内でのみ使えるスナップショットツール5つを加えた M1ND_TOOL_TIER=investigate も利用できます。初心者向けおよび上級者向けレシピを参照してください。1.6.5 のグラフ連携検索では、単一ファイルの取り込みルートに対して正規ノード ID が保持されます。曖昧なファイルマッピングは除外されます。ツールが一覧に表示されていたり呼び出せたりしても、現在のセッションにない権限が必要な場合があります。

この機能が証明すること、しないこと

• 最適な用途： 構造的なナビゲーション、変更の準備、繰り返し行う作業の継続性です。小さな編集や正確な文字列の検索であれば、ファイルの読み込みや rg で十分な場合があります。
• 抽出は概算です。 言語のサポート状況は異なり、マクロ生成や動的な参照を検出できない場合があり、外部インポートが未解決のまま残ることもあります。グラフはコンパイラのセマンティックモデルではありません。
• 信頼性には条件があります。 公開済みの 1.6.5 と現在の main は、v1 のすべてのキャリブレーション行を未認定の根拠として扱います。予測は保留され、seek エンベロープは reverify または unprovable のままですが、スコアとランキングは引き続き利用できます。キャリブレーションを実行しても act は有効になりません。変更にはソース、コンパイラ、テスト、ランタイムのチェックを使用してください。クロック修正によって統計的な品質が確立されるわけではありません。
• 未リリースの学習フィードバックは関連性の調整に限られます。 PR580 適用後の main では、内部の learn(correct|wrong) がグラフの関連性の重みを調整します。欠陥、誤警報、観測された同時変更、自動抗体は記録しません。曖昧な partial フィードバックは変更を加えずに拒否され、強度がゼロの場合は何も行いません。この変更は、封印済みの 1.6.5 には含まれていません。パブリックな学習権限とキャリブレーション権限の最低基準は引き続きブロックされています。イベント境界を参照してください。
• 書き込みには追加の境界があります。 プレビュー／コミットツール、証明許可、権限チェックは、読み取り専用の取得とは別の仕組みです。グラフや静的解析による検証は、テストの実行の代わりにはなりません。書き込みリファレンスを参照してください。
• ローカルであることは認証済みであることを意味しません。 サーブされたオーナーは、ループバック以外へのバインドを拒否します。ループバックだけでは、他のローカルプロセスを認証できません。デプロイとセキュリティを参照してください。
• 高度な機能はセットアップの前提条件ではありません。 ドキュメントアダプター、構造的ヒューリスティクス、トランスプラント、ミッション、ハードウェアに裏付けられた権限には、それぞれ独自の制限があります。PRD は設計意図を記述したものであり、リリースがあらゆる経路をサポートしていることの根拠にはなりません。

共有コンテキスト、ローカルの所有者は 1 つ

リポジトリのランタイムを準備したら、そのレシートに記載された正確な store_dir（以下では /absolute/path/to/project/.m1nd）を使って所有者を 1 つ起動し、クライアントを接続します。

export M1ND_BINARY="$HOME/.local/share/m1nd/versions/1.6.3/m1nd-mcp"
"$M1ND_BINARY" --serve --no-gui --port 1337 --runtime-dir /absolute/path/to/project/.m1nd
# Run each client from the repository it should query:
"$M1ND_BINARY" --attach auto --stdio

所有者がグラフを保持します。接続されたクライアントが別のコピーを読み込んだり、書き込みリースを取得したりすることはありません。自動検出では、呼び出し元のリポジトリをすでにカバーしている所有者を見つける必要があります。新しい共有ブレインの作成を許可するものではありません。稼働中の所有者はウェブ UI も表示できます。複数のリポジトリや永続的な起動を設定する前に、デプロイメントに従ってください。

確認できるエビデンス

根拠のない速度やコスト削減の主張より、再現方法とその適用範囲を優先してください。

• ベンチマークの方法論とWiki のエビデンスガイドでは、合成エンジンの計測値、過去のコーパスでの実行結果、エンドツーエンドの製品計測値を区別しています。これらは一般的な ROI を保証するものではありません。
• 永続化の統合テストでは、正常な起動と中断された実行を通じて、実際の stdio プロセスをテストします。
• エージェント自律性テストと契約では、ソースコードが実装する自動起動、ID、シャットダウンの各経路を正確に説明しています。
• テストポートフォリオでは、範囲を限定した PR ゲートと完全な統合テストマトリックスについて説明しています。現在のソースコードの変更が、公開済みのリリースに自動的に反映されるわけではありません。

以下のデモは m1nd-mcp 1.4.0 の過去の録画であり、現在のインストール手順やパフォーマンスを保証するものではありません。

言語対応

専用エクストラクターは 20 を超える言語に対応しています。Python や TypeScript から Elixir、Haskell、Zig までを対象とし、m1nd-ingest でファイル拡張子に基づいて振り分けます。この表は、複数言語を含む取り込みでテストした呼び出しエッジとファイル間インポートの抽出状況を示しています。完全な解決やコンパイラー相当の解決を保証するものではありません。修飾された Rust の呼び出し、マクロ、動的参照は精度が低下する場合があります。

言語	calls	ファイル間インポート
Rust	✅	✅
Python	✅	✅
JavaScript / TypeScript	✅	✅
Go	✅	✅
Java	✅	✅
C / C++	✅	✅
Kotlin	✅	✅
PHP	✅	✅
Scala	✅	✅
Ruby	⏳	✅
C#	✅	名前空間とファイルは 1 対 1 で対応しません
Swift	✅	未対応

解決できないインポート（外部パッケージ、標準ライブラリ、システムヘッダー）は推測せず、未解決のままにします。それ以外はすべて、contains エッジのみを扱う汎用エクストラクターにフォールバックします。

アーキテクチャと詳細ドキュメント

Cargo ワークスペースは 6 つのクレートで構成されています。m1nd-core（グラフエンジン）、m1nd-ingest（抽出）、m1nd-mcp（MCP の所有者とランタイム）、m1nd-control、m1nd-runnerd（実行レーン）、m1nd-openclaw（ブリッジ）です。ウェブ UI と npm ラッパーは Rust ワークスペースの外にあります。

• ドキュメントのインデックス：タスクを選んでから、ガイドを選んでください
• Wiki：チュートリアル、概念、API リファレンス
• エージェントのインストールガイド：コーディングエージェント向けのセットアップ手順
• 変更履歴：リリース履歴
• コントリビューション：開発と検証

翻訳

ポルトガル語 · スペイン語 · イタリア語 · フランス語 · ドイツ語 · 中国語 · 日本語

翻訳はこの英語版の改訂に合わせて更新されていないため、セットアップ方法や機能に関する古い記述が含まれている場合があります。最新の手順については、この英語版 README を参照してください。

ライセンス

MIT。グラフはコードから派生したものです。メモリーファイルはディスク上に残ります。LICENSEを参照してください。