fix(opencode): clarify bundle distribution

Co-Authored-By: GPT-5.6 <noreply@openai.com>

Author: sergical

.github/workflows/deploy-plugins.yml

@@ -1,14 +1,14 @@
-# Deploy per-agent plugin distributions to their own repositories.
+# Deploy per-agent distributions to their own repositories.
 #
 # This repository is the single source of truth (skills + routing metadata,
-# feeding skills.sentry.dev). Each AI assistant needs the plugin in a different
-# shape, so this workflow builds each one and deploys it to a dedicated
-# repository whose ROOT is exactly that agent's plugin:
+# feeding skills.sentry.dev). Each AI assistant needs the integration in a
+# different shape, so this workflow builds each one and deploys it to a
+# dedicated repository whose root is exactly that agent's distribution:
 #
-#   claude -> getsentry/plugin-claude
-#   cursor -> getsentry/plugin-cursor
-#   codex  -> getsentry/plugin-codex
-#   grok   -> getsentry/plugin-grok
+#   claude    -> getsentry/plugin-claude
+#   cursor    -> getsentry/plugin-cursor
+#   codex     -> getsentry/plugin-codex
+#   grok      -> getsentry/plugin-grok
 #   opencode  -> getsentry/plugin-opencode
 #   opencode2 -> getsentry/plugin-opencode2
 #

.github/workflows/smoke-installer.yml

@@ -11,11 +11,9 @@
 # PATH to satisfy detection and verify the real clone (this is what exercises
 # the per-OS path handling, including Windows).
 #
-# OpenCode V2 currently recommends WSL on Windows and cannot share V1's MCP
-# config shape, so it runs in a separate Linux smoke job. The OpenCode target
-# repositories are replaced with temporary local git repositories in both jobs;
-# this tests the real clone flow before those generated repositories are first
-# deployed.
+# The OpenCode target repositories are replaced with temporary local git
+# repositories in both jobs; this tests the real clone flow before those
+# generated repositories are first deployed.
 
 name: Smoke installer
 
@@ -134,6 +132,8 @@ jobs:
 
           echo "All agents have the Sentry plugin."
 
+  # OpenCode V2 currently recommends WSL on Windows and cannot share V1's MCP
+  # config shape, so exercise it separately from the cross-platform V1 matrix.
   smoke-opencode2:
     name: OpenCode V2 beta
     runs-on: ubuntu-latest

AGENTS.md

@@ -1,7 +1,7 @@
 # Agent Instructions
 
 ## Project Overview
-Sentry plugin for AI coding assistants (Claude Code, Cursor, Codex, Grok, and OpenCode V1/V2). Provides MCP server integration and skills.
+Sentry skills and MCP integration for AI coding assistants (Claude Code, Cursor, Codex, Grok, and OpenCode V1/V2).
 
 ## Commit Attribution
 AI commits MUST include:
