Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ jobs:
run: |
tar -czvf "supabase-plugin.tar.gz" --dereference \
.claude-plugin/ .cursor-plugin/ .codex-plugin/ .kimi-plugin/ \
.github/plugin/ agents/ \
.github/plugin/ .plugin/ agents/ \
gemini-extension.json SUPABASE.md \
skills/ assets/ || exit 1

Expand Down
26 changes: 26 additions & 0 deletions .plugin/plugin.json
Comment thread
gregnr marked this conversation as resolved.
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
{
"name": "supabase",
"version": "0.1.12",
"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.",
"author": {
"name": "Supabase",
"email": "support@supabase.io"
},
"repository": "https://github.com/supabase-community/supabase-plugin",
"license": "MIT",
"keywords": [
"supabase",
"postgres",
"database",
"backend",
"mcp",
"auth",
"storage",
"realtime",
"edge-functions",
"migrations",
"rls"
],
"skills": "./skills/",
"mcpServers": "./agents/open-plugin/.mcp.json"
}
10 changes: 7 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# AGENTS.md

This repository is the plugin distribution repo for Supabase across Claude Code, Cursor, Codex, GitHub Copilot, Gemini, and Kimi Code.
This repository is the plugin distribution repo for Supabase across Claude Code, Cursor, Codex, GitHub Copilot, Gemini, Kimi Code, and the vendor-neutral Open Plugin format (consumed by VS Code).

These vendors are installable through the vendor-neutral [`plugins`](https://github.com/vercel-labs/plugins) CLI, which translates the shared plugin layout into each target's native format:

Expand All @@ -17,7 +17,8 @@ Keep this repository focused on the shared multi-vendor plugin layout:
- `.codex-plugin/plugin.json` defines the Codex plugin surface
- `.kimi-plugin/plugin.json` defines the Kimi Code plugin surface (with its MCP server declared inline)
- `.github/plugin/plugin.json` defines the GitHub Copilot plugin surface
- `agents/claude/.mcp.json`, `agents/cursor/mcp.json`, `agents/codex/.app.json`, and `agents/copilot/.mcp.json` hold agent-specific MCP config files
- `.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)
- `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
- `gemini-extension.json` defines the Gemini extension manifest
- `skills/` contains the shipped, real skill files consumed by the supported plugin surfaces

Expand All @@ -33,7 +34,7 @@ npx claude plugin validate .claude-plugin/plugin.json

## Editing Rules

- Do not move `skills/`, `agents/`, `.claude-plugin/plugin.json`, `.cursor-plugin/plugin.json`, `.codex-plugin/plugin.json`, or `.kimi-plugin/plugin.json` out of the repo root layout.
- Do not move `skills/`, `agents/`, `.claude-plugin/plugin.json`, `.cursor-plugin/plugin.json`, `.codex-plugin/plugin.json`, `.kimi-plugin/plugin.json`, or `.plugin/plugin.json` out of the repo root layout.
- Do not replace `skills/` with a symlink or submodule reference.
- Keep the plugin name stable as `supabase` unless there is a deliberate migration plan.
- When changing descriptions or keywords, update all relevant `plugin.json` files together.
Expand Down Expand Up @@ -63,6 +64,9 @@ Known vendor documentation pages:
- https://www.kimi.com/code
- https://www.kimi.com/code/docs/en/kimi-code-cli/customization/plugins.html
- Installed via the `plugins` CLI into Kimi's native plugin store; uses `.kimi-plugin/plugin.json` with skills, commands, hooks, and MCP servers (no agents or LSP support). MCP servers must be declared inline — Kimi does not resolve external file references.
- Open Plugin:
- https://open-plugins.com/
- Vendor-neutral plugin manifest (`.plugin/plugin.json`) that any Open Plugin host can consume. Its MCP config lives in `agents/open-plugin/.mcp.json` with a generic `X-Source-Name: open-plugin`; individual clients are distinguished server-side by client name.
- `plugins` CLI (vendor-neutral installer):
- https://github.com/vercel-labs/plugins

Expand Down
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Supabase Agent Plugin

Official Supabase plugin distribution repo for Claude Code, Cursor, Codex, GitHub Copilot, and Gemini. It bundles:
Official Supabase plugin distribution repo for Claude Code, Cursor, Codex, GitHub Copilot, Gemini, and VS Code. It bundles:

> Want to contribute? Read [CONTRIBUTING.md](CONTRIBUTING.md) first.

Expand All @@ -23,6 +23,7 @@ Per-vendor plugin manifests and MCP adapters:
| Codex | ✓ |
| GitHub Copilot | ✓ |
| Gemini | ✓ |
| VS Code (Open Plugin) | ✓ |


## Notes
Expand Down
12 changes: 12 additions & 0 deletions agents/open-plugin/.mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"mcpServers": {
"supabase": {
"type": "http",
"url": "https://mcp.supabase.com/mcp",
"headers": {
"X-Source-Name": "open-plugin",
"X-Source-Version": "0.1.12"
}
}
}
}
10 changes: 10 additions & 0 deletions release-please-config.json
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,11 @@
"path": ".github/plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": ".plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": "gemini-extension.json",
Expand All @@ -55,6 +60,11 @@
"path": "agents/copilot/.mcp.json",
"jsonpath": "$.mcpServers.supabase.headers[\"X-Source-Version\"]"
},
{
"type": "json",
"path": "agents/open-plugin/.mcp.json",
"jsonpath": "$.mcpServers.supabase.headers[\"X-Source-Version\"]"
},
{
"type": "json",
"path": "gemini-extension.json",
Expand Down
Loading