rtk init generates incompatible plugin format for OpenCode v2 #3898

Activity

1. Monska85

   added a commit that references this issue on Sep 17, 2026

   fix(ai-harness): harden the opencode 2 plugin setup after review

   ...

   31e8e0e
2. paolomainardi

   added a commit that references this issue on Sep 17, 2026

   fix(ai-harness): load the rtk and herdr plugins on opencode 2 (#648)

   ...

   5b53c59
3. Asura7170 commented on Sep 26, 2026

   

   Asura7170

   on Sep 26, 2026

   More actions

   Confirming still broken on rtk 0.48.0 + OpenCode v2.0.17 (stable, Windows).

   rtk init -g --opencode generates the V1 shape (export const RtkOpenCodePlugin, @opencode-ai/plugin, $ helper, "tool.execute.before" as an object key). The v2 loader rejects it: Plugin must export a default definition with an id and an effect or setup function.

   Locally verified fix — plain v2 module, loads cleanly and rewrites fire:

   export default {
     id: "rtk",
     async setup(ctx: any) {
       await ctx.tool.hook("execute.before", async (event: any) => {
         const command = event?.input?.command;
         if (typeof command !== "string" || !command) return;
         // read stdout even on non-zero exit (see below)
         event.input = { ...event.input, command: rewritten };
       });
     },
   };

   Two things worth knowing for the fix:

   • No $ in v2 — use node:child_process.execFile("rtk", ["rewrite", command]) (also avoids shell interpolation).
   • rtk rewrite exits 3 on success with valid stdout (rtk rewrite "git status" → rtk git status, exit 3), so the hook must read stdout from the error object too, and pass through silently on real failure.

   Suggest shipping one of the open PRs (#3899, #4187, #4197). Happy to test any of them against v2.0.17.

   👍React with 👍1Reacted by Michał Pietrus
4. jchuder commented on Sep 27, 2026

   

   jchuder

   on Sep 27, 2026

   Author

   More actions

   Update: #4187 now provides a more complete fix for this issue than my original PR #3899.

   I have closed #3899 in favor of #4187. Further work on this issue will be tracked there.

   #4187 also covers the additional cases reported here, including OpenCode 2.x, rtk rewrite exit code 3, Windows support, and runtime tests.
5. Asura7170 commented on Sep 27, 2026

   

   Asura7170

   on Sep 27, 2026

   Last edited by Asura7170

   More actions

   Small follow-up: I can confirm the windowsHide: true in #4187 is necessary, not cosmetic. Without it, every rtk rewrite spawn pops a visible console window on Windows (OpenCode runs as a console-less background service, and Node defaults windowsHide to false). Verified the same flag in my local v2 port on 2.0.17 - flash gone, rewrites still fire. Thanks for consolidating on #4187.

   👍React with 👍1Reacted by Jessie.H
6. jchuder

   changed the title [-]rtk init generates incompatible plugin format for OpenCode 2.0[/-] [+]rtk init generates incompatible plugin format for OpenCode v2[/+] on Sep 30, 2026
7. rtk-wshm-sync-bot

   added

   area:cli

   bugSomething isn't workingSomething isn't working

   help wantedExtra attention is neededExtra attention is needed

   priority:high

   on Sep 30, 2026
8. rtk-wshm-sync-bot commented on Sep 30, 2026

   

   rtk-wshm-sync-botBot

   on Sep 30, 2026 – with rtk-wshm-sync-bot

   More actions

   wshm · Automated triage by AI

   🔍 Automated Triage

   🐛 Category	bug
   🟠 Priority	high
   🎯 Confidence	88%

   Summary

   rtk init --opencode generates legacy OpenCode 1.0 plugin format that OpenCode 2.0 fails to load; fix already in progress via PR #4187.

   📁 Relevant files

   • src/init/opencode.rs

   Suggested Actions

   1. Review and merge PR feat(hook/opencode): support OpenCode V2, Desktop, and Windows (#3463, #3326) #4187 which claims to fix this (also refs feat: add opencode v2 plugin support (opencode2) #3463, rtk init --opencode plugin silently does nothing on Desktop ($ is not a function) and on Windows (which not found) #3326)
   2. Verify PR feat(hook/opencode): support OpenCode V2, Desktop, and Windows (#3463, #3326) #4187 preserves OpenCode 1.0 backward compatibility as requested
   3. Confirm version-detection or --opencode-v2 flag behavior matches issue's expected behavior section
   4. Ask reporter to test against PR feat(hook/opencode): support OpenCode V2, Desktop, and Windows (#3463, #3326) #4187 branch once available

   ---

   Triaged automatically by wshm · This is an automated analysis, not a human review.
9. KuSh commented on Oct 3, 2026

   

   KuSh

   on Oct 3, 2026

   Collaborator

   More actions

   Closing as a duplicate of #3463, which tracks the same problem: rtk init --opencode writes the OpenCode 1.x plugin shape, which the OpenCode 2.x loader rejects. #3463 has the implementation sketch and the discussion, so please follow up there.

   👍React with 👍1Reacted by Jessie.H
10. KuSh

    closed this as duplicateon Oct 3, 2026