feat(opencode): add V1 and V2 distributions

Co-Authored-By: OpenAI Codex <codex@openai.com>

Author: sergical

.github/workflows/deploy-plugins.yml

@@ -9,16 +9,18 @@
 #   cursor -> getsentry/plugin-cursor
 #   codex  -> getsentry/plugin-codex
 #   grok   -> getsentry/plugin-grok
+#   opencode  -> getsentry/plugin-opencode
+#   opencode2 -> getsentry/plugin-opencode2
 #   pi     -> getsentry/plugin-pi
 #
-# Marketplaces consume `getsentry/plugin-<agent>` by git ref. Each job builds its
-# agent's tree from this repo, then commits it onto the target repo's `main`,
-# replacing the previous contents. The five jobs target five different repos,
-# so they run in parallel without contention.
+# Marketplaces and installers consume `getsentry/plugin-<agent>` by git ref.
+# Each job builds its agent's tree from this repo, then commits it onto the
+# target repo's `main`, replacing the previous contents. The seven jobs target
+# seven different repos, so they run in parallel without contention.
 #
 # Cross-repo writes use a GitHub App token scoped per-job to a single plugin
 # repo; the default GITHUB_TOKEN cannot push to other repositories. The app must
-# be installed on the org with contents:write on the five plugin repos, its ID
+# be installed on the org with contents:write on the seven plugin repos, its ID
 # stored as the PLUGIN_DEPLOY_APP_ID variable and its private key as the
 # PLUGIN_DEPLOY_KEY secret. Each target repo must already exist with `main` as
 # its default branch.
@@ -50,7 +52,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        agent: [claude, cursor, codex, grok, pi]
+        agent: [claude, cursor, codex, grok, opencode, opencode2, pi]
     concurrency:
       group: deploy-plugin-${{ matrix.agent }}
       cancel-in-progress: false
@@ -70,8 +72,8 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
-      - name: Set up Node for Pi validation
-        if: matrix.agent == 'pi'
+      - name: Set up Node for CLI validation
+        if: matrix.agent == 'pi' || matrix.agent == 'opencode' || matrix.agent == 'opencode2'
         uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
           node-version: 24
@@ -80,6 +82,14 @@ jobs:
         if: matrix.agent == 'pi'
         run: npm install -g --ignore-scripts @earendil-works/pi-coding-agent
 
+      - name: Install OpenCode V1 CLI
+        if: matrix.agent == 'opencode'
+        run: npm install -g opencode-ai@1.18.0
+
+      - name: Install OpenCode V2 CLI
+        if: matrix.agent == 'opencode2'
+        run: npm install -g @opencode-ai/cli@0.0.0-next-16420
+
       - name: Build and deploy plugin-${{ matrix.agent }}
         env:
           AGENT: ${{ matrix.agent }}

.github/workflows/smoke-installer.yml

@@ -4,12 +4,18 @@
 # (--no-interactive) so it installs the Sentry plugin for every detected agent
 # without a prompt, and verifies each plugin actually landed.
 #
-# Claude Code, Codex, Grok, and Pi ship cross-platform npm CLIs, so they get a
-# real install against their package sources. Cursor has no headless CLI to
+# Claude Code, Codex, Grok, OpenCode V1, and Pi ship cross-platform npm CLIs, so
+# they get real CLI installs. Cursor has no headless CLI to
 # install in CI, but our Cursor install is only a `git clone` of the public
 # plugin repo into ~/.cursor/plugins/local/sentry — so we put a `cursor` stub on
 # 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.
 
 name: Smoke installer
 
@@ -57,8 +63,24 @@ jobs:
       - name: Build
         run: pnpm --filter @sentry/ai build
 
