@khalilgharbaoui/opencode-claude-code-plugin 0.4.21 → 0.4.22

package/README.md

@@ -213,8 +213,11 @@ By default, when Claude Code's CLI uses `Bash`, `Edit`, `Write`, etc., it execut
 | `"Edit"` | `Edit`, `MultiEdit` | `mcp__opencode_proxy__edit` |
 | `"Write"` | `Write` | `mcp__opencode_proxy__write` |
 | `"WebFetch"` | `WebFetch` | `mcp__opencode_proxy__webfetch` |
+| `"Task"` | `Agent` | `mcp__opencode_proxy__task` |
 
-Only those four values are actually proxied; anything else you put in `proxyTools` is ignored. Proxying `Edit` also disables `MultiEdit` — opencode has no batched-edit equivalent, so Claude is forced to fan out into single `Edit` calls that each flow through the permission UI.
+The `Task` proxy is the way to let Claude orchestrate opencode's configured subagents (`build`, `general`, custom subagents defined in `opencode.json`) instead of Claude CLI's internal-only general-purpose / Explore / Plan options. With `"Task"` in `proxyTools` and `permission.task: allow` granted to the calling agent, a Claude session can invoke `task(subagent_type="build", prompt="...")` and the subagent runs natively under opencode (with its own permission UI, lifecycle, model assignment, and Tab visibility). Without `"Task"`, Claude's built-in `Agent` tool stays enabled and Claude orchestrates subagents internally with no opencode visibility.
+
+Only those five values are actually proxied; anything else you put in `proxyTools` is ignored. Proxying `Edit` also disables `MultiEdit` — opencode has no batched-edit equivalent, so Claude is forced to fan out into single `Edit` calls that each flow through the permission UI.
 
 To turn off proxying entirely:
 

package/dist/index.d.ts

@@ -229,7 +229,15 @@ interface ClaudeCodeProviderSettings {
      *     opencode's tool executor (with its native permission UI) and returns
      *     the result.
      *
-     * Supported: `bash`, `write`, `edit`, `webfetch`. Leave empty or unset to disable proxying.
+     * Supported: `bash`, `write`, `edit`, `webfetch`, `task`. Leave empty or unset to disable proxying.
+     *
+     * `task` proxies Claude CLI's `Agent` (subagent dispatch) tool through
+     * opencode's `task` tool, so subagent calls run under opencode's
+     * configured subagent set (build/general/custom) with opencode's
+     * permission and lifecycle handling, instead of Claude CLI's
+     * internal-only general-purpose / Explore / Plan options. The calling
+     * agent must have `permission.task: allow` for the target subagent
+     * (see opencode's agent docs).
      */
     proxyTools?: string[];
     /**

package/dist/index.js

@@ -1406,6 +1406,36 @@ var DEFAULT_PROXY_TOOLS = [
       },
       required: ["url"]
     }
+  },
+  {
+    name: "task",
+    description: "Launch an opencode subagent to handle a complex multi-step task autonomously. Routed through opencode's task tool so subagent orchestration, permission, and lifecycle are handled by opencode. Use `subagent_type` to pick which configured subagent runs (e.g. `build`, `general`, `explore`, or any custom subagent declared in opencode.json). The call blocks until the subagent finishes; the 10-minute proxy timeout applies.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        description: {
+          type: "string",
+          description: "A short (3-5 words) description of the task"
+        },
+        prompt: {
+          type: "string",
+          description: "The task for the agent to perform"
+        },
+        subagent_type: {
+          type: "string",
+          description: "The type of specialized agent to use for this task"
+        },
+        task_id: {
+          type: "string",
+          description: "Set this only if you mean to resume a previous task \u2014 pass the prior task_id to continue the same subagent session instead of creating a fresh one."
+        },
+        command: {
+          type: "string",
+          description: "The command that triggered this task"
+        }
+      },
+      required: ["description", "prompt", "subagent_type"]
+    }
   }
 ];
 async function createProxyMcpServer(tools = DEFAULT_PROXY_TOOLS) {
@@ -1642,7 +1672,8 @@ function disallowedToolFlags(tools) {
     edit: ["Edit", "MultiEdit"],
     glob: ["Glob"],
     grep: ["Grep"],
-    webfetch: ["WebFetch"]
+    webfetch: ["WebFetch"],
+    task: ["Agent"]
   };
   const out = [];
   const seen = /* @__PURE__ */ new Set();