agentlink

CLI for scaffolding Supabase apps with AI agents.

Install

npm install -g agentlink

Usage

Run the interactive wizard:

agentlink init

Or pass options directly:

agentlink init --name my-app
agentlink init --name my-app --skip-skills

What it does

1. Creates a new project directory
2. Installs the Supabase CLI (if not already installed)
3. Installs the Agent Link plugin
4. Configures Claude Code with MCP server and settings
5. Installs companion skills (Supabase best practices, frontend design, Vercel/Next.js)
6. Initializes a git repository
7. Launches Claude Code with your prompt

Template Architecture

Scaffolded projects get their files from src/template/supabase/, which mirrors the target directory structure. SQL files are loaded as text by esbuild's built-in text loader. Edge function .ts files are loaded as text by a custom esbuild plugin (see tsup.config.ts).

All template files are imported and registered in src/templates.ts:

• TEMPLATE_FILES — map of relative path → content, used by writeTemplateFiles()
• EXEC_SQL — subset of SQL that gets executed against the database during setup
• computeSetupHash() — integrity hash for the agentlink manifest

Files that depend on runtime values (config.toml, .env, seed SQL) are generated dynamically in src/supabase.ts and are not part of the template directory.

Adding a new scaffolded file

1. Create the file at its target path under src/template/supabase/ (e.g., src/template/supabase/functions/my-function/index.ts)
2. If it's a .ts file, add a type declaration in src/template.d.ts:

   declare module "./template/supabase/functions/my-function/index.ts" {
     const content: string;
     export default content;
   }

3. In src/templates.ts, add the import and register it in TEMPLATE_FILES:

   import myFunction from "./template/supabase/functions/my-function/index.ts";
   // ...
   "functions/my-function/index.ts": myFunction,

4. If the file is SQL that needs to be executed against the database during setup, also add it to the EXEC_SQL object and call it from scaffold.ts.

Development

npm install
npm run build
npm run dev   # watch mode