supabase-cli

Manage Supabase CLI workflows for local environments, migrations, and TypeScript types.

2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/NagyVikt/codex-plugins --skill supabase-cli-nagyvikt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: supabase-cli
Source: https://github.com/NagyVikt/codex-plugins/tree/main/plugins/supabase/skills/cli
Command: npx skills add https://github.com/NagyVikt/codex-plugins --skill supabase-cli-nagyvikt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the complexity of managing local Supabase development environments, database migrations, and schema synchronization by providing a structured interface for CLI operations.

Core Features & Use Cases

  • Local Stack Management: Quickly start, stop, and verify the health of your local Supabase Docker-based environment.
  • Migration Workflow: Safely create, push, and pull database migrations to keep your local and remote schemas in sync.
  • Type Generation: Automatically generate TypeScript types from your database schema to ensure type safety across your frontend and backend.

Quick Start

Use the supabase-cli skill to initialize a new project and start the local development stack.

Frequently Asked Questions about supabase-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage local Supabase database migrations and schema synchronization?

To manage Supabase database migrations, you can use a structured CLI interface to safely create, push, and pull migrations, keeping your local and remote schemas synchronized. It also handles project linking and schema resets with safety guardrails.

Do I need Docker to run a local Supabase development environment?

Yes, you need Docker to run a local Supabase development environment. The local stack is Docker-based, requiring a local Docker installation and a valid Supabase project configuration file to execute commands for starting, stopping, and verifying environment health.

How do I generate TypeScript types from a Supabase database schema?

You generate TypeScript types from a Supabase database schema by executing specific CLI workflows for type generation. This process automatically creates TypeScript types from your database schema to ensure type safety across your frontend and backend applications.

What is the best way to handle destructive database resets in Supabase?

The best way to handle destructive database resets in Supabase is through a CLI workflow that includes built-in safety guardrails. This structured approach prevents accidental data loss during local development and schema synchronization tasks.

Can I link my local Supabase environment to a remote project for schema tracking?

Yes, you can link your local Supabase environment to a remote project. The CLI workflow facilitates project linking and schema synchronization, allowing you to track database migrations and maintain consistency between local and remote environments.

Why does schema synchronization fail without a valid Supabase project configuration?

Schema synchronization fails without a valid Supabase project configuration because the CLI requires this file to establish a connection. Without proper configuration, the CLI cannot execute commands to manage the local environment lifecycle or track database migrations.