Add OpenCode plugin support by lukelabonte · Pull Request #15 · gpambrozio/ClaudeCodePlugins

lukelabonte · 2026-07-02T19:46:18Z

Overview

Adds local OpenCode support to each marketplace plugin without changing the existing Claude Code plugin format. OpenCode users can point their configuration at a plugin's opencode-plugin.js entry point, which adapts the package's existing skills, MCP servers, session context, command guardrails, and shell setup to OpenCode hooks.

The implementation also hardens the XcodeBuildTools integration around sandbox containment, stale-session cleanup, bounded process termination, non-Git project paths, and prompt-time executable trust.

Technical Details

Adds one canonical common/opencode-plugin.js adapter, five synchronized package-local copies, and thin per-plugin entry points.
Translates Claude-compatible MCP definitions while preserving endpoint precedence and exporting authoritative CLAUDE_PLUGIN_ROOT, CLAUDE_PLUGIN_DATA, and CLAUDE_PROJECT_DIR values.
Reuses existing session-start content and pre-tool-use rules through OpenCode's system-transform and tool hooks.
Gives XcodeBuildTools sessions isolated build/package directories with owner, identity, quarantine, and lifecycle checks before cleanup.
Tracks Xcode MCP detection and approval work per session, uses fixed system executable paths, and shares bounded SIGTERM → SIGKILL cleanup across session deletion and plugin disposal.
Makes Node.js a required validation dependency and expands runtime/integrity coverage for the adapter and generated packages.

Register OpenCode entrypoints for each plugin, wire shared skill/MCP/context hooks, and document local OpenCode installation.

Copilot

Pull request overview

Adds OpenCode local plugin support by introducing a shared OpenCode adapter (common/opencode-plugin.js), generating per-plugin adapter copies + lightweight opencode-plugin.js entrypoints, and updating docs/tests/version metadata so OpenCode users can install plugins by pointing config at each plugin directory entrypoint.

Changes:

Introduces createOpenCodePlugin() adapter (shared + per-plugin generated copies) and adds per-plugin opencode-plugin.js entrypoints.
Updates plugin documentation and repository docs to include OpenCode installation/config guidance.
Extends repository integrity tests and sync tooling to cover OpenCode entrypoints and generate JS helpers with // comment headers.

Reviewed changes

Copilot reviewed 30 out of 30 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
`common/opencode-plugin.js`	Adds shared OpenCode adapter for skills/MCP/session context/guardrails/shell env.
`scripts/sync-plugin-common.py`	Generates `//` headers for `.js`/`.ts` common helper copies.
`tests/test_repository_integrity.py`	Adds integrity checks for OpenCode entrypoints + JS syntax/export validation.
`README.md`	Documents OpenCode installation flow via `opencode-plugin.js` entrypoints.
`CLAUDE.md`	Documents OpenCode entrypoint presence and OpenCode test guidance.
`.claude-plugin/marketplace.json`	Bumps plugin versions to include OpenCode support releases.
`PluginBase/opencode-plugin.js`	Adds OpenCode entrypoint for PluginBase.
`PluginBase/common/opencode-plugin.js`	Adds generated OpenCode adapter copy into PluginBase package.
`PluginBase/info.json`	Records PluginBase changelog entry for OpenCode adapter/template.
`PluginBase/.claude-plugin/plugin.json`	Bumps PluginBase version.
`XcodeBuildTools/opencode-plugin.js`	Adds OpenCode entrypoint for XcodeBuildTools.
`XcodeBuildTools/common/opencode-plugin.js`	Adds generated OpenCode adapter copy into XcodeBuildTools package.
`XcodeBuildTools/README.md`	Adds OpenCode installation instructions and changelog entry.
`XcodeBuildTools/info.json`	Records OpenCode support in version history.
`XcodeBuildTools/.claude-plugin/plugin.json`	Bumps XcodeBuildTools version.
`SwiftScaffolding/opencode-plugin.js`	Adds OpenCode entrypoint for SwiftScaffolding.
`SwiftScaffolding/common/opencode-plugin.js`	Adds generated OpenCode adapter copy into SwiftScaffolding package.
`SwiftScaffolding/README.md`	Adds OpenCode installation instructions and changelog entry.
`SwiftScaffolding/info.json`	Records OpenCode support in version history.
`SwiftScaffolding/.claude-plugin/plugin.json`	Bumps SwiftScaffolding version.
`MarvinOutputStyle/opencode-plugin.js`	Adds OpenCode entrypoint for MarvinOutputStyle.
`MarvinOutputStyle/common/opencode-plugin.js`	Adds generated OpenCode adapter copy into MarvinOutputStyle package.
`MarvinOutputStyle/README.md`	Adds OpenCode installation instructions and changelog entry.
`MarvinOutputStyle/info.json`	Records OpenCode support in version history.
`MarvinOutputStyle/.claude-plugin/plugin.json`	Bumps MarvinOutputStyle version.
`iOSSimulator/opencode-plugin.js`	Adds OpenCode entrypoint for iOSSimulator.
`iOSSimulator/common/opencode-plugin.js`	Adds generated OpenCode adapter copy into iOSSimulator package.
`iOSSimulator/README.md`	Adds OpenCode installation instructions and changelog entry.
`iOSSimulator/info.json`	Records OpenCode support in version history.
`iOSSimulator/.claude-plugin/plugin.json`	Bumps iOSSimulator version.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