-      - name: Install Claude Code, Codex, Grok, and Pi CLIs
-        run: npm install -g @anthropic-ai/claude-code @openai/codex @xai-official/grok @earendil-works/pi-coding-agent
+      - name: Install Claude Code, Codex, Grok, OpenCode V1, and Pi CLIs
+        run: npm install -g @anthropic-ai/claude-code @openai/codex @xai-official/grok opencode-ai@1.18.0 @earendil-works/pi-coding-agent
+
+      - name: Prepare local OpenCode V1 distribution
+        run: |
+          set -euo pipefail
+          repo="$RUNNER_TEMP/plugin-opencode"
+          mkdir -p "$repo/skills/sentry-installer-smoke"
+          printf '1\n' > "$repo/.sentry-opencode-v1"
+          printf '%s\n' '---' 'name: sentry-installer-smoke' 'description: Verify the Sentry OpenCode installer' '---' '' '# Sentry installer smoke' > "$repo/skills/sentry-installer-smoke/SKILL.md"
+          git -C "$repo" init -q
+          git -C "$repo" config user.name smoke-test
+          git -C "$repo" config user.email smoke@example.com
+          git -C "$repo" add .
+          git -C "$repo" commit -qm 'test: seed OpenCode bundle'
+          repo_url="$(node -e 'console.log(require("node:url").pathToFileURL(process.argv[1]).href)' "$repo")"
+          git config --global protocol.file.allow always
+          git config --global "url.${repo_url}.insteadOf" https://github.com/getsentry/plugin-opencode.git
 
       - name: Put a Cursor stub on PATH
         run: |
@@ -100,4 +122,72 @@ jobs:
           pi list --no-approve
           pi list --no-approve | grep -iq 'getsentry/plugin-pi' || { echo "pi: sentry package missing"; exit 1; }
 
+          echo "== opencode =="
+          opencode debug skill > "$RUNNER_TEMP/opencode-skills.json"
+          grep -q 'sentry-installer-smoke' "$RUNNER_TEMP/opencode-skills.json" || { echo "opencode: sentry skill missing"; exit 1; }
+          node - <<'NODE'
+          const fs = require("node:fs");
+          const path = require("node:path");
+          const os = require("node:os");
+          const root = path.join(os.homedir(), ".config", "opencode");
+          const file = ["opencode.json", "opencode.jsonc"].map((name) => path.join(root, name)).find(fs.existsSync);
+          if (!file) throw new Error("opencode: global config missing");
+          const config = JSON.parse(fs.readFileSync(file, "utf8"));
+          if (!config.mcp?.sentry?.url?.includes("mcp.sentry.dev")) throw new Error("opencode: Sentry MCP missing");
+          NODE
+
           echo "All agents have the Sentry plugin."
+
+  smoke-opencode2:
+    name: OpenCode V2 beta
+    runs-on: ubuntu-latest
+    env:
+      SENTRY_DSN: ""
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+
+      - uses: pnpm/action-setup@a15d269cd4658e1107c09f1fabf4cbd7bd1f308a # v4.4.0
+
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: 24
+          cache: pnpm
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm --filter @sentry/ai build
+      - run: npm install -g @opencode-ai/cli@0.0.0-next-16420
+
+      - name: Prepare local OpenCode V2 distribution
+        run: |
+          set -euo pipefail
+          repo="$RUNNER_TEMP/plugin-opencode2"
+          mkdir -p "$repo/skills/sentry-installer-smoke"
+          printf '2\n' > "$repo/.sentry-opencode-v2"
+          printf '%s\n' '---' 'name: sentry-installer-smoke' 'description: Verify the Sentry OpenCode V2 installer' 'metadata:' '  opencode/autoinvoke: "false"' '---' '' '# Sentry installer smoke' > "$repo/skills/sentry-installer-smoke/SKILL.md"
+          git -C "$repo" init -q
+          git -C "$repo" config user.name smoke-test
+          git -C "$repo" config user.email smoke@example.com
+          git -C "$repo" add .
+          git -C "$repo" commit -qm 'test: seed OpenCode V2 bundle'
+          repo_url="$(node -e 'console.log(require("node:url").pathToFileURL(process.argv[1]).href)' "$repo")"
+          git config --global protocol.file.allow always
+          git config --global "url.${repo_url}.insteadOf" https://github.com/getsentry/plugin-opencode2.git
+
+      - name: Run installer (non-interactive)
+        run: node packages/installer/dist/index.js install --no-interactive
+
+      - name: Verify OpenCode V2 installation
+        run: |
+          set -euo pipefail
+          node - <<'NODE'
+          const fs = require("node:fs");
+          const path = require("node:path");
+          const os = require("node:os");
+          const bundle = path.join(os.homedir(), ".config", "opencode", "skills", "sentry", "skills", "sentry-installer-smoke", "SKILL.md");
+          if (!fs.existsSync(bundle)) throw new Error(`opencode2: Sentry skill missing at ${bundle}`);
+          const root = path.join(os.homedir(), ".config", "opencode");
+          const file = ["opencode.json", "opencode.jsonc"].map((name) => path.join(root, name)).find(fs.existsSync);
+          if (!file) throw new Error("opencode2: global config missing");
+          const config = JSON.parse(fs.readFileSync(file, "utf8"));
+          if (!config.mcp?.servers?.sentry?.url?.includes("mcp.sentry.dev")) throw new Error("opencode2: Sentry MCP missing");
+          NODE

