fcakyon/claude-codex-settings / plugins/supabase-skills/skills/supabase-cli
supabase-cli
FlaggedThis skill should be used when user asks to "use supabase CLI", "supabase init", "supabase start", "run migrations", "deploy edge functions", "manage Supabase project", or works with the supabase command-line tool for local development and project management.
references/overview.md
View on GitHub<p align="center">
<a href="https://supabase.com">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./docs/assets/supabase-cli-wordmark-dark.svg">
<img src="./docs/assets/supabase-cli-wordmark-light.svg" alt="Supabase CLI" width="360">
</picture>
</a>
</p>
<p align="center">
Develop locally and deploy to the Supabase Platform from your terminal.
</p>
<p align="center">
<a href="https://www.npmjs.com/package/supabase"><img alt="npm" src="https://img.shields.io/npm/v/supabase?style=flat-square&color=3ECF8E"></a>
<a href="https://github.com/supabase/cli/actions/workflows/test.yml"><img alt="Build" src="https://img.shields.io/github/actions/workflow/status/supabase/cli/test.yml?branch=develop&label=build&style=flat-square&color=3ECF8E"></a>
<a href="https://www.npmjs.com/package/supabase"><img alt="License" src="https://img.shields.io/npm/l/supabase.svg?style=flat-square&color=3ECF8E"></a>
<a href="https://discord.supabase.com"><img alt="Discord" src="https://img.shields.io/discord/839993398554656828?label=discord&style=flat-square&color=3ECF8E"></a>
</p>
---
Supabase CLI brings the Supabase Platform to your terminal. Run the full local stack, manage database migrations, deploy Edge Functions, generate types, and automate project workflows.
## Installation
```sh
# YOLO
curl -fsSL https://raw.githubusercontent.com/supabase/cli/main/install | bash
# npm
npm install -D supabase # or bun/pnpm/yarn add -D supabase
npm install -D supabase@beta # beta channel
# macOS and Linux
brew install supabase/tap/supabase # always up to date
brew install supabase # official formula, may be delayed
brew install supabase/tap/supabase-beta # beta channel
# Windows
scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
scoop install supabase
scoop install supabase-beta # beta channel
# Linux packages
# Download .apk, .deb, .rpm, or .pkg.tar.zst from GitHub Releases.
```
Linux packages are available from [Releases](https://github.com/supabase/cli/releases). Community-maintained packages are also available through [pkgx](https://pkgx.sh/) and [Nixpkgs](https://nixos.org/).
## Start Local Development
Create a Supabase workspace and start the local stack:
```sh
supabase init
supabase start
supabase status
```
The local stack includes Postgres, Auth, Realtime, Storage, Edge Functions, and the Supabase APIs.
Start from a template:
```sh
supabase bootstrap
```
## Link A Project
Connect your local workspace to a hosted Supabase project:
```sh
supabase login
supabase link
```
## Manage Your Database
Create migrations, compare schemas, and apply changes locally or to your linked project:
```sh
supabase migration new create_profiles
supabase db diff
supabase db push
supabase db reset
```
## Deploy Edge Functions
Build, serve, and deploy functions from the same project workspace:
```sh
supabase functions new hello-world
supabase functions serve
supabase functions deploy hello-world
```
## Generate Types
Generate TypeScript types from your local database or linked project:
```sh
supabase gen types --local
supabase gen types --linked
```
## Reference
Use `--help` on any command to explore flags and examples:
```sh
supabase db --help
supabase functions deploy --help
```
- [CLI reference](https://supabase.com/docs/reference/cli/about)
- [Local development guide](https://supabase.com/docs/guides/local-development)
- [Supabase docs](https://supabase.com/docs)
## Developing
This repository is a pnpm monorepo. The published package lives in `apps/cli`.
```sh
pnpm install
pnpm check:all
cd apps/cli
pnpm types:check
pnpm run test:unit && pnpm run test:integration
```
Useful source entry points:
| Path | Purpose |
| ----------------- | ------------------------------------ |
| `apps/cli` | TypeScript/Bun CLI package |
| `apps/cli-go` | Go CLI source used by the CLI |
| `packages/stack` | Local Supabase stack runtime |
| `packages/config` | Config schema and generated types |
| `packages/api` | Typed Supabase Management API client |
After a fresh clone, install the reference repositories used for agent and developer inspection:
```sh
pnpm repos:install
```
## Contributing
We love focused pull requests with a clear problem, a small surface area, and tests that match the user-facing behavior.
Open an issue first and wait for a maintainer to add the `open-for-contribution` label before starting work — external pull requests that don't link a labeled, open issue are closed automatically. See [CONTRIBUTING.md](./CONTRIBUTING.md#contribution-workflow) for the full workflow.
Before opening a PR, run repo-wide quality checks from the repository root,
then run the relevant package tests from each workspace you touched. For each
touched TypeScript workspace (or any workspace that declares it), also run its
`pnpm types:check` script. For example:
```sh
# From the repository root:
pnpm check:all
# From apps/cli (a touched TypeScript workspace):
cd apps/cli
pnpm types:check
pnpm run test:unit && pnpm run test:integration
# Repeat the relevant package tests for every touched workspace; run
# pnpm types:check there too when that workspace declares the script.
```
PR titles must use conventional commits, for example:
```text
fix(cli): handle linked projects without cached service versions
```
## License
Supabase CLI packages are released under the MIT license.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |