Skip to content

feat: add OpenCode plugin support#300

Merged
pszymkowiak merged 2 commits intortk-ai:developfrom
zeval:feature/opencode-support-11n
Mar 11, 2026
Merged

feat: add OpenCode plugin support#300
pszymkowiak merged 2 commits intortk-ai:developfrom
zeval:feature/opencode-support-11n

Conversation

@zeval
Copy link

@zeval zeval commented Mar 2, 2026 •
edited
Loading

Warning

Depends on #241 which streamlines the rewrite logic so that hooks don't have to repeat code

Summary

Add OpenCode plugin support to RTK. The plugin uses OpenCode's tool.execute.before hook to rewrite Bash/Shell tool commands to rtk ... before execution.

Built on top of PR #241 (rtk rewrite): the OpenCode plugin is a thin 38-line wrapper that delegates all rewrite logic to rtk rewrite.

What's added

  • hooks/opencode-rtk.ts (38 lines) — OpenCode plugin that calls rtk rewrite via shell
  • rtk init -g --opencode — install the plugin to ~/.config/opencode/plugins/rtk.ts
  • rtk init -g — now installs both Claude Code hook AND OpenCode plugin by default
  • rtk init -g --claude / --opencode — install only one integration
  • rtk init --show — reports OpenCode plugin status
  • rtk init -g --uninstall — removes OpenCode plugin alongside Claude Code artifacts
  • Docs: README section, troubleshooting guide

Architecture

Claude Code hook   55-line bash  ─┐
OpenCode plugin    38-line TS    ─┤  rtk rewrite "cmd"
Future hooks       ~15 lines    ─┘  (single source of truth)
                                     └── src/rewrite_cmd.rs
                                     └── src/discover/registry.rs

Both hooks are thin protocol adapters. All rewrite logic lives in Rust.

Design decisions

  • --opencode as opt-in flag: `rtk init -g` installs both by default; `--claude` or `--opencode` installs only one
  • Plugin directory: `~/.config/opencode/plugins/` per OpenCode docs
  • No parity test needed: both hooks delegate to `rtk rewrite`, so there's nothing to drift
  • Known limitation: OpenCode plugin hooks don't intercept subagent tool calls (upstream issue)

Files changed

File Change
hooks/opencode-rtk.ts New — 38-line thin wrapper calling rtk rewrite
src/init.rs Add OpenCode install/update/uninstall/status (+243/-26)
src/main.rs Add --claude/--opencode flags to Init command
README.md Add OpenCode setup section
docs/TROUBLESHOOTING.md Add OpenCode troubleshooting

Testing

cargo test --all                       # 476 tests pass
cargo run -- init -g --opencode        # installs plugin
cargo run -- init --show               # shows OpenCode status
cargo run -- init -g --uninstall       # removes all artifacts

Closes

@zeval zeval marked this pull request as ready for review March 2, 2026 13:06
@zeval zeval marked this pull request as draft March 2, 2026 14:52
@zeval zeval changed the title feat(init): add OpenCode plugin support + target flags feat(init): add OpenCode plugin support Mar 2, 2026
@zeval zeval mentioned this pull request Mar 2, 2026
Open
@zeval zeval marked this pull request as ready for review March 2, 2026 15:38
@zeval zeval mentioned this pull request Mar 2, 2026
Merged
6 tasks
@zeval zeval changed the title feat(init): add OpenCode plugin support feat: add OpenCode plugin support Mar 2, 2026
@zeval zeval changed the base branch from master to feat/rtk-rewrite March 2, 2026 16:25
@zeval zeval force-pushed the feature/opencode-support-11n branch from 7fc90d2 to c2d5478 Compare March 2, 2026 16:25
@zeval
Copy link
Author

zeval commented Mar 2, 2026

Rewrote this to respect the work done in #241 since we don't want to keep adding repeated re-write logic. When #241 is merged, this should be ready as well.

@zeval zeval mentioned this pull request Mar 2, 2026
Open
@zeval zeval force-pushed the feature/opencode-support-11n branch from 519deff to 8a99cbe Compare March 5, 2026 13:27
@zeval zeval changed the base branch from feat/rtk-rewrite to master March 5, 2026 13:28
@zeval
Copy link
Author

zeval commented Mar 5, 2026

Rebased after #241 was merged. @pszymkowiak could I have your input on this? I'm not entirely sure about the --opencode behavior.

@FlorianBruniaux FlorianBruniaux mentioned this pull request Mar 5, 2026
Open
@FlorianBruniaux
Copy link
Collaborator

FlorianBruniaux commented Mar 5, 2026

Hi @zeval, @tom-thompson, @AlecMcQuarrie, @itai-delphos! We have four OpenCode integration PRs open (#225, #262, #300, #303) — they overlap significantly. We're leaning toward the lighter plugin approach (#303 or #300) for a first merge, then building on top. @AlecMcQuarrie (#225), @itai-delphos (#262) — could you rebase first (CI is failing on both), and let's discuss in a comment which features go beyond what #300/#303 offer? We'd like to avoid landing four competing implementations.

@FlorianBruniaux FlorianBruniaux mentioned this pull request Mar 5, 2026
Closed
@zeval zeval force-pushed the feature/opencode-support-11n branch from 8a99cbe to 0d88f52 Compare March 6, 2026 11:14
@honeyspoon honeyspoon mentioned this pull request Mar 7, 2026
Closed
4 tasks
@zeval
Copy link
Author

zeval commented Mar 9, 2026

Hey @FlorianBruniaux, thanks for the attention. My objective with this was to get the functionality working with OpenCode while respecting the decisions behind rtk rewrite. Maybe we could use this PR as a first merge and build on it later? I see a lot of love for OpenCode on the open issue :) Thanks again, let me know your thoughts.

@pszymkowiak pszymkowiak changed the base branch from master to develop March 11, 2026 21:08
zeval added 2 commits March 11, 2026 22:11
@zeval @pszymkowiak
feat(opencode): add OpenCode plugin support
e919f7d 
Add `--opencode` flag to `rtk init` for installing a global OpenCode
plugin that rewrites Bash/shell commands through `rtk rewrite`.

- New plugin: hooks/opencode-rtk.ts (thin delegator to rtk rewrite)
- New init modes: --opencode (OpenCode only), combinable with Claude modes
- Plugin install/update/remove lifecycle with idempotent writes
- Uninstall cleans up OpenCode plugin alongside Claude Code artifacts
- `rtk init --show` reports OpenCode plugin status
- Replace unreachable!() with bail!() in match exhaustiveness guard
@zeval @pszymkowiak
docs: add OpenCode plugin documentation
2976701 
- README: OpenCode plugin section, install flags, troubleshooting
- TROUBLESHOOTING: OpenCode-specific checklist
- Update init mode table to reflect Claude Code default
@pszymkowiak pszymkowiak force-pushed the feature/opencode-support-11n branch from 0d88f52 to 2976701 Compare March 11, 2026 21:13
@pszymkowiak pszymkowiak merged commit 064cb3e into rtk-ai:develop Mar 11, 2026
This was referenced Mar 11, 2026
Open
Open
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

add support/installation for OpenCode

3 participants

@zeval @FlorianBruniaux @pszymkowiak