@@ -21,7 +21,7 @@ src/plugins/<agent>/    # Per-agent build scripts + manifests
 src/SKILL_TREE.md       # Generated skill index (see Skill Tree Navigation below)
 ```
 
-Per-agent plugin metadata is generated by the `src/plugins/<agent>/build.sh`
+Per-agent distribution metadata is generated by the `src/plugins/<agent>/build.sh`
 scripts and published to each agent's distribution repository; it is not
 committed here.
 

README.md

@@ -2,7 +2,7 @@
 
 > [!IMPORTANT]
 > **This is a skill _source_ repository — not something you install directly.**
-> The skills here are built from this source into installable plugins for
+> The skills here are built from this source into installable distributions for
 > [Claude Code](https://github.com/getsentry/plugin-claude),
 > [Cursor](https://github.com/getsentry/plugin-cursor),
 > [Codex](https://github.com/getsentry/plugin-codex),
@@ -55,11 +55,11 @@ Set up OTel Collector with Sentry exporter
 ## Distribution
 
 This repository is the single source of truth for all skills, but it is not
-itself an installable plugin. Each assistant needs the plugin in a slightly
-different shape, so the per-agent plugins are **built** from it by the build
-scripts under `src/plugins/<agent>/build.sh`. CI runs these on every push and
-deploys each result to its own **distribution repository**, whose root is
-exactly that agent's plugin:
+itself an installable distribution. Each assistant needs the integration in a
+slightly different shape, so the per-agent distributions are **built** from it
+by the build scripts under `src/plugins/<agent>/build.sh`. CI runs these on
+every push and deploys each result to its own **distribution repository**,
+whose root is exactly that agent's installable bundle or native plugin:
 
 | Agent       | Distribution repository                                                  |
 | ----------- | ------------------------------------------------------------------------ |

packages/installer/README.md

@@ -42,7 +42,7 @@ For each detected assistant, the installer uses its native package command or in
 | OpenCode V1 | Clones [`getsentry/plugin-opencode`](https://github.com/getsentry/plugin-opencode) into OpenCode's global skills and adds the V1 Sentry MCP entry |
 | OpenCode V2 | Clones [`getsentry/plugin-opencode2`](https://github.com/getsentry/plugin-opencode2) into OpenCode's global skills and adds the V2 Sentry MCP entry |
 
-Each per-agent plugin is built and published from the [`sentry-for-ai`](https://github.com/getsentry/sentry-for-ai) repository, which is the source of truth for all skills.
+Each per-agent distribution is built and published from the [`sentry-for-ai`](https://github.com/getsentry/sentry-for-ai) repository, which is the source of truth for all skills.
 
 ## Removing the plugin
 

packages/installer/src/harnesses/opencode-common.ts

@@ -1,10 +1,11 @@
 import { dirname, join } from "node:path";
 import { applyEdits, findNodeAtLocation, modify, parseTree } from "jsonc-parser";
+import mcp from "../../../../mcp.json";
 import type { OutputSink, SystemDeps } from "../system";
 import type { Harness, InstallOutcome } from "./types";
 import { detectOnPath, runCommand } from "./shell";
 
-const MCP_URL = "https://mcp.sentry.dev/mcp?utm_source=plugin";
+const MCP_URL = mcp.mcpServers.sentry.url;
 
 interface OpenCodeHarnessOptions {
   id: string;

packages/installer/tsconfig.json

@@ -7,6 +7,7 @@
     "rootDir": "src",
     "strict": true,
     "esModuleInterop": true,
+    "resolveJsonModule": true,
     "skipLibCheck": true,
     "types": ["node"]
   },

src/plugins/opencode/README.md

@@ -4,6 +4,10 @@ The Sentry skill bundle for [OpenCode V1](https://opencode.ai/docs/). It
 teaches OpenCode how to set up Sentry, debug production issues through the
 Sentry MCP server, and configure monitoring features.
 
+This is an installer-managed skill and MCP bundle, not an OpenCode runtime
+plugin. Installation uses OpenCode's global skill discovery and MCP
+configuration surfaces separately.
+
 > [!IMPORTANT]
 > This repository is generated. It is built from
 > [getsentry/sentry-for-ai](https://github.com/getsentry/sentry-for-ai) and

src/plugins/opencode/build.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 #
-# build.sh - Build the OpenCode V1 distribution of the Sentry plugin.
+# build.sh - Build the OpenCode V1 Sentry skill and MCP distribution.
 #
 # OpenCode discovers SKILL.md files recursively below a configured skill source.
 # The distribution therefore keeps the shared skills under skills/ and includes

src/plugins/opencode2/README.md

@@ -5,6 +5,10 @@ The Sentry skill bundle for the
 set up Sentry, debug production issues through the Sentry MCP server, and
 configure monitoring features.
 
+This is an installer-managed skill and MCP bundle, not an OpenCode runtime
+plugin. V2 plugins can register skills but cannot register an MCP server, so
+installation configures those two surfaces separately.
+
 > [!IMPORTANT]
 > This repository is generated. It is built from
 > [getsentry/sentry-for-ai](https://github.com/getsentry/sentry-for-ai) and