Files
supabase/apps/docs/content/guides/ai-tools/plugins.mdx
Pedro Rodrigues 8a37784b05 docs: add plugins package quick install for AI coding agent plugin (#47961)
## Summary
- Adds the Vercel [`plugins`](https://www.npmjs.com/package/plugins) npm
package as the default, single-command install option (`npx plugins add
supabase-community/supabase-plugin`) on the Supabase AI coding agent
plugin docs page.
- Keeps the existing per-agent manual installation instructions
available below, as an alternative.

Closes AI-929.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Documentation**
  * Added a quick-install option for the plugin using a single command.
  * Documented the `--yes` flag for skipping the confirmation prompt.
* Updated the manual installation guidance to follow the new
quick-install instructions.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-07-15 15:21:29 +01:00

55 lines
3.1 KiB
Plaintext

---
id: 'ai-tools-plugins'
title: 'Supabase Plugin for AI Coding Agents'
subtitle: 'One-click setup for Supabase in your AI coding agent'
description: 'The Supabase plugin for AI coding agents bundles the MCP server and agent skills into a single install for your AI coding agent.'
sidebar_label: 'Supabase Plugin for AI Coding Agents'
---
The Supabase Plugin for AI Coding Agents is a single install that gives your AI coding agent everything it needs to work with Supabase. It bundles the [Supabase MCP server](/docs/guides/getting-started/mcp) and [Supabase agent skills](/docs/guides/getting-started/ai-skills) so your agent can query your database, manage migrations, deploy Edge Functions, and follow Supabase and Postgres best practices — without manual configuration.
## Why use the plugin?
Plugins for AI coding agents are packages of AI agent extensions. A single plugin can bundle any combination of:
- **MCP servers** — external tool integrations that let your agent interact with services like Supabase
- **Skills** — procedural knowledge and context your agent loads on demand to work more accurately
- **Hooks** — event handlers that run at agent lifecycle points (e.g. before or after a tool call)
- **Agents** — specialized sub-agents with specific personas and tool configurations
- **Slash commands** — custom commands you can invoke directly in chat
Bundling the [MCP server](/docs/guides/getting-started/mcp) and [agent skills](/docs/guides/getting-started/ai-skills) into a single plugin means you can set up both in one step. You can also install them separately if you prefer. You can install the plugin globally to use it across all your projects, or per project to keep it isolated.
## Installation
### Quick install
The [`plugins`](https://www.npmjs.com/package/plugins) package installs the Supabase plugin into any supported AI coding agent with a single command. It auto-detects which agent tools you have installed and installs the plugin to all of them.
```bash
npx plugins add supabase-community/supabase-plugin
```
Add the `--yes` flag to install the Supabase plugin without the confirmation prompt/UI.
### Manual install
Alternatively, choose your AI coding agent and follow the installation steps:
<AgentPluginsPanel />
## What's included
### Supabase MCP server
The [Supabase MCP server](/docs/guides/getting-started/mcp) connects your AI coding agent directly to your Supabase projects. Once authenticated, your agent can query your database, manage migrations, deploy Edge Functions, and more — see the [full list of available tools](/docs/guides/getting-started/mcp#available-tools).
### Supabase agent skills
Skills provide your agent with Supabase-specific procedural knowledge:
- **`supabase`** — Core guidance for working with Supabase products (Database, Auth, Edge Functions, Storage, Realtime)
- **`supabase-postgres-best-practices`** — Postgres query optimization, schema design, connection management, and RLS patterns
For a full list of available skills and supported agents, see [Agent Skills](/docs/guides/getting-started/ai-skills).