AGENTS.md

@@ -1,7 +1,7 @@
 # Agent Instructions
 
 ## Project Overview
-Sentry plugin for AI coding assistants (Claude Code, Cursor, Codex, Grok, and Pi). Provides MCP server integration and skills.
+Sentry plugin for AI coding assistants (Claude Code, Cursor, Codex, Grok, OpenCode V1/V2, and Pi). Provides MCP server integration and skills.
 
 ## Commit Attribution
 AI commits MUST include:
@@ -80,6 +80,8 @@ Skills use YAML frontmatter with `allowed-tools` — this is required by Cursor
 ## MCP Server
 Sentry MCP server configured at `https://mcp.sentry.dev/mcp`. The source of truth is `mcp.json`: Cursor consumes it as-is at the plugin root, while the Codex and Grok builds emit it as `.mcp.json` (Codex's validator requires the dotted name; Grok auto-discovers it). Claude declares the server inline in its `plugin.json` (`mcpServers`), so the Claude build ships no MCP file. Pi declares the same server in `src/plugins/pi/extensions/sentry-mcp.ts`, which adapts it into native Pi tools. The root `.mcp.json` is a backwards-compat copy (identical to `mcp.json`) retained for existing installs that consumed the plugin from this repo's root; keep the two in sync until the root compat surface is removed.
 
+OpenCode V1 and V2 generate native `opencode.json` files from `mcp.json`. V1 places `sentry` directly under `mcp`; V2 places it under `mcp.servers`. Their installer harnesses use the corresponding CLI command to merge that entry into the user's global config.
+
 ## Key Conventions
 - All setup skills must **detect platform/SDK before suggesting configuration** — never assume
 - Sentry code review skill only processes comments from `sentry[bot]`, ignores other bots

README.md

@@ -6,7 +6,9 @@
 > [Claude Code](https://github.com/getsentry/plugin-claude),
 > [Cursor](https://github.com/getsentry/plugin-cursor),
 > [Codex](https://github.com/getsentry/plugin-codex),
-> [Grok](https://github.com/getsentry/plugin-grok), and
+> [Grok](https://github.com/getsentry/plugin-grok),
+> [OpenCode V1](https://github.com/getsentry/plugin-opencode),
+> [OpenCode V2](https://github.com/getsentry/plugin-opencode2), and
 > [Pi](https://github.com/getsentry/plugin-pi) — install one of those, not this
 > repo. They're also served over HTTP at
 > [skills.sentry.dev](https://skills.sentry.dev) for agents to fetch directly.
@@ -17,7 +19,7 @@ Your AI coding assistant already knows how to write code. This plugin teaches it
 
 Whether you're adding Sentry to a new project, debugging a spike in errors, or configuring alerts, just ask. The plugin gives your assistant the context it needs to do it right.
 
-Supports [**Claude Code**](https://github.com/getsentry/plugin-claude), [**Cursor**](https://github.com/getsentry/plugin-cursor), [**Codex**](https://github.com/getsentry/plugin-codex), [**Grok**](https://github.com/getsentry/plugin-grok), and [**Pi**](https://github.com/getsentry/plugin-pi).
+Supports [**Claude Code**](https://github.com/getsentry/plugin-claude), [**Cursor**](https://github.com/getsentry/plugin-cursor), [**Codex**](https://github.com/getsentry/plugin-codex), [**Grok**](https://github.com/getsentry/plugin-grok), [**Pi**](https://github.com/getsentry/plugin-pi), [**OpenCode V1**](https://github.com/getsentry/plugin-opencode), and [**OpenCode V2**](https://github.com/getsentry/plugin-opencode2).
 
 ## What You Can Do
 
@@ -67,6 +69,8 @@ exactly that agent's plugin:
 | Codex       | [`getsentry/plugin-codex`](https://github.com/getsentry/plugin-codex)    |
 | Grok        | [`getsentry/plugin-grok`](https://github.com/getsentry/plugin-grok)      |
 | Pi          | [`getsentry/plugin-pi`](https://github.com/getsentry/plugin-pi)          |
+| OpenCode V1 | [`getsentry/plugin-opencode`](https://github.com/getsentry/plugin-opencode) |
+| OpenCode V2 | [`getsentry/plugin-opencode2`](https://github.com/getsentry/plugin-opencode2) |
 
 These repositories are generated; do not edit them. Each one's README has the
 install instructions for that agent.
@@ -85,11 +89,11 @@ and swaps the skill tree's `disable-model-invocation` flags for Codex's
 ```bash
 git clone https://github.com/getsentry/sentry-for-ai.git
 cd sentry-for-ai
-src/plugins/codex/build.sh /tmp/sentry-codex   # or src/plugins/{claude,cursor,grok,pi}
+src/plugins/codex/build.sh /tmp/sentry-codex   # or src/plugins/{claude,cursor,grok,opencode,opencode2,pi}
 ```
 
 To build any target locally, run `src/plugins/<agent>/build.sh <output-dir>`
-(`claude`, `cursor`, `codex`, `grok`, or `pi`).
+(`claude`, `cursor`, `codex`, `grok`, `opencode`, `opencode2`, or `pi`).
 
 ## Skills
 

packages/installer/README.md

@@ -4,7 +4,7 @@ Install the [Sentry plugin](https://github.com/getsentry/sentry-for-ai) into you
 
 The plugin teaches your assistant Sentry — how to set it up in any project, how to find and fix production issues, and how to configure alerts, AI monitoring, and more. This package detects which assistants you have installed and wires the plugin into each one for you.
 
-Supports **Claude Code**, **Codex**, **Cursor**, **Grok**, and **Pi**.
+Supports **Claude Code**, **Codex**, **Cursor**, **Grok**, **OpenCode V1**, **OpenCode V2**, and **Pi**.
 
 ```bash
 npx @sentry/ai install
@@ -30,14 +30,16 @@ The non-interactive mode is intended for CI and unattended runs.
 
 ## What it installs
 
-For each detected assistant, the installer runs that tool's native plugin command:
+For each detected assistant, the installer uses its native package command or installs the generated skill bundle:
 
 | Assistant   | How it's installed                                                            |
 | ----------- | ----------------------------------------------------------------------------- |
 | Claude Code | `claude plugin install sentry` from the official plugin marketplace           |
 | Codex       | `codex plugin add sentry` from the Sentry plugin marketplace                  |
 | Cursor      | Clones [`getsentry/plugin-cursor`](https://github.com/getsentry/plugin-cursor) into `~/.cursor/plugins/local/sentry` |
 | Grok        | `grok plugin install getsentry/plugin-grok`                                   |
+| 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 |
 | Pi          | `pi install git:github.com/getsentry/plugin-pi`                               |
 
 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.
@@ -49,13 +51,15 @@ npx @sentry/ai remove                  # interactive — pick which agents to re
 npx @sentry/ai remove --no-interactive # remove from every agent that has it
 ```
 
-`uninstall` is an alias for `remove`. This only offers agents that currently have the plugin, and removes the Sentry plugin itself — each tool's plugin marketplace is left registered. Restart your AI tools afterward to drop the plugin.
+`uninstall` is an alias for `remove`. This only offers agents that currently have the plugin, and removes the Sentry plugin itself — each tool's plugin marketplace is left registered. OpenCode's CLIs do not provide an MCP remove command, so the installer identifies the config entry to delete manually. Restart your AI tools afterward to drop the plugin.
 
 ## Requirements
 
 - Node.js 18 or newer
 - The assistant CLI you want to set up must already be installed and on your `PATH`
-- `git` is required for the Cursor install
+- `git` is required for the Cursor and OpenCode installs
+
+OpenCode V1 and the OpenCode V2 beta use the same global config path but incompatible MCP shapes. When both `opencode` and `opencode2` are installed, the installer configures V2 only.
 
 ## License