opencode-gitwt 0.2.2 → 0.3.0

package/README.md

@@ -3,19 +3,22 @@
 OpenCode adapter for `gitwt`. It exposes the shared worktree core as agent tools:
 https://github.com/voischev/gitwt
 
-Requires Node.js 22.14+ and Git. Supports OpenCode 1.19.3–<2.
+Requires Node.js 22.14+ and Git. Supports OpenCode V1 (1.19.3+) and V2 (2.2.5+).
 
 ## Use in OpenCode
 
-Add the plugin to your project's `opencode.json`, then restart OpenCode:
+For **OpenCode V2**, add to your project's `opencode.json`:
 
 ```json
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-gitwt@latest"]
+  "plugins": ["opencode-gitwt@latest"]
 }
 ```
 
+For **V1**, use `"plugin": ["opencode-gitwt@latest"]` instead. Restart OpenCode
+after installation. Both versions expose the same four gitwt tools.
+
 Ask the agent in chat, for example:
 
 > Create a worktree on branch feature/login from main, fix the login issue there,
@@ -43,3 +46,23 @@ and `~/.config/gitwt/config.json` globally. Options include `remote`, `base`,
 
 For the standalone `gitwt` command, run `npm install -g @voischev/gitwt`.
 Move existing settings to these paths and remove comments and trailing commas.
+
+## Why use it with OpenCode V2?
+
+V2 already has native worktree tools, setup commands, and session moves.
+Use gitwt when you want:
+
+- **One workflow across agents:** the same standalone CLI, Node API, and JSON
+  contract in OpenCode, Codex, Claude Code, and scripts.
+- **Named branches from a fresh remote base:** gitwt fetches the selected base
+  and verifies path, branch, and commit before setup. V2's built-in Git strategy
+  creates a detached checkout from a local ref or HEAD, without fetching.
+- **Per-worktree lifecycle hooks:** saved `postCreate` and `preRemove` commands;
+  teardown failure blocks removal through gitwt, even with `--force`.
+
+Prefer native V2 features for integrated UI navigation and actual session moves.
+Native removal does not run gitwt's teardown hooks: remove gitwt-managed copies
+through `gitwt_remove` or the CLI when those hooks matter.
+
+Comparison verified against OpenCode V2.2.5's built-in Git strategy:
+https://github.com/anomalyco/opencode/blob/v2.2.5/packages/core/src/worktree.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-gitwt",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Git worktree tools for OpenCode, powered by gitwt",
   "type": "module",
   "main": "./src/index.js",
@@ -15,7 +15,7 @@
   ],
   "engines": {
     "node": ">=22.14.0",
-    "opencode": ">=1.19.3 <2"
+    "opencode": ">=1.19.3 <2 || >=2.2.5 <3"
   },
   "scripts": {
     "check": "biome check .",

package/src/index.js

@@ -102,4 +102,29 @@ export async function GitwtPlugin({ directory }, config = {}) {
   };
 }
 
-export default { id: "opencode-gitwt", server: GitwtPlugin };
+export default {
+  id: "opencode-gitwt",
+  server: GitwtPlugin,
+  async setup(ctx) {
+    const directory = ctx.location.directory;
+    const hooks = await GitwtPlugin({ directory }, ctx.options);
+    const definitions = [];
+    for (const [name, definition] of Object.entries(hooks.tool)) {
+      const output = {};
+      await hooks["tool.definition"]({ toolID: name }, output);
+      definitions.push({
+        name,
+        description: definition.description,
+        input: output.jsonSchema,
+        options: { codemode: false },
+        async execute(args, call) {
+          call.signal.throwIfAborted();
+          return { content: await definition.execute(args, { directory, abort: call.signal }) };
+        },
+      });
+    }
+    await ctx.tool.transform((editor) => {
+      for (const definition of definitions) editor.add(definition);
+    });
+  },
+};