convez.ai
SkillDesenvolvimento WebIntermediário
tomaspozo

Agent Link

tomaspozo/agentlink

Padrões Supabase opinionados para agentes IA construírem backends corretos na primeira tentativa

Ver no GitHub
BomPluginScore · de 0 a 100

Skill 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/agentlink

1 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

Estrelas
6
Forks
1
Acompanhando
0
Saúde
57%
Último commit
há 4 meses
Versão
v2.4.0
Issues abertas
0
Contribuidores
1

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 api schema. 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_cron and pgmq — no external job runners to operate.
  • Deploy-ready from day one. Local Docker or Supabase Cloud, local / dev / prod environments, 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. prod is added later with env add prod.
  • Skip the prompt: pass --local to go straight to local Docker.
  • Validate setup: npx agentlink-sh@latest check — verifies extensions, internal functions, vault secrets, the api schema, 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 database
  • npx 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-design
  • shadcn/ui
  • vercel-labs/agent-skills@vercel-react-best-practices
  • resend/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

Ver o original no GitHub

Bom para

Relacionados