>_

THE CLI

Start. Build. Ship.

One CLI for the whole project.

Start a production-ready Supabase project in one command — then keep building: run migrations, manage environments, and deploy to production, all from the same CLI.

StartMigrateEnvironmentsDeploy
Get started →

DAY ONE

The Foundation, Ready to Build On.

The first command sets up everything deterministic so your agent can focus on what requires reasoning. Everything after — migrations, environments, deploys — runs through the same CLI.

Supabase Project

Local Docker or Supabase Cloud — auto-configured with extensions, schema isolation, and API settings.

Database Schemas

Tables, RPC functions, triggers, and indexes. Separate api and public schemas from day one.

Auth & Multi-tenancy

Auth hooks, profiles, tenants, memberships, invitations, and RLS policies — all wired together.

Edge Functions

Queue worker, email sending, and shared utilities with the withSupabase auth wrapper pre-configured.

Frontend

React with TanStack Router, Supabase client, auth UI, theme switcher, and RPC-first data access.

AI Agent Tooling

Claude Code plugin with 5 domain skills, MCP server, and a builder agent that knows the architecture.

COMMANDS

Your Toolkit.

Scaffold, develop, manage environments, and deploy — all from one CLI.

Every command runs via npx agentlink-sh@latest — no install step, always the latest version.

Getting Started

$ npx agentlink-sh@latest

Interactive wizard — scaffold a new project (no install step)

$ npx agentlink-sh@latest my-app

Scaffold a named project

$ npx agentlink-sh@latest my-app --prompt "Build a CRM"

Create with a prompt for the agent

$ npx agentlink-sh@latest my-app --local

Use local Docker instead of Cloud

Database

$ npx agentlink-sh@latest db apply

Apply schema files to database

$ npx agentlink-sh@latest db migrate <name>

Generate migration from schema diff

$ npx agentlink-sh@latest db types

Generate TypeScript types

$ npx agentlink-sh@latest db sql "SELECT ..."

Run ad-hoc SQL queries

Environments

$ npx agentlink-sh@latest env add prod

Connect a production environment

$ npx agentlink-sh@latest env use local

Switch active dev environment

$ npx agentlink-sh@latest env list

List all environments

Deploy

$ npx agentlink-sh@latest env deploy

Deploy schema, edge functions, and secrets

$ npx agentlink-sh@latest env deploy --dry-run

Preview changes without applying

$ npx agentlink-sh@latest env add prod --setup-ci

Connect prod + scaffold GitHub Actions workflow

More Flags

--no-frontendBackend only
--linkLink existing project
--resumeResume failed scaffold
--no-skillsSkip companion skills
--non-interactiveCI/CD mode
--debugWrite debug log

THE FIRST RUN

From Zero to Building.

The first run is the only time you wait. From there, the CLI stays with you for every schema change, environment switch, and deploy. Resume support means interrupted scaffolds pick up where they left off.

terminal

$ npx agentlink-sh@latest my-app

Setting up your project...

Check prerequisites

Supabase CLI and pgdelta come bundled with agentlink-sh — no manual install. Local mode also checks for psql and Docker.

Initialize Supabase

Creates project structure, config.toml, and schema files

Start Supabase

Spins up Docker locally or creates a Cloud project

Setup database

Applies schemas, extensions, queues, auth hooks, and generates migrations

Scaffold frontend

Writes React with TanStack Router files with Supabase client pre-wired

Install agent tooling

Claude Code plugin, 5 domain skills, MCP server, and CLAUDE.md

Launch Claude Code

Opens your project with the agent ready to build

Two Modes. Same Result.

Cloud

Default

Creates a Supabase Cloud project. No Docker required.

  • ▸OAuth authentication
  • ▸Auto-detected region
  • ▸Connection pooler
  • ▸Deploy-ready from day one

Local

Runs Supabase in Docker via supabase start.

  • ▸Works offline
  • ▸Full psql access
  • ▸MCP server for Claude Code
  • ▸Exact production parity

PROJECT STRUCTURE

What Gets Created.

project
my-app/├── supabase/│   ├── config.toml│   ├── schemas/│   │   ├── _schemas.sql          # api schema + role grants│   │   ├── public/│   │   │   ├── profiles.sql      # user profiles + RLS│   │   │   ├── multitenancy.sql  # tenants + memberships│   │   │   ├── _auth_tenant.sql  # tenant auth helpers│   │   │   └── _internal_admin.sql│   │   └── api/│   │       ├── profile.sql       # profile RPCs│   │       └── tenant.sql        # tenant RPCs│   ├── migrations/               # auto-generated│   └── functions/│       ├── _shared/              # withSupabase, types│       ├── queue-worker/         # PGMQ handler│       └── send-email/           # email templates├── src/                          # React with TanStack Router├── .env.local                    # API keys + DB URL├── CLAUDE.md                     # agent instructions└── agentlink.json                # project manifest

One CLI. From day one to production.

Get started →

Works on macOS, Linux, Windows, and Node.