@dodopayments/opencode-plugin 0.2.0 → 0.3.1

package/README.md

@@ -26,13 +26,30 @@ The API MCP server uses browser OAuth by default, so no keys are required at ins
 
 ### Codex CLI
 
-Codex reads `.claude-plugin/marketplace.json` natively, so the same repo works:
+Codex installs plugins in two steps: register the marketplace from your shell, then install the plugin from inside the Codex TUI.
+
+1. Register the marketplace:
+
+    ```bash
+    codex plugin marketplace add dodopayments/dodo-agent-plugin
+    ```
+
+2. Open Codex and run the `/plugins` slash command:
+
+    ```bash
+    codex
+    ```
+
+    Then type `/plugins`, switch to the **Dodo Payments** marketplace, select the **dodopayments** plugin, and choose **Install plugin**.
+
+If you previously added the marketplace before this fix landed and the plugin doesn't appear under `/plugins`, refresh it:
 
 ```bash
-codex plugin marketplace add dodopayments/dodo-agent-plugin
-codex plugin install dodopayments@dodopayments
+codex plugin marketplace upgrade dodopayments
 ```
 
+> Codex CLI does not have a `codex plugin install` subcommand. Plugin installation always happens through the in-TUI `/plugins` flow ([official docs](https://developers.openai.com/codex/plugins)).
+
 ### Cursor
 
 Manual install:
@@ -45,29 +62,37 @@ Restart Cursor. The plugin loads skills from `.claude/skills/` (via Cursor's Cla
 
 ### OpenCode
 
-OpenCode distributes via npm. Add to your `opencode.json`:
+OpenCode distributes via npm. Add the plugin to your `opencode.json`:
 
 ```jsonc
 {
     "$schema": "https://opencode.ai/config.json",
+    "plugin": ["@dodopayments/opencode-plugin"]
+}
+```
+
+Restart OpenCode. Both MCP servers (`dodopayments-api`, `dodo-knowledge`) are registered automatically via the plugin's `config` hook, and the eight skills are auto-discovered from the installed package. No manual `mcp` block required.
+
+If you prefer the local stdio API server with your own API key instead of the default remote OAuth server, declare `dodopayments-api` yourself in `opencode.json` - your entry wins over the plugin default:
+
+```jsonc
+{
     "plugin": ["@dodopayments/opencode-plugin"],
     "mcp": {
         "dodopayments-api": {
             "type": "local",
-            "command": ["npx", "-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"],
-            "enabled": true
-        },
-        "dodo-knowledge": {
-            "type": "local",
-            "command": ["npx", "-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"],
+            "command": ["npx", "-y", "dodopayments-mcp@latest"],
+            "environment": {
+                "DODO_PAYMENTS_API_KEY": "dodo_test_...",
+                "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
+                "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
+            },
             "enabled": true
         }
     }
 }
 ```
 
-OpenCode auto-discovers the eight skills from the installed package. Restart OpenCode to pick up the new config.
-
 ## Included Skills
 
 | Skill | Description |

package/opencode-plugin/README.md

@@ -1,6 +1,6 @@
 # @dodopayments/opencode-plugin
 
-OpenCode plugin that ships the Dodo Payments agent skills and references the Dodo Payments API and docs MCP servers.
+Official OpenCode plugin for Dodo Payments. Ships eight integration skills and auto-registers two MCP servers.
 
 This package is part of [`dodopayments/dodo-agent-plugin`](https://github.com/dodopayments/dodo-agent-plugin) - the universal Dodo Payments plugin that also installs into Claude Code, Codex, and Cursor.
 
@@ -11,31 +11,50 @@ Add to your `opencode.json`:
 ```jsonc
 {
     "$schema": "https://opencode.ai/config.json",
+    "plugin": ["@dodopayments/opencode-plugin"]
+}
+```
+
+Restart OpenCode. That's it.
+
+- Both MCP servers are registered automatically via the plugin's `config` hook.
+- The eight skills are auto-discovered from this package's `skills/` directory.
+- The first call to `dodopayments-api` opens a browser for OAuth. `dodo-knowledge` needs no auth.
+
+## What you get
+
+Eight agent skills (auto-loaded when relevant): `best-practices`, `checkout-integration`, `subscription-integration`, `webhook-integration`, `usage-based-billing`, `credit-based-billing`, `license-keys`, `billing-sdk`.
+
+Two MCP servers (registered automatically):
+
+| Server | Purpose | Auth |
+|--------|---------|------|
+| `dodopayments-api` | Live API access (payments, subscriptions, customers, products, refunds, licenses, usage) | OAuth (browser) on first call |
+| `dodo-knowledge` | Semantic search over the Dodo Payments documentation | None |
+
+## Overriding the defaults
+
+The plugin registers MCPs with nullish-assign semantics, so anything you declare in your own `opencode.json` wins. Example - swap the default remote OAuth server for the local stdio server with your own API key:
+
+```jsonc
+{
     "plugin": ["@dodopayments/opencode-plugin"],
     "mcp": {
         "dodopayments-api": {
             "type": "local",
-            "command": ["npx", "-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"],
-            "enabled": true
-        },
-        "dodo-knowledge": {
-            "type": "local",
-            "command": ["npx", "-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"],
+            "command": ["npx", "-y", "dodopayments-mcp@latest"],
+            "environment": {
+                "DODO_PAYMENTS_API_KEY": "dodo_test_...",
+                "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
+                "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
+            },
             "enabled": true
         }
     }
 }
 ```
 
-Then restart OpenCode. The eight Dodo Payments skills are auto-discovered from this package's `skills/` directory.
-
-## What you get
-
-- **Eight agent skills** (auto-loaded by OpenCode when relevant):
-    - `best-practices`, `checkout-integration`, `subscription-integration`, `webhook-integration`, `usage-based-billing`, `credit-based-billing`, `license-keys`, `billing-sdk`.
-- **Two referenced MCP servers** (you configure them in `opencode.json` as shown above):
-    - `dodopayments-api` - live API access via OAuth.
-    - `dodo-knowledge` - semantic search over Dodo Payments documentation.
+`dodo-knowledge` continues to be registered by the plugin unless you declare it explicitly too.
 
 ## License
 

package/opencode-plugin/index.js

@@ -1,21 +1,9 @@
 // @dodopayments/opencode-plugin
 //
-// OpenCode plugin entry point for Dodo Payments.
-//
-// This plugin exists to make `@dodopayments/opencode-plugin` installable
-// from npm so users can reference it in their `opencode.json` "plugin" array.
-// It registers no runtime hooks - the value of this package is:
-//
-//   1. The bundled skills/ directory (OpenCode auto-discovers SKILL.md files
-//      from installed packages, so the 8 Dodo Payments skills become
-//      available once this package is installed).
-//
-//   2. The documented .mcp.json and opencode.json reference snippets, so
-//      users know exactly which MCP servers to add to their config.
-//
-// If future versions of this plugin need runtime behavior (e.g. injecting
-// Dodo-specific tools, hooking chat.message, etc.), add them to the returned
-// Hooks object. All Hooks fields are optional - see @opencode-ai/plugin types.
+// Registers the Dodo Payments MCP servers via OpenCode's `config` plugin
+// hook so users do not need to paste an `mcp: { ... }` block into their
+// `opencode.json`. The bundled skills/ directory is auto-discovered by
+// OpenCode separately.
 //
 // @see https://opencode.ai/docs/plugins
 // @see https://docs.dodopayments.com/developer-resources/agent-skills
@@ -24,7 +12,32 @@
  * @typedef {import("@opencode-ai/plugin").Plugin} Plugin
  */
 
+// OpenCode loads the user's opencode.json before invoking plugin `config`
+// hooks on the same mutable config object. Nullish-assign (`??=`) therefore
+// lets a user override any entry here by declaring the same key in their
+// own opencode.json - e.g. swapping the default remote OAuth server for the
+// local stdio `dodopayments-mcp` with their own API key.
+const DODO_MCP_SERVERS = {
+    "dodopayments-api": {
+        type: "local",
+        command: ["npx", "-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"],
+        enabled: true,
+    },
+    "dodo-knowledge": {
+        type: "local",
+        command: ["npx", "-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"],
+        enabled: true,
+    },
+};
+
 /** @type {Plugin} */
-const dodopayments = async () => ({});
+const dodopayments = async () => ({
+    config: async (config) => {
+        config.mcp ??= {};
+        for (const [name, entry] of Object.entries(DODO_MCP_SERVERS)) {
+            config.mcp[name] ??= entry;
+        }
+    },
+});
 
 export default dodopayments;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dodopayments/opencode-plugin",
-    "version": "0.2.0",
+    "version": "0.3.1",
     "description": "Dodo Payments skills and MCP server hints for OpenCode.",
     "type": "module",
     "main": "opencode-plugin/index.js",
@@ -11,7 +11,6 @@
         "opencode-plugin/",
         "skills/",
         ".mcp.json",
-        "opencode.json",
         "LICENSE"
     ],
     "scripts": {
@@ -36,7 +35,7 @@
         "type": "git",
         "url": "git+https://github.com/dodopayments/dodo-agent-plugin.git"
     },
-    "homepage": "https://docs.dodopayments.com/developer-resources/agent-skills",
+    "homepage": "https://docs.dodopayments.com",
     "bugs": "https://github.com/dodopayments/dodo-agent-plugin/issues",
     "peerDependencies": {
         "@opencode-ai/plugin": ">=1.0.0"

package/opencode.json

@@ -1,28 +0,0 @@
-{
-    "$schema": "https://opencode.ai/config.json",
-    "plugin": [
-        "@dodopayments/opencode-plugin"
-    ],
-    "mcp": {
-        "dodopayments-api": {
-            "type": "local",
-            "command": [
-                "npx",
-                "-y",
-                "mcp-remote@latest",
-                "https://mcp.dodopayments.com/sse"
-            ],
-            "enabled": true
-        },
-        "dodo-knowledge": {
-            "type": "local",
-            "command": [
-                "npx",
-                "-y",
-                "mcp-remote@latest",
-                "https://knowledge.dodopayments.com/mcp"
-            ],
-            "enabled": true
-        }
-    }
-}