lukelabonte · 2026-07-07T15:12:08Z

+  copyOptionalFields(server, translated, ["cwd", "enabled", "timeout"], context);
+
+  const environment = isObject(server.environment) ? server.environment : server.env;
+  translated.environment = {


These compatibility values intentionally come after the source environment so plugin metadata cannot override host-owned paths. CLAUDE_PLUGIN_DATA stays outside the checkout, and CLAUDE_PROJECT_DIR follows the active OpenCode worktree or directory context.

lukelabonte · 2026-07-07T15:12:17Z

+                self.assertTrue(entrypoint.exists())
+                self.assertEqual(expected, entrypoint.read_text(encoding="utf-8"))
+
+    def test_node_is_available_for_opencode_runtime_checks(self):


This explicit availability test is intentional. The runtime and export tests still skip defensively when run in isolation, but the repository-wide suite must fail when Node is missing so CI cannot report success without exercising the OpenCode checks.

lukelabonte

Additional context for three non-obvious compatibility and lifecycle decisions.

lukelabonte · 2026-07-07T15:17:03Z

+  "opencode.xcodebuildtools.pending-cleanups",
+);
+const pendingSandboxCleanups =
+  globalThis[XCODE_SANDBOX_PENDING_CLEANUPS_KEY] instanceof Set


This process-wide registry survives module reloads so a replacement plugin instance can see cleanup detached by an older one. It supplements the on-disk cleanup marker, allowing the next stale sweep to retry a failed asynchronous removal without waiting for the owner grace period.

lukelabonte · 2026-07-07T15:17:03Z

+      pluginRoot,
+      pluginData: () => pluginDataDirectory(pluginRoot, state),
+      projectDir:
+        input?.worktree !== "/" || input?.project?.vcs === "git"


OpenCode uses / as the worktree sentinel for non-Git projects, but / can also be a valid Git worktree. Prefer directory only for the non-Git sentinel so ${CLAUDE_PROJECT_DIR} and MCP cwd stay scoped to the active project.

lukelabonte · 2026-07-07T15:17:03Z

+  if (!record) return Promise.resolve();
+  if (!record.terminationPromise) {
+    record.terminating = true;
+    record.terminationPromise = terminateXcodeMcpApproval(record).finally(() => {


Keep the helper record mapped until this shared promise settles. session.deleted and dispose() can race; both must await the same SIGTERM → SIGKILL path, and removing the record on the child’s early exit would let disposal miss a still-live process group.

Copilot

Pull request overview

Copilot reviewed 31 out of 32 changed files in this pull request and generated no new comments.

Add OpenCode plugin support

8e36a36

Register OpenCode entrypoints for each plugin, wire shared skill/MCP/context hooks, and document local OpenCode installation.

lukelabonte marked this pull request as ready for review July 2, 2026 20:03

lukelabonte requested review from Copilot and gpambrozio July 2, 2026 20:03

Copilot started reviewing on behalf of lukelabonte July 2, 2026 20:07 View session

Copilot AI reviewed Jul 2, 2026

View reviewed changes

Comment thread common/opencode-plugin.js Outdated

Comment thread common/opencode-plugin.js

Comment thread tests/test_repository_integrity.py

lukelabonte self-assigned this Jul 2, 2026

lukelabonte added 13 commits July 2, 2026 15:47

Cache Xcode MCP detection for OpenCode plugin

3f583e0

Normalize OpenCode deny-once session keys

c9f7570

Check OpenCode JavaScript as modules

93e1805

Refactor plugin packaging and validation flow

7b738cd

Refactor plugin startup flow for cleaner session setup

f3e1387

Expand MCP config placeholders at runtime

19600f1

Document OpenCode compatibility fixes

8f1f07b

Preserve plugin paths for OpenCode MCP servers

46fdd42

Require Node for OpenCode runtime checks

9664ef4

Harden OpenCode MCP and sandbox handling

588da21

Correct SwiftScaffolding OpenCode documentation

b1536c2

Use directory for non-Git OpenCode projects

68897d1

Harden Xcode MCP approval lifecycle

422f08d

lukelabonte commented Jul 7, 2026

View reviewed changes

lukelabonte requested a review from Copilot July 7, 2026 15:21

Copilot started reviewing on behalf of lukelabonte July 7, 2026 15:22 View session

Copilot AI reviewed Jul 7, 2026

View reviewed changes

gpambrozio approved these changes Jul 9, 2026

View reviewed changes

gpambrozio merged commit 0349c77 into main Jul 9, 2026
3 checks passed

gpambrozio deleted the luke/opencode-plugin-support branch July 9, 2026 15:26

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add OpenCode plugin support - #15

Add OpenCode plugin support#15
gpambrozio merged 14 commits into
mainfrom
luke/opencode-plugin-support

lukelabonte commented Jul 2, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lukelabonte Jul 7, 2026

Uh oh!

lukelabonte Jul 7, 2026

Uh oh!

lukelabonte left a comment

Uh oh!

lukelabonte Jul 7, 2026

Uh oh!

lukelabonte Jul 7, 2026

Uh oh!

lukelabonte Jul 7, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

lukelabonte commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Overview

Technical Details

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lukelabonte Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

lukelabonte Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

lukelabonte left a comment

Choose a reason for hiding this comment

Uh oh!

lukelabonte Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

lukelabonte Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

lukelabonte Jul 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lukelabonte commented Jul 2, 2026 •

edited

Loading