consult-opencode

consult-opencode

シェルコマンドを実行できる任意のコーディングエージェント（または人間）から、自己完結型のタスクをワンショットのサブエージェントとして opencode に委任できます。または、より直接的に、MCP を通じて AI チャットクライアント内から利用できます。

公式 MCP Registry に io.github.jayden99236/consult-opencode として掲載されています。各 リリースには、Claude Desktop やその他の MCPB 対応クライアント向けのワンクリック .mcpb バンドルが添付されています。

デモ

概要

セッションを通じて高価な、あるいは主要なコーディングエージェント（Claude、GPT など）を使っている場合、小さく自己完結したタスク（ファイルの要約、正規表現の作成、定型テストの記述、セカンドオピニオンの取得など）に、そのエージェントのターンを使うのは無駄になりがちです。opencode には opencode/ プロバイダー名前空間で無料枠のモデルが用意されており、設定は不要で、API キーも必要ありません。このリポジトリでは、次の 2 つの方法で利用できます。

• MCP サーバー（mcp-server.mjs）— 最も簡単な方法です。AI チャットクライアントの設定に一度追加すれば、モデルにネイティブの consult_opencode ツールが追加され、シェルコマンドを実行する必要はありません。以下の直接統合を参照してください。
• CLI スクリプト（consult-opencode.mjs）— 依存関係がなく、シェルコマンドしか実行できないエージェントやスクリプト向けです。また、ターミナルから自分で呼び出すこともできます。

どちらも lib.mjs の同じコアロジックを使用します。

要件

• Node.js >= 18
• opencode がインストールされ、PATH に設定されていること：

  npm install -g opencode-ai
  

CLI スクリプト自体（consult-opencode.mjs + lib.mjs）には、Node 組み込み機能以外の依存関係はありません。MCP サーバーにはさらに @modelcontextprotocol/sdk と zod が必要です。これらを入手するには、このリポジトリで npm install を実行してください（下記参照）。

直接統合（MCP サーバー）

MCP は、AI チャットクライアントがシェルコマンドなどを実行せずにネイティブツールを利用できるようにする標準的な方法です。設定すると、モデルからは直接呼び出せる consult_opencode ツールが見えるようになります。

git clone https://github.com/jayden99236/consult-opencode.git
cd consult-opencode
npm install

Claude Desktop

claude_desktop_config.json に追加してください（場所はこちら）：

{
  "mcpServers": {
    "consult-opencode": {
      "command": "node",
      "args": ["/absolute/path/to/consult-opencode/mcp-server.mjs"]
    }
  }
}

Claude Desktop を再起動すると、利用可能なツールとして consult_opencode が表示されます。

Claude Code

claude mcp add consult-opencode -- node /absolute/path/to/consult-opencode/mcp-server.mjs

または、上記と同じ mcpServers ブロックを使って、プロジェクトの .mcp.json に直接追加してください。

その他の MCP クライアント（Cursor、Windsurf など）

MCP 対応クライアントでは、いずれもコマンド（node）と引数（mcp-server.mjs の絶対パス）を指定し、stdio サーバーとして設定する同じ形式を使います。この設定の場所はクライアントのドキュメントで確認してください。上記の mcpServers エントリーは、そのままどこでも使えます。

このツールは必須の task と任意の model（デフォルトは opencode/big-pickle。opencode の無料枠）を受け取り、サブエージェントの応答をテキストで返します。

CLI の使い方

node consult-opencode.mjs "Summarize what this function does: ..."

または、グローバルにインストールして consult-opencode コマンドを使えるようにします：

npm install -g .
consult-opencode "Write a regex for US zip codes"

引数として渡す代わりに、タスクをパイプで渡すこともできます：

cat some-file.js | consult-opencode "Explain what this file does"

オプション

フラグ	説明
--model <provider/model>	使用するモデル（デフォルト：opencode/big-pickle。opencode の無料枠）。opencode で別のプロバイダーの認証を済ませた後（opencode providers login）、たとえば --model anthropic/claude-haiku-4-5 のように指定できます。
--json	プレーンテキストの代わりに { model, text, cost } を JSON として出力します。
-h、--help	使い方を表示します。

別のエージェントから

ほとんどのコーディングエージェントでは、これをシェルコマンドとして実行し、標準出力を読み取るだけで済みます。

node /path/to/consult-opencode.mjs "task description here"

失敗時は終了コードが 0 以外になり、エラーは標準エラー出力に表示されます。標準出力には結果のテキスト（または --json を指定した場合は JSON の塊）だけが出力されるため、スクリプトやパイプラインで簡単に組み合わせられます。

このスクリプトが回避する Windows 固有の問題

opencode のコンパイル済み Windows バイナリ（opencode.exe）は、標準出力が匿名パイプの場合に無期限にハングすることが確認されています。これは、子プロセスの出力を取得する際に Node の child_process がデフォルトで使用するものと同じです。この現象は、.exe を直接起動した場合とシェル経由で起動した場合の両方で、一貫して再現しました（6 回中 6 回）。

解決策は、子プロセスの標準出力と標準エラー出力をディスク上の実際の一時ファイルにリダイレクトし、プロセス終了後にファイルを読み取ることです。パイプは使用しません。この方法は Windows で確実に動作し、ほかのプラットフォームでも問題がないため、consult-opencode は OS にかかわらず常にこの方法を使用します。

独自の Node ツールから opencode と連携していて、出力がまったくないままハングする場合は、ほぼ間違いなくこれが原因です。

ライセンス

MIT