opencode-forking-agents-plugin 0.1.0 → 0.1.3

package/README.md

@@ -1,7 +1,23 @@
-# forking-agents-plugin
+# opencode-forking-agents-plugin
 
 OpenCode plugin that adds `fork_<agent>` subagents. When you run the **task** tool with `subagent_type` set to `fork_general`, `fork_explore`, or `fork_<name>` for any configured `mode: subagent` agent, the plugin rewrites the call to the base agent and prepends the **parent session transcript** to the task prompt (wrapped in `<parent_session_transcript>`).
 
+## Available Fork Subagents
+
+This plugin automatically creates the following fork subagents:
+
+- **`fork_explore`** - Fork of the built-in `explore` agent. Use this when you need the subagent to have context from the parent session while exploring codebases.
+- **`fork_general`** - Fork of the built-in `general` agent. Use this for general-purpose tasks that need parent session context.
+- **`fork_<name>`** - For any custom agent with `mode: subagent` in your config.
+
+Example usage:
+```json
+{
+  "subagent_type": "fork_explore",
+  "prompt": "Find all files that use the User type"
+}
+```
+
 ## Install
 
 In `opencode.json`:
@@ -9,7 +25,7 @@ In `opencode.json`:
 ```json
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": ["forking-agents-plugin"]
+  "plugin": ["opencode-forking-agents-plugin"]
 }
 ```
 
