MoDKH(Mixture of DKH)は、Common Lispで専門エージェントを定義し、コードの調査・編集・検証を委譲できるコーディングハーネスです。
Node.js(対応バージョン)とnpmを用意し、リポジトリのルートで実行します。
npm ci
npm run build
archive=$(npm pack --silent)
npm install -g "./$archive"作業するプロジェクトで、初回起動前に言語サーバーを導入します。
modkh language install
modkh初回起動後、/connect で接続先とモデルを選びます。
モデルやツールの応答を待っている間は、入力欄の空きにアニメーションが走ります。/annimation off で非表示にし、/annimation on で戻せます。切り替えは起動中のみ有効です。最初から非表示にするには MODKH_NO_ANIMATION=1 modkh で起動してください。待機メッセージと経過時間は引き続き表示されます。
agenticreplay version が成功する環境では、AgenticReplay がモデル API の通信をワークスペースの .agenticreplay/runs/ に記録します。Ollama や LM Studio などの HTTP モデル API も対象です。HTTPS は AgenticReplay の既定ホストと、起動時に --base-url で指定したホストを記録します。記録を止めて起動するには MODKH_AGENTICREPLAY=0 modkh を使います。
.git があるワークスペースでは、起動時に .gitignore の末尾へ .modkh/ と .agenticreplay/ を追加します。どちらも modkh がワークスペースへ書く実行記録で、プロジェクトの成果物ではありません。既存の行は書き換えず、既に書かれていれば何も追加しません。.git が無いディレクトリは変更せず、ワークスペース外を指すシンボリックリンクの .gitignore も書き換えません(その場合は起動時に一度だけ理由を表示します)。
通常の modkh で言語別のマイクロエージェントを使えます。複数言語をまたぐ依頼では、親モデルが調査を担当ごとに分けて委譲し、返ってきた結果をまとめます。/agents で利用できる担当を確認できます。
画像対応モデルに接続すると、PDFの仕様書や画面見本を使って実装を依頼できます。PDFの読み込みとページ指定
/pdf docs/画面仕様.pdf | 見本の配色と余白に合わせて設定画面を実装して
/pdf --pages 5-7 docs/画面仕様.pdf | この3ページの入力項目と検証条件を実装して
/pdf ~/Downloads/仕様書.pdf のようにルート外のPDFを明示すると、追加確認なしで選んだページの本文と画像をモデルに送信します。ルート内のパスがシンボリックリンク経由でルート外を指す場合は、送信前に確認します。ファイルが見つからない場合、似た名前があればエラーに候補を表示します。
プロジェクトのルートで modkh を起動すると、通常のチャットで次の stdio サーバーを使えます。Svelte と Laravel Boost は検出時に起動し、最初の依頼を待たずに接続します。どちらも MoDKH 自身が決めた固定の起動コマンドを作業ルートで実行するため、permissions の既定値 workspace でも起動時の確認は出ません。permissions を none にすると、この接続も含めて毎回確認します。接続中のサーバーはサイドバーに表示され、チャット終了時に切断します。
| プロジェクト | 検出条件 | 利用時のコマンド |
|---|---|---|
| Svelte / SvelteKit | package.json の依存関係に svelte または @sveltejs/kit があるか、svelte.config.js / .ts がある |
npx -y @sveltejs/mcp(初回はダウンロードする場合があります) |
| Laravel Boost | artisan があり、composer.json に laravel/boost があるか boost.json がある |
php artisan boost:mcp(Boost の導入が必要です) |
ほかの stdio サーバーも、ルートの .mcp.json に登録できます。たとえば次の設定は、自動検出した laravel-boost の起動方法を上書きします。
{"mcpServers":{"laravel-boost":{"command":"php","args":["artisan","boost:mcp"]}}}チャットで「Svelte の公式ドキュメントで確認して」「Boost でルートを調べて」のように依頼してください。モデルは mcp_list_tools で引数の形式を調べ、mcp_call_tool で呼び出します。各操作にはコマンドの承認設定が適用され、自動接続済みなら同じ接続を再利用します。独自の起動コマンドを指定したサーバーは、従来どおり操作時にだけ接続します。設定を変えたら modkh を起動し直してください。HTTP / SSE 接続は対象外です。
- 前鬼(Stateright) は、有限状態モデルを探索し、守るべき条件が破られる手順を探します。
- 後鬼(Lean) は、指定した定理の証明を検査し、その定理が期待した命題と一致するかを確かめます。
Rust/Cargoを導入してから実行します。
modkh stateright install
modkh stateright status
modkh導入済みなら、通常起動で前鬼(modkh-micro-zenki)を自動登録します。親モデルは状態遷移・競合・不変条件の検証を前鬼に委譲します。/agents で確認できます。MoDKHを更新した際も modkh stateright install で検証器を更新できます。
検証対象は明示的な有限状態JSONモデルです。モデルの書き方・導入先・制約を参照してください。
browse を使うと、Chrome・Braveなどでページ表示、入力・クリック、スクリーンショット取得を行えます。PATH に実行可能な browse があれば、MoDKH は専用の browse ツールを登録します。接続状態の確認、HTTP(S) ページを開く、スナップショットの取得、クリック、フォーム入力は都度の許可なしで実行します。任意のスクリプトや管理コマンドには、従来どおり run_command の承認設定が適用されます。
npm install -g @opencode/browse
browse install --agent none
browse status --json案内に従ってブラウザ拡張を導入・接続し、ブラウザを開いた状態で使います。--agent none は他のエージェントへのMCP登録を省く指定です。status の extension.connected が true なら接続済みです。paired-offline の場合は、拡張を導入したプロファイルを開き、拡張が有効か確認してください。
MoDKHの専用 browse ツールで開いたタブとポップアップは、応答の完了・エラー・中断時に自動で閉じます。既存のタブは閉じません。終了を確認できなかった場合は対象のグループ名を表示し、セッション終了時にも再確認します。
run_command から直接 browse CLIを使う場合は自動終了の対象外です。開いたタブのIDを控え、作業後に browse tabs close --tab <id> で閉じてください。操作方法は browse --help で確認できます。