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.
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.
Getting Started
$ agentlinkInteractive wizard — scaffold a new project
$ agentlink my-app --prompt "Build a CRM"Create with a prompt for the agent
$ agentlink my-app --localUse local Docker instead of Cloud
Database
$ agentlink db applyApply schema files to database
$ agentlink db migrate <name>Generate migration from schema diff
$ agentlink db typesGenerate TypeScript types
$ agentlink db sql "SELECT ..."Run ad-hoc SQL queries
Environments
$ agentlink env add prodConnect a production environment
$ agentlink env use localSwitch active dev environment
$ agentlink env listList all environments
Deploy
$ agentlink deployDeploy schema, edge functions, and secrets
$ agentlink deploy --dry-runPreview changes without applying
$ agentlink deploy --setup-ciScaffold GitHub Actions workflow
More Flags
--no-frontendBackend only--linkLink existing project--resumeResume failed scaffold--no-skillsSkip companion skills--non-interactiveCI/CD mode--debugWrite debug logTHE 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.
$ npm init agentlink@latest
Setting up your project...
Check prerequisites
Verifies Supabase CLI, psql, and pg-delta are installed
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
DefaultCreates 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.
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.
Works on macOS, Linux, Windows, and Node.