Skip to content

Commit c97aaf3

Browse files
Rodriguespnclaude
andcommitted
refactor: frame .plugin as vendor-neutral Open Plugin, not VS Code
`.plugin/plugin.json` is the Open Plugin format, which any agent host can consume — VS Code is just its first consumer. Verified against VS Code 1.128.1: it only auto-detects three shared manifests (.plugin, .claude-plugin, bare plugin.json) and has no VS Code-only manifest path. - Rename agents/vscode/ -> agents/open-plugin/ and set X-Source-Name to `open-plugin` (was `vscode-plugin`), since the header is part of a neutral format rather than a VS Code-specific surface. - Neutralize the .plugin manifest description. - VS Code installs remain attributable server-side via the MCP `clientInfo` (`vscode_agent_host`) sent on initialize. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 833cee3 commit c97aaf3

5 files changed

Lines changed: 10 additions & 9 deletions

File tree

.plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "supabase",
33
"version": "0.1.12",
4-
"description": "Supabase tools for VS Code agent plugins — MCP server for managing your Supabase projects and skills to guide you through every stage of building with Supabase.",
4+
"description": "Official Supabase plugin in the vendor-neutral Open Plugin format with bundled Supabase skills and MCP access for project management, database work, auth, storage, and Postgres best practices.",
55
"author": {
66
"name": "Supabase",
77
"email": "support@supabase.io"
@@ -22,5 +22,5 @@
2222
"rls"
2323
],
2424
"skills": "./skills/",
25-
"mcpServers": "./agents/vscode/.mcp.json"
25+
"mcpServers": "./agents/open-plugin/.mcp.json"
2626
}

AGENTS.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,8 @@ Keep this repository focused on the shared multi-vendor plugin layout:
1010
- `.cursor-plugin/plugin.json` defines the Cursor plugin surface
1111
- `.codex-plugin/plugin.json` defines the Codex plugin surface
1212
- `.github/plugin/plugin.json` defines the GitHub Copilot plugin surface
13-
- `.plugin/plugin.json` defines the vendor-neutral open-plugin surface that VS Code auto-detects (see below)
14-
- `agents/claude/.mcp.json`, `agents/cursor/mcp.json`, `agents/codex/.app.json`, `agents/copilot/.mcp.json`, and `agents/vscode/.mcp.json` hold agent-specific MCP config files
13+
- `.plugin/plugin.json` defines the vendor-neutral [Open Plugin](https://open-plugins.com/) surface (consumed by VS Code today, and by any other Open Plugin host)
14+
- `agents/claude/.mcp.json`, `agents/cursor/mcp.json`, `agents/codex/.app.json`, `agents/copilot/.mcp.json`, and `agents/open-plugin/.mcp.json` hold agent-specific MCP config files
1515
- `gemini-extension.json` defines the Gemini extension manifest
1616
- `skills/` contains the shipped, real skill files consumed by the supported plugin surfaces
1717

@@ -53,9 +53,10 @@ Known vendor documentation pages:
5353
- https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-plugin-reference
5454
- Gemini CLI:
5555
- https://geminicli.com/docs/extensions/writing-extensions/
56-
- VS Code:
56+
- Open Plugin format (`.plugin/plugin.json`, consumed by VS Code):
57+
- https://open-plugins.com/
5758
- https://code.visualstudio.com/docs/agent-customization/agent-plugins
58-
- Auto-detects `.plugin/plugin.json` first; uses the vendor-neutral open-plugin manifest pointing at `agents/vscode/.mcp.json`. Installable via **Chat: Install Plugin From Source**.
59+
- `.plugin/plugin.json` is the vendor-neutral Open Plugin manifest, not a VS Code-specific format. VS Code (verified against `1.128.1`) only auto-detects three shared manifests — `.plugin/plugin.json`, then `.claude-plugin/plugin.json`, then a bare `plugin.json` — and has no VS Code-only manifest path. Because the format is neutral, its MCP config (`agents/open-plugin/.mcp.json`) uses `X-Source-Name: open-plugin`. VS Code installs are still distinguishable server-side: VS Code sends `clientInfo.name: "vscode_agent_host"` in the MCP `initialize` handshake. Installable via **Chat: Install Plugin From Source**.
5960

6061
For vendors listed above, read the official documentation pages for the vendor you are working on and follow the plugin structure required by those docs.
6162

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Per-vendor plugin manifests and MCP adapters:
2323
| Codex ||
2424
| GitHub Copilot ||
2525
| Gemini ||
26-
| VS Code | |
26+
| VS Code (Open Plugin) ||
2727

2828

2929
## Notes
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
"type": "http",
55
"url": "https://mcp.supabase.com/mcp",
66
"headers": {
7-
"X-Source-Name": "vscode-plugin",
7+
"X-Source-Name": "open-plugin",
88
"X-Source-Version": "0.1.12"
99
}
1010
}

release-please-config.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@
5252
},
5353
{
5454
"type": "json",
55-
"path": "agents/vscode/.mcp.json",
55+
"path": "agents/open-plugin/.mcp.json",
5656
"jsonpath": "$.mcpServers.supabase.headers[\"X-Source-Version\"]"
5757
},
5858
{

0 commit comments

Comments
 (0)