Agent Link
tomaspozo/agentlink
Padrões Supabase opinionados para agentes IA construírem backends corretos na primeira tentativa
Ver no GitHubSkill para Claude Code que ensina agentes de IA a construir aplicações full-stack com Supabase seguindo padrões opinionados e production-ready. Integra database, RPC, autenticação, edge functions e frontend em uma arquitetura única, reduzindo erros e tokens gastos.
Instalação
npx convez-ai tomaspozo/agentlink1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Geração de aplicações full-stack com IA
- Ferramentas internas e software operacional
- Sistemas multi-tenant com RLS automático
- Pipelines de automação com edge functions e cron jobs
Veredito

Ferramenta bem estruturada que resolve um problema real: fazer agentes de IA gerarem backends Supabase consistentes e seguros. A abordagem opinionada (RPC-first, RLS obrigatório, isolamento de schema) é sólida para produção, mas exige disciplina arquitetural e conhecimento prévio de Supabase para tirar máximo proveito.
README
A tradução para o português deste README ainda está na fila.
Agent Link
An opinionated skill set that tells your AI agents exactly how to build on Supabase.
Production-ready Supabase patterns, optimized so agents get it right on the first try. Fewer errors. Fewer wasted tokens. One backend that serves every client.
Website · CLI on npm · Report an issue
Agent Link is a Claude Code plugin — a builder agent plus six composable skills — that teaches AI agents a single, opinionated architecture for full-stack apps on Supabase. Instead of letting the model improvise a different backend every time, it gives it one well-worn path: schema isolation, RPC-first data access, RLS on every table, edge functions for the outside world, and Postgres-native background jobs.
It ships with the agentlink-sh CLI — the plugin's hands. The agent reasons about what to build; the CLI does the work the agent shouldn't do itself: OAuth, project creation, applying schemas, generating migrations, switching environments, and deploying. Designed for internal tools, business software, and operational apps.
Why Agent Link
- DB Functions, not raw queries. All data access goes through Postgres functions exposed as RPCs in an
apischema. Tables stay invisible to clients — one backend serves every frontend. - Secure by default. Schema isolation, row-level security on every table, no exceptions. The patterns are default-deny, so a forgotten grant fails fast instead of leaking.
- Multi-tenancy built in. Tenants, memberships, invitations, RBAC, and tenant-isolation RLS are wired together from day one.
- Edge functions for externals. Webhooks, third-party APIs, and anything outside the database run in typed Deno edge functions via
withSupabase. - Cron + queues in Postgres. Background work runs on
pg_cronandpgmq— no external job runners to operate. - Deploy-ready from day one. Local Docker or Supabase Cloud,
local/dev/prodenvironments, diff-based migrations, and exact production parity. - Tuned for agents. Every pattern is shaped so the model lands it on the first try — less back-and-forth, fewer tokens.
Get started
Scaffold a new project (recommended)
One command runs an interactive wizard — no install step. It creates the project, wires up the database, installs the plugin and companion skills, configures Claude Code, and hands off to the agent with your prompt:
npx agentlink-sh@latest my-app
The wizard asks where your first environment should live — Supabase Cloud (no Docker) or local Docker — and sets it up for you. To skip the prompt and go straight to local Docker:
npx agentlink-sh@latest my-app --local
Then just describe what you want to build and let the agent take it from there.
Add the plugin to an existing setup
Already have a project? Install the plugin from the Claude Code marketplace:
/plugin marketplace add tomaspozo/agentlink
/plugin install link@agentlink
For local development of the plugin itself, point Claude Code at this directory:
claude --plugin-dir ./agent
Every CLI command runs through npx agentlink-sh@latest <subcommand> — e.g. npx agentlink-sh@latest check, db apply, env deploy prod.
Usage
Open Claude Code and start prompting the agent — describe what you want and it takes it from there, loading the right skills, writing the SQL and TypeScript, applying the changes, and iterating until it works.
Build something new — e.g. an internal tool with public form submissions:
Build an internal tool where the public can submit support requests through a
form, and our team triages them in a dashboard behind auth.
Harden what you already have — e.g. lock down an existing project with schema isolation:
Optimize my project's security: move everything behind an api schema, put RLS on
every table, and replace the direct table access with RPCs.
How it works
The CLI owns setup; the agent builds.
- New project:
npx agentlink-sh@latest my-app— runs the wizard, which asks whether your first (dev) environment is Supabase Cloud or local Docker, then scaffolds schemas, vault secrets, edge functions, and a React + TanStack Start (SPA) frontend.prodis added later withenv add prod. - Skip the prompt: pass
--localto go straight to local Docker. - Validate setup:
npx agentlink-sh@latest check— verifies extensions, internal functions, vault secrets, theapischema, and file layout. - After a CLI upgrade:
npx agentlink-sh@latest --force-update— re-applies managed templates, config, and SQL.
In cloud mode the CLI authenticates via OAuth, creates the project in your chosen org/region, and runs database operations through the Supabase Management API. In local mode SQL runs via psql against localhost:54322 and a Supabase MCP server is installed for migration and advisor tooling.
Production guardrail
The agent works autonomously against local and dev — db apply and env deploy to dev run without prompting. Production is gated: any command targeting prod requires explicit user approval at call time, per command — never a blanket pass.
Blocked commands
A PreToolUse hook (hooks/block-destructive-db.sh) stops the agent from running:
npx supabase db reset— destroys and recreates the local databasenpx supabase db push --force/-f— overwrites remote schema without diffing
Run these yourself in a terminal if you really need them.
Companion skills
The CLI installs a curated set of companion skills automatically — the agent assumes they're present. Pass --no-skills to skip auto-install.
supabase/agent-skills@supabase-postgres-best-practices(required)supabase/server(required)anthropics/skills@frontend-designshadcn/uivercel-labs/agent-skills@vercel-react-best-practicesresend/react-email,resend/email-best-practices,resend/resend-skills
Install or update one manually with the skills CLI:
npx skills add supabase/agent-skills@supabase-postgres-best-practices
License
MIT