@@ -19,6 +35,16 @@ OpenCode installs npm plugins automatically (see [Plugins](https://opencode.ai/d
 
 Clone this repo and point `plugin` at the entry file, or use `bun link` / `npm link`.
 
+## Release to npm
+
+GitHub Actions publishes to npm when a GitHub release is published.
+
+The workflow uses npm trusted publishing from GitHub Actions, so no `NPM_TOKEN` repository secret is required.
+
+The GitHub release tag must match the current `package.json` version as either `X.Y.Z` or `vX.Y.Z`.
+
+Versions with a prerelease suffix such as `0.2.0-beta.1` publish to the `next` dist-tag. Versions without a prerelease suffix publish to `latest`.
+
 ## Disable
 
 Set `OPENCODE_DISABLE_FORK_SUBAGENT_PLUGIN=1`.

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "opencode-forking-agents-plugin",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "type": "module",
   "license": "MIT",
   "description": "OpenCode plugin: fork_* subagents with parent session transcript prepended to task prompts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wkronmiller/forking-agents-plugin.git"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
   "exports": {
     ".": {
       "types": "./src/index.ts",
@@ -22,5 +31,10 @@
     "typecheck": "tsc --noEmit",
     "test": "bun test"
   },
-  "keywords": ["opencode", "plugin", "subagent", "fork"]
+  "keywords": [
+    "opencode",
+    "plugin",
+    "subagent",
+    "fork"
+  ]
 }

package/src/index.ts

@@ -7,7 +7,7 @@ export type ForkPluginInput = PluginInput & {
 }
 
 const PREFIX = "fork_"
-const SVC = "plugin.forking-agents"
+const SVC = "plugin.opencode-forking-agents"
 const PREVIEW = 4000
 const CAP = 400_000
 

package/bun.lock

@@ -1,50 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "configVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "forking-agents-plugin",
-      "devDependencies": {
-        "@opencode-ai/plugin": "1.4.3",
-        "@types/bun": "1.2.23",
-        "typescript": "5.9.2",
-      },
-      "peerDependencies": {
-        "@opencode-ai/plugin": ">=1.4.3",
-      },
-    },
-  },
-  "packages": {
-    "@opencode-ai/plugin": ["@opencode-ai/plugin@1.4.3", "", { "dependencies": { "@opencode-ai/sdk": "1.4.3", "zod": "4.1.8" }, "peerDependencies": { "@opentui/core": ">=0.1.97", "@opentui/solid": ">=0.1.97" }, "optionalPeers": ["@opentui/core", "@opentui/solid"] }, "sha512-Ob/3tVSIeuMRJBr2O23RtrnC5djRe01Lglx+TwGEmjrH9yDBJ2tftegYLnNEjRoMuzITgq9LD8168p4pzv+U/A=="],
-
-    "@opencode-ai/sdk": ["@opencode-ai/sdk@1.4.3", "", { "dependencies": { "cross-spawn": "7.0.6" } }, "sha512-X0CAVbwoGAjTY2iecpWkx2B+GAa2jSaQKYpJ+xILopeF/OGKZUN15mjqci+L7cEuwLHV5wk3x2TStUOVCa5p0A=="],
-
-    "@types/bun": ["@types/bun@1.2.23", "", { "dependencies": { "bun-types": "1.2.23" } }, "sha512-le8ueOY5b6VKYf19xT3McVbXqLqmxzPXHsQT/q9JHgikJ2X22wyTW3g3ohz2ZMnp7dod6aduIiq8A14Xyimm0A=="],
-
-    "@types/node": ["@types/node@25.6.0", "", { "dependencies": { "undici-types": "~7.19.0" } }, "sha512-+qIYRKdNYJwY3vRCZMdJbPLJAtGjQBudzZzdzwQYkEPQd+PJGixUL5QfvCLDaULoLv+RhT3LDkwEfKaAkgSmNQ=="],
-
-    "@types/react": ["@types/react@19.2.14", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-ilcTH/UniCkMdtexkoCN0bI7pMcJDvmQFPvuPvmEaYA/NSfFTAgdUSLAoVjaRJm7+6PvcM+q1zYOwS4wTYMF9w=="],
-
-    "bun-types": ["bun-types@1.2.23", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-R9f0hKAZXgFU3mlrA0YpE/fiDvwV0FT9rORApt2aQVWSuJDzZOyB5QLc0N/4HF57CS8IXJ6+L5E4W1bW6NS2Aw=="],
-
-    "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
-
-    "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
-
-    "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
-
-    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
-
-    "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
-
-    "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
-
-    "typescript": ["typescript@5.9.2", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A=="],
-
-    "undici-types": ["undici-types@7.19.2", "", {}, "sha512-qYVnV5OEm2AW8cJMCpdV20CDyaN3g0AjDlOGf1OW4iaDEx8MwdtChUp4zu4H0VP3nDRF/8RKWH+IPp9uW0YGZg=="],
-
-    "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
-
-    "zod": ["zod@4.1.8", "", {}, "sha512-5R1P+WwQqmmMIEACyzSvo4JXHY5WiAFHRMg+zBZKgKS+Q1viRa0C1hmUKtHltoIFKtIdki3pRxkmpP74jnNYHQ=="],
-  }
-}

package/test/fork-subagent.test.ts

@@ -1,77 +0,0 @@
-import { describe, expect, test } from "bun:test"
-import forkSubagentPlugin, { type ForkPluginInput } from "../src/index.js"
-
-function ctx(over: Partial<ForkPluginInput> = {}): ForkPluginInput {
-  return {
-    client: {
-      app: { log: () => Promise.resolve({} as never) },
-    },
-    directory: "/tmp",
-    worktree: "/tmp",
-    project: {} as never,
-    serverUrl: new URL("http://localhost:4096"),
-    $: undefined as never,
-    listSessionMessages: async () => [],
-    ...over,
-  } as ForkPluginInput
-}
-
-describe("forkSubagentPlugin", () => {
-  test("config adds fork_* agents for builtins and configured subagents", async () => {
-    const hooks = await forkSubagentPlugin(ctx())
-    const cfg: { agent?: Record<string, { mode?: string; description?: string; hidden?: boolean }> } = {
-      agent: {
-        zebra: { mode: "subagent", description: "Zebra" },
-      },
-    }
-    await hooks.config?.(cfg as never)
-    expect(cfg.agent?.fork_general?.mode).toBe("subagent")
-    expect(cfg.agent?.fork_explore?.hidden).toBe(true)
-    expect(cfg.agent?.fork_zebra?.mode).toBe("subagent")
-    expect(cfg.agent?.fork_zebra?.description).toContain("Fork of @zebra")
-  })
-
-  test("config does not replace an existing fork entry", async () => {
-    const hooks = await forkSubagentPlugin(ctx())
-    const cfg = {
-      agent: {
-        fork_general: { mode: "subagent" as const, description: "custom" },
-      },
-    }
-    await hooks.config?.(cfg as never)
-    expect(cfg.agent.fork_general.description).toBe("custom")
-  })
-
-  test("tool.execute.before rewrites fork_* and prepends transcript", async () => {
-    const hooks = await forkSubagentPlugin(
-      ctx({
-        directory: "/proj",
-        worktree: "/proj",
-        listSessionMessages: async () => [
-          {
-            info: { role: "user" },
-            parts: [{ type: "text", text: "hello" }],
-          },
-          {
-            info: { role: "assistant" },
-            parts: [{ type: "text", text: "hi" }],
-          },
-        ],
-      }),
-    )
-    const fn = hooks["tool.execute.before"]
-    expect(fn).toBeDefined()
-    const out = {
-      args: {
-        subagent_type: "fork_explore",
-        prompt: "find foo",
-      },
-    }
-    await fn!({ tool: "task", sessionID: "sess-1", callID: "c1" } as never, out as never)
-    expect(out.args.subagent_type).toBe("explore")
-    expect(out.args.prompt).toContain("<parent_session_transcript>")
-    expect(out.args.prompt).toContain("USER:\nhello")
-    expect(out.args.prompt).toContain("<task>")
-    expect(out.args.prompt).toContain("find foo")
-  })
-})

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "types": ["bun-types"]
-  },
-  "include": ["src/**/*.ts", "test/**/*.ts"]
-}