cortex

Cortex

AI コーディングエージェントに、リポジトリから適切なコンテキストを提供します。

Cortex は、コード、シンボル、関係性、プロジェクトルールのローカルマップを作成します。コーディングエージェントは推測したりリポジトリ全体を読んだりする代わりに、CLI を通じてこのマップを検索します。

コードがマシンの外に出ることはありません。MCP は不要です。

はじめに

Node.js 20.9+ と Git が必要です。

npm install --global @danielblomma/cortex-mcp
cd your-project
cortex init --bootstrap

このコマンドはリポジトリをインデックス化し、AGENTS.md に Cortex の指示を追加して、Git フックをインストールし、バックグラウンドの監視プロセスを開始します。

セットアップを確認します。

cortex doctor

使い方

# Find relevant code.
cortex search "where is authentication handled?" --json

# Follow relationships from a search result.
cortex related <entity-id> --json

# See what a change may affect.
cortex impact "authentication" --json

# Read repository rules.
cortex rules --json

# Compare a changed file with nearby patterns.
cortex pattern-evidence src/auth.ts --json

# Inspect deterministic active conventions for a file or indexed entity.
cortex conventions src/payments/retry.ts --json

# Get cited, deterministic context before implementing a code task.
cortex guidance src/payments/retry.ts --task "add bounded retry handling" --json

# Review the staged, unstaged, and non-ignored untracked candidate against HEAD.
cortex review --diff --json

# Refresh context after significant changes.
cortex update

エージェントはこれらのコマンドを直接実行できます。cortex init は、回答する前に検索し、リファクタリングの前に影響を確認するよう指示を追加します。MCP 接続は必要ありません。

Cortex が提供するもの

Cortex がない場合、エージェントはファイル名で検索し、関連性のないファイルを多数読むことがよくあります。Cortex は、構造化されたリポジトリのコンテキストを提供します。

• コード、ルール、アーキテクチャ上の決定事項を横断するセマンティック検索；
• シンボルの定義とファイル間の関係；
• 呼び出し元と依存関係のたどり方；
• リファクタリング前の影響分析；
• 有効なルール、非推奨事項、信頼できる情報源を示すシグナル；
• 引用可能な再利用可能シンボルを含む、決定論的なサブシステム単位の規約プロファイル；
• Git とファイルシステムの変更後の増分更新。

パイプラインはローカルで動作し、シンプルです。

repository -> local index -> Cortex CLI -> coding agent

使用するコマンド

コマンド	目的
cortex search "..." --json	関連するコードとコンテキストを検索します
cortex related <entity-id> --json	検索結果から関係性をたどります
cortex impact "..." --json	変更の影響範囲を推定します
cortex rules --json	有効なリポジトリルールを表示します
cortex pattern-evidence <file> --json	近くにある実装パターンを検索します
cortex conventions <file-or-entity> --json	範囲を限定したリポジトリ規約プロファイルを確認します
cortex guidance <file-or-entity> --task <text> --json	引用付きで範囲を限定したコーディング前のガイダンスを取得します
cortex review --diff --json	引用付きのローカル証拠を用いて、現在の Git 候補をレビューします
cortex update	変更されたコンテキストを更新します
cortex status	インデックスの状態を表示します
cortex doctor	ローカル環境の問題を診断します
cortex watch status	バックグラウンド同期を確認します
cortex dashboard	ローカルステータスダッシュボードを開きます

コマンドの一覧については、cortex help を実行してください。

cortex conventions はローカルインデックスのみを使用します。ライブデータに基づく範囲を限定したバージョン 1 のプロファイルを返し、モデル、プランナー、プロバイダー、ネットワークサービスは呼び出しません。適用条件、上限、ハッシュ化、永続化、安全性に関する仕様については、リポジトリ規約プロファイルを参照してください。

コードタスクを実装する前に、cortex guidance をポリシーの権威ではなく、引用付きの補足コンテキストとして使用してください。必要に応じて通常の search、related、impact も引き続き使用し、明示的に有効なルールや競合を決して無視しないでください。このコマンドはローカルのみで動作し、確認専用です。バージョン管理された正確な仕様については、コーディング前のガイダンスを参照してください。

コーディング後、最終確定の前に cortex review --diff を使用してください。信頼できる情報源への違反と、ヒューリスティックによるローカルパターンの警告を分けて表示し、確認のみを行います。決定論的な差分レビューを参照してください。

インデックスを最新に保つ

通常、Git フックと監視プロセスが Cortex を自動的に更新します。

cortex status
cortex watch status
cortex update

大規模な変更の後や、検索結果が古いように見える場合は、cortex update を手動で実行してください。

大規模なリポジトリ

セマンティックインデックス化をバックグラウンドで続けながら、まず字句検索とグラフ検索を利用可能にします。

cortex bootstrap --background --profile interactive
cortex indexing status --json

このモードは macOS、Linux、WSL に対応しています。ネイティブの Windows では、通常のフォアグラウンドブートストラップを使用してください。

アップグレード

npm install --global @danielblomma/cortex-mcp@latest
cortex init --force
cortex bootstrap
cortex update

プロジェクトの設定とルールは保持されます。バージョンごとの注意事項については、 CHANGELOG.md をご覧ください。

任意の MCP 互換性

通常の Cortex ワークフローでは CLI を使用します。クライアントが MCP を明示的に必要とする場合は、 cortex connect を実行してください。

DeepSeek Harness との統合

Cortex は、V1 の明示的なツールとスキルの統合を通じて DeepSeek Harness をサポートしています。Cortex 2.6.0 には統合ソースが含まれており、固定された Harness 0.1.1-rc.2 リリースに対して検証されています。個別の npm バンドル配布は延期されており、現在は利用できません。

バンドルには、エージェント単位のツールが 4 つ（cortex_search、cortex_related、cortex_impact、cortex_rules）と、Cortex の動作スキルが 5 つ（change-impact、context-review、pattern-review、repo-research、using-cortex）含まれています。検索はローカルで、リポジトリの範囲内に限られ、明示的に実行され、ユーザーが制御します。この統合は、リポジトリの初期化、更新、監視を自動的には行いません。

V2 のプロアクティブ／支援型検索は、引き続き計画中の実験的な機能であり、Cortex 2.6.0 には含まれていません。詳細は V1-to-V2 integration plan をご覧ください。

リンク

• ウェブサイト
• 変更履歴
• 課題

ライセンス

MIT