supabase-quickstart

name	supabase.quickstart
description	Agent workflow for database migrations, edge functions, secrets, and storage management via Supabase CLI passthrough.
tags	supabase,database,postgres,migrations,edge-functions,secrets,storage,auth

supabase Quickstart

Use this when AI agents need to manage Supabase projects — database, migrations, functions, secrets, or storage.

1) Install plugin and dependency

supercli plugins learn supabase
npm install -g supabase
supabase --version
supercli plugins install ./plugins/supabase --on-conflict replace --json

2) Validate CLI wiring

supabase --version
supercli plugins doctor supabase --json

3) Core command patterns

Projects & Linking

supercli supabase projects list --json
supercli supabase link --project-ref <ref>

Database operations

# Local development
supercli supabase db start
supercli supabase db reset --local

# Remote (requires link)
supercli supabase db push --linked
supercli supabase db pull --linked
supercli supabase db diff --linked
supercli supabase db lint --local

Migrations

supercli supabase migration new create_users_table
supercli supabase migration list --local
supercli supabase migration list --linked
supercli supabase migration up --local
supercli supabase migration up --linked
supercli supabase migration down --