Supabase Extension for Gemini CLI

The Supabase extension for Gemini CLI gives Gemini the tools, skills, and context needed to work effectively with Supabase projects.

Installation

gemini extensions install https://github.com/supabase-community/gemini-extension

What's Included

• MCP Server — Remote connection to the Supabase MCP server for project management, SQL execution, migrations, and more
• Skills — Agent skills from supabase/agent-skills (e.g. postgres-best-practices)
• Context — SUPABASE.md with CLI usage patterns and best practices

Development

Install development tools with mise:

mise install

This repo uses a git submodule for shared agent skills.

After cloning, initialize the submodule:

git submodule update --init --recursive

To test locally:

gemini extensions install .

To update the submodule:

git submodule update --remote submodules/agent-skills
git add submodules/agent-skills
git commit -m "chore: update agent-skills submodule"

Releasing

This repo uses Release Please for automated releases.

1. Merge commits with feat: or fix: prefixes to trigger a release (see How should I write my commits?)
2. Release Please opens a "Release PR" with version bump and changelog
3. Merge the Release PR to publish
4. supabase-gemini-extension.tar.gz is uploaded to the GitHub release

Note: Release Please is configured to only bump patch versions (0.1.x) until project is more stable.