create-agentlink 0.2.0

package/.claude/settings.local.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "Bash(npm install:*)",
+      "Bash(npm run:*)",
+      "Bash(node:*)",
+      "Bash(npm view:*)",
+      "Bash(npx skills:*)",
+      "Bash(npx supabase:*)",
+      "Bash(npx create-next-app@latest:*)",
+      "Bash(npm search:*)",
+      "Bash(npm uninstall:*)",
+      "Bash(git:*)",
+      "Bash(supabase status:*)",
+      "Bash(claude plugin:*)"
+    ]
+  }
+}

package/README.md

@@ -0,0 +1,42 @@
+# agentlink
+
+CLI for scaffolding Supabase apps with AI agents.
+
+## Install
+
+```bash
+npm install -g agentlink
+```
+
+## Usage
+
+Run the interactive wizard:
+
+```bash
+agentlink init
+```
+
+Or pass options directly:
+
+```bash
+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
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run dev   # watch mode
+```

package/dist/index.js

@@ -0,0 +1,397 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import path3 from "path";
+import { Command } from "commander";
+
+// src/theme.ts
+var rgb = (r, g, b) => (s) => `\x1B[38;2;${r};${g};${b}m${s}\x1B[0m`;
+var blue = rgb(92, 184, 228);
+var amber = rgb(232, 168, 56);
+var red = rgb(239, 68, 68);
+var dim = (s) => `\x1B[2m${s}\x1B[0m`;
+var bold = (s) => `\x1B[1m${s}\x1B[0m`;
+
+// src/utils.ts
+import { execSync, spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+var LOG_FILE = "agentlink-debug.log";
+function appendLog(msg) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  fs.appendFileSync(LOG_FILE, `[${timestamp}] ${msg}
+`);
+}
+function initLog() {
+  fs.writeFileSync(LOG_FILE, "");
+}
+function runCommand(cmd, cwd) {
+  appendLog(`$ ${cmd}${cwd ? ` (in ${cwd})` : ""}`);
+  return new Promise((resolve, reject) => {
+    const child = spawn("sh", ["-c", cmd], {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const stdout = [];
+    const stderr = [];
+    child.stdout.on("data", (data) => stdout.push(data.toString()));
+    child.stderr.on("data", (data) => stderr.push(data.toString()));
+    child.on("close", (code) => {
+      const out = stdout.join("").trim();
+      const errOut = stderr.join("").trim();
+      if (out) appendLog(out);
+      if (code !== 0) {
+        appendLog(`EXIT CODE ${code}`);
+        if (errOut) appendLog(`STDERR: ${errOut}`);
+        reject(
+          new Error(
+            `Command failed: ${cmd}
+See ${path.resolve(LOG_FILE)} for details`
+          )
+        );
+      } else {
+        resolve(out);
+      }
+    });
+    child.on("error", (err) => {
+      appendLog(`SPAWN ERROR: ${err.message}`);
+      reject(
+        new Error(
+          `Command failed: ${cmd}
+See ${path.resolve(LOG_FILE)} for details`
+        )
+      );
+    });
+  });
+}
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function checkCommand(cmd) {
+  try {
+    execSync(`which ${cmd}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function skillDisplayName(skill) {
+  if (skill.includes("@")) return skill.split("@").pop();
+  const flag = skill.match(/--skill\s+(\S+)/);
+  if (flag) return flag[1];
+  return skill.split("/").pop();
+}
+function validateProjectName(name) {
+  if (!name) return "Project name is required.";
+  if (/\s/.test(name)) return "Project name cannot contain spaces.";
+  if (!/^[a-zA-Z0-9._-]+$/.test(name))
+    return "Project name can only contain letters, numbers, hyphens, dots, and underscores.";
+  if (fs.existsSync(name))
+    return `Directory "${name}" already exists.`;
+  return void 0;
+}
+
+// src/wizard.ts
+import { execSync as execSync2 } from "child_process";
+import { input, select } from "@inquirer/prompts";
+
+// src/banner.ts
+var TITLE = [
+  " \u2584\u2580\u2588 \u2588\u2580\u2580 \u2588\u2580\u2580 \u2588\u2584 \u2588 \u2580\u2588\u2580   \u2588   \u2588 \u2588\u2584 \u2588 \u2588\u2584\u2580",
+  " \u2588\u2580\u2588 \u2588\u2584\u2588 \u2588\u2588\u2584 \u2588 \u2580\u2588  \u2588    \u2588\u2584\u2584 \u2588 \u2588 \u2580\u2588 \u2588 \u2588"
+].join("\n");
+function printBanner() {
+  console.log();
+  console.log(bold(blue(TITLE)));
+  console.log();
+  console.log(dim("  Build Supabase apps with AI agents"));
+  console.log();
+}
+
+// src/scaffold.ts
+import fs2 from "fs";
+import path2 from "path";
+import { Listr } from "listr2";
+var RENDERER_OPTIONS = {
+  icon: {
+    COMPLETED: blue("\u2714"),
+    STARTED: amber("\u25FC"),
+    FAILED: red("\u2716"),
+    SKIPPED_WITH_COLLAPSE: dim("\u25CB"),
+    SKIPPED_WITHOUT_COLLAPSE: dim("\u25CB"),
+    WAITING: dim("\u25FB"),
+    COMPLETED_WITH_FAILED_SUBTASKS: amber("\u2714"),
+    COMPLETED_WITH_SISTER_TASKS_FAILED: blue("\u2714"),
+    RETRY: amber("\u21BB"),
+    ROLLING_BACK: red("\u21BA"),
+    PAUSED: amber("\u2016")
+  },
+  color: {
+    COMPLETED: blue,
+    STARTED: amber,
+    FAILED: red,
+    SKIPPED_WITH_COLLAPSE: dim,
+    SKIPPED_WITHOUT_COLLAPSE: dim,
+    WAITING: dim,
+    COMPLETED_WITH_FAILED_SUBTASKS: amber,
+    COMPLETED_WITH_SISTER_TASKS_FAILED: blue,
+    RETRY: amber,
+    ROLLING_BACK: red,
+    PAUSED: amber
+  }
+};
+var CLAUDE_SETTINGS = {
+  permissions: {
+    allow: [
+      "Bash(supabase --version)",
+      "Bash(supabase status:*)",
+      "Bash(supabase init:*)",
+      "Bash(supabase start:*)",
+      "Bash(supabase stop:*)",
+      "Bash(supabase functions:*)",
+      "Bash(npx create-next-app@latest:*)",
+      "Bash(npx create-vite@latest:*)",
+      "Bash(npm install:*)"
+    ]
+  },
+  extraKnownMarketplaces: {
+    agentlink: {
+      source: {
+        source: "github",
+        repo: "agentlinksh/agent"
+      }
+    }
+  },
+  mcpServers: {
+    supabase: {
+      type: "http",
+      url: "http://127.0.0.1:54321/mcp"
+    }
+  }
+};
+var REQUIRED_SKILL = "supabase/agent-skills@supabase-postgres-best-practices";
+var COMPANION_SKILLS = [
+  REQUIRED_SKILL,
+  "anthropics/skills@frontend-design",
+  "vercel-labs/agent-skills@vercel-react-best-practices",
+  "vercel-labs/next-skills --skill next-best-practices",
+  "resend/react-email",
+  "resend/email-best-practices",
+  "resend/resend-skills"
+];
+async function getVersion(cmd) {
+  try {
+    const out = await runCommand(cmd);
+    return out.replace(/^v/, "").split("\n")[0].trim();
+  } catch {
+    return null;
+  }
+}
+async function scaffold(options) {
+  const { name, skills } = options;
+  const projectDir = path2.resolve(process.cwd(), name);
+  const installedSkills = [];
+  fs2.mkdirSync(projectDir, { recursive: true });
+  const tasks = new Listr(
+    [
+      {
+        title: "Installing Supabase CLI",
+        skip: () => checkCommand("supabase") && "Supabase CLI already installed",
+        task: () => runCommand("npm install -g supabase")
+      },
+      {
+        title: "Initializing Supabase",
+        task: async () => {
+          await runCommand("supabase init", projectDir);
+          await delay(500);
+        }
+      },
+      {
+        title: "Stopping existing Supabase instances",
+        task: async () => {
+          await runCommand("supabase stop --all").catch(() => {
+          });
+          await delay(500);
+        }
+      },
+      {
+        title: "Starting Supabase",
+        task: () => runCommand("supabase start", projectDir)
+      },
+      {
+        title: "Configuring Claude Code",
+        task: async () => {
+          const claudeDir = path2.join(projectDir, ".claude");
+          fs2.mkdirSync(claudeDir, { recursive: true });
+          fs2.writeFileSync(
+            path2.join(claudeDir, "settings.local.json"),
+            JSON.stringify(CLAUDE_SETTINGS, null, 2) + "\n"
+          );
+          await delay(500);
+        }
+      },
+      {
+        title: "Installing Agent Link plugin",
+        task: () => runCommand("claude plugin install link@agentlink --scope project", projectDir)
+      },
+      {
+        title: "Installing companion skills",
+        skip: () => skills.length === 0 && "No skills selected",
+        task: (_, task) => task.newListr(
+          skills.map((skill) => {
+            const displayName = skillDisplayName(skill);
+            return {
+              title: displayName,
+              task: async () => {
+                await runCommand(
+                  `npx skills add ${skill} -a "claude-code" -y`,
+                  projectDir
+                );
+                installedSkills.push(displayName);
+              }
+            };
+          }),
+          { concurrent: true }
+        )
+      },
+      {
+        title: "Initializing git",
+        skip: () => fs2.existsSync(path2.join(projectDir, ".git")) && "Already initialized",
+        task: async () => {
+          await runCommand("git init", projectDir);
+          await runCommand("git add supabase .claude/settings.json", projectDir);
+          await runCommand('git commit -m "Initial commit from agentlink"', projectDir);
+          await delay(500);
+        }
+      }
+    ],
+    { concurrent: false, rendererOptions: RENDERER_OPTIONS }
+  );
+  await tasks.run();
+  const claudeCodeVersion = await getVersion("claude --version");
+  const supabaseVersion = await getVersion("supabase --version");
+  return {
+    projectDir,
+    claudeCodeVersion,
+    supabaseVersion,
+    skills: installedSkills
+  };
+}
+
+// src/wizard.ts
+var theme = {
+  prefix: { idle: blue("?"), done: blue("\u2714") },
+  style: {
+    answer: (text) => amber(text),
+    message: (text) => bold(text),
+    error: (text) => red(`> ${text}`),
+    help: (text) => dim(text),
+    highlight: (text) => blue(text),
+    key: (text) => blue(bold(`<${text}>`))
+  }
+};
+function printSummary(summary) {
+  const line = (label, value) => `  ${dim(label)} ${value}`;
+  console.log();
+  console.log(bold("  Summary"));
+  console.log(dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(line("Project    ", summary.projectDir));
+  if (summary.claudeCodeVersion)
+    console.log(line("Claude Code", `v${summary.claudeCodeVersion}`));
+  if (summary.supabaseVersion)
+    console.log(line("Supabase   ", `v${summary.supabaseVersion}`));
+  if (summary.skills.length > 0)
+    console.log(line("Skills     ", summary.skills.join(", ")));
+  console.log(dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log();
+}
+async function wizard(initialName, initialPrompt) {
+  printBanner();
+  if (!checkCommand("claude")) {
+    console.log(amber("  Installing Claude Code..."));
+    await runCommand("npm install -g @anthropic-ai/claude-code");
+    console.log(blue("  \u2714 Claude Code installed."));
+  }
+  const authStatus = await runCommand("claude auth status").catch(() => "");
+  const isLoggedIn = authStatus.includes('"loggedIn": true') || authStatus.includes('"loggedIn":true');
+  if (!isLoggedIn) {
+    console.log(amber("  Claude Code requires authentication. Opening login..."));
+    execSync2("claude auth login", { stdio: "inherit" });
+  }
+  let name;
+  if (initialName) {
+    name = initialName;
+  } else {
+    name = await input({
+      message: "Project name",
+      default: "my-app",
+      theme,
+      validate: (val) => validateProjectName(val) ?? true
+    });
+  }
+  let skills;
+  if (initialName && initialPrompt) {
+    skills = COMPANION_SKILLS;
+  } else {
+    const skillChoice = await select({
+      message: "Install companion skills?",
+      theme,
+      choices: [
+        {
+          name: "All recommended",
+          value: "all",
+          description: COMPANION_SKILLS.map(skillDisplayName).join(", ")
+        },
+        {
+          name: "Required only",
+          value: "required",
+          description: skillDisplayName(REQUIRED_SKILL)
+        },
+        { name: "Skip", value: "skip" }
+      ]
+    });
+    skills = [];
+    if (skillChoice === "all") {
+      skills = COMPANION_SKILLS;
+    } else if (skillChoice === "required") {
+      skills = [REQUIRED_SKILL];
+    }
+  }
+  let prompt;
+  if (initialPrompt) {
+    prompt = initialPrompt;
+  } else {
+    prompt = await input({
+      message: "What do you want to build?",
+      default: "A todo app with auth and real-time updates",
+      theme
+    });
+  }
+  const summary = await scaffold({ name, skills });
+  printSummary(summary);
+  console.log(blue("  Launching Claude Code..."));
+  console.log();
+  execSync2(`claude ${JSON.stringify(prompt)}`, {
+    cwd: summary.projectDir,
+    stdio: "inherit"
+  });
+}
+
+// src/index.ts
+var LOG_FILE2 = "agentlink-debug.log";
+var program = new Command();
+program.name("agentlink").description("CLI for scaffolding Supabase apps with AI agents").version("0.1.0").argument("[name]", "Project name").argument("[prompt]", "What do you want to build?").action(async (name, prompt) => {
+  initLog();
+  try {
+    await wizard(name, prompt);
+  } catch (err) {
+    console.error(
+      `
+${red("Error:")} ${err.message}
+
+Debug log: ${dim(path3.resolve(LOG_FILE2))}`
+    );
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "create-agentlink",
+  "version": "0.2.0",
+  "description": "CLI for scaffolding Supabase apps with AI agents",
+  "bin": {
+    "agentlink": "./dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "commander": "^13",
+    "listr2": "^10.1.1",
+    "skills": "^1.4.3",
+    "supabase": "^2.76.15"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "tsup": "^8",
+    "typescript": "^5"
+  }
+}

package/src/banner.ts

@@ -0,0 +1,14 @@
+import { blue, bold, dim } from "./theme.js";
+
+const TITLE = [
+  " ▄▀█ █▀▀ █▀▀ █▄ █ ▀█▀   █   █ █▄ █ █▄▀",
+  " █▀█ █▄█ ██▄ █ ▀█  █    █▄▄ █ █ ▀█ █ █",
+].join("\n");
+
+export function printBanner() {
+  console.log();
+  console.log(bold(blue(TITLE)));
+  console.log();
+  console.log(dim("  Build Supabase apps with AI agents"));
+  console.log();
+}

package/src/index.ts

@@ -0,0 +1,29 @@
+import path from "node:path";
+import { Command } from "commander";
+import { dim, red } from "./theme.js";
+import { initLog } from "./utils.js";
+import { wizard } from "./wizard.js";
+
+const LOG_FILE = "agentlink-debug.log";
+
+const program = new Command();
+
+program
+  .name("agentlink")
+  .description("CLI for scaffolding Supabase apps with AI agents")
+  .version("0.1.0")
+  .argument("[name]", "Project name")
+  .argument("[prompt]", "What do you want to build?")
+  .action(async (name?: string, prompt?: string) => {
+    initLog();
+    try {
+      await wizard(name, prompt);
+    } catch (err: any) {
+      console.error(
+        `\n${red("Error:")} ${err.message}\n\nDebug log: ${dim(path.resolve(LOG_FILE))}`,
+      );
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/scaffold.ts

@@ -0,0 +1,195 @@
+import fs from "node:fs";
+import path from "node:path";
+import { Listr } from "listr2";
+import { amber, blue, dim, red } from "./theme.js";
+import { checkCommand, delay, runCommand, skillDisplayName } from "./utils.js";
+
+const RENDERER_OPTIONS = {
+  icon: {
+    COMPLETED: blue("✔"),
+    STARTED: amber("◼"),
+    FAILED: red("✖"),
+    SKIPPED_WITH_COLLAPSE: dim("○"),
+    SKIPPED_WITHOUT_COLLAPSE: dim("○"),
+    WAITING: dim("◻"),
+    COMPLETED_WITH_FAILED_SUBTASKS: amber("✔"),
+    COMPLETED_WITH_SISTER_TASKS_FAILED: blue("✔"),
+    RETRY: amber("↻"),
+    ROLLING_BACK: red("↺"),
+    PAUSED: amber("‖"),
+  },
+  color: {
+    COMPLETED: blue,
+    STARTED: amber,
+    FAILED: red,
+    SKIPPED_WITH_COLLAPSE: dim,
+    SKIPPED_WITHOUT_COLLAPSE: dim,
+    WAITING: dim,
+    COMPLETED_WITH_FAILED_SUBTASKS: amber,
+    COMPLETED_WITH_SISTER_TASKS_FAILED: blue,
+    RETRY: amber,
+    ROLLING_BACK: red,
+    PAUSED: amber,
+  },
+};
+
+const CLAUDE_SETTINGS = {
+  permissions: {
+    allow: [
+      "Bash(supabase --version)",
+      "Bash(supabase status:*)",
+      "Bash(supabase init:*)",
+      "Bash(supabase start:*)",
+      "Bash(supabase stop:*)",
+      "Bash(supabase functions:*)",
+      "Bash(npx create-next-app@latest:*)",
+      "Bash(npx create-vite@latest:*)",
+      "Bash(npm install:*)",
+    ],
+  },
+  extraKnownMarketplaces: {
+    agentlink: {
+      source: {
+        source: "github",
+        repo: "agentlinksh/agent",
+      },
+    },
+  },
+  mcpServers: {
+    supabase: {
+      type: "http",
+      url: "http://127.0.0.1:54321/mcp",
+    },
+  },
+};
+
+export const REQUIRED_SKILL =
+  "supabase/agent-skills@supabase-postgres-best-practices";
+
+export const COMPANION_SKILLS = [
+  REQUIRED_SKILL,
+  "anthropics/skills@frontend-design",
+  "vercel-labs/agent-skills@vercel-react-best-practices",
+  "vercel-labs/next-skills --skill next-best-practices",
+  "resend/react-email",
+  "resend/email-best-practices",
+  "resend/resend-skills",
+];
+
+export interface ScaffoldOptions {
+  name: string;
+  skills: string[];
+}
+
+export interface ScaffoldSummary {
+  projectDir: string;
+  claudeCodeVersion: string | null;
+  supabaseVersion: string | null;
+  skills: string[];
+}
+
+async function getVersion(cmd: string): Promise<string | null> {
+  try {
+    const out = await runCommand(cmd);
+    return out.replace(/^v/, "").split("\n")[0].trim();
+  } catch {
+    return null;
+  }
+}
+
+export async function scaffold(options: ScaffoldOptions): Promise<ScaffoldSummary> {
+  const { name, skills } = options;
+  const projectDir = path.resolve(process.cwd(), name);
+  const installedSkills: string[] = [];
+
+  fs.mkdirSync(projectDir, { recursive: true });
+
+  const tasks = new Listr(
+    [
+      {
+        title: "Installing Supabase CLI",
+        skip: () => checkCommand("supabase") && "Supabase CLI already installed",
+        task: () => runCommand("npm install -g supabase"),
+      },
+      {
+        title: "Initializing Supabase",
+        task: async () => {
+          await runCommand("supabase init", projectDir);
+          await delay(500);
+        },
+      },
+      {
+        title: "Stopping existing Supabase instances",
+        task: async () => {
+          await runCommand("supabase stop --all").catch(() => {});
+          await delay(500);
+        },
+      },
+      {
+        title: "Starting Supabase",
+        task: () => runCommand("supabase start", projectDir),
+      },
+      {
+        title: "Configuring Claude Code",
+        task: async () => {
+          const claudeDir = path.join(projectDir, ".claude");
+          fs.mkdirSync(claudeDir, { recursive: true });
+          fs.writeFileSync(
+            path.join(claudeDir, "settings.local.json"),
+            JSON.stringify(CLAUDE_SETTINGS, null, 2) + "\n",
+          );
+          await delay(500);
+        },
+      },
+      {
+        title: "Installing Agent Link plugin",
+        task: () =>
+          runCommand("claude plugin install link@agentlink --scope project", projectDir),
+      },
+      {
+        title: "Installing companion skills",
+        skip: () => skills.length === 0 && "No skills selected",
+        task: (_, task) =>
+          task.newListr(
+            skills.map((skill) => {
+              const displayName = skillDisplayName(skill);
+              return {
+                title: displayName,
+                task: async () => {
+                  await runCommand(
+                    `npx skills add ${skill} -a "claude-code" -y`,
+                    projectDir,
+                  );
+                  installedSkills.push(displayName);
+                },
+              };
+            }),
+            { concurrent: true },
+          ),
+      },
+      {
+        title: "Initializing git",
+        skip: () => fs.existsSync(path.join(projectDir, ".git")) && "Already initialized",
+        task: async () => {
+          await runCommand("git init", projectDir);
+          await runCommand("git add supabase .claude/settings.json", projectDir);
+          await runCommand('git commit -m "Initial commit from agentlink"', projectDir);
+          await delay(500);
+        },
+      },
+    ],
+    { concurrent: false, rendererOptions: RENDERER_OPTIONS },
+  );
+
+  await tasks.run();
+
+  const claudeCodeVersion = await getVersion("claude --version");
+  const supabaseVersion = await getVersion("supabase --version");
+
+  return {
+    projectDir,
+    claudeCodeVersion,
+    supabaseVersion,
+    skills: installedSkills,
+  };
+}

package/src/theme.ts

@@ -0,0 +1,9 @@
+// Brand colors via truecolor ANSI escapes
+const rgb = (r: number, g: number, b: number) => (s: string) =>
+  `\x1b[38;2;${r};${g};${b}m${s}\x1b[0m`;
+
+export const blue = rgb(92, 184, 228);   // #5cb8e4 — Sheikah Blue
+export const amber = rgb(232, 168, 56);  // #e8a838 — Accent
+export const red = rgb(239, 68, 68);     // #ef4444 — Destructive
+export const dim = (s: string) => `\x1b[2m${s}\x1b[0m`;
+export const bold = (s: string) => `\x1b[1m${s}\x1b[0m`;

package/src/utils.ts

@@ -0,0 +1,90 @@
+import { execSync, spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+
+const LOG_FILE = "agentlink-debug.log";
+
+function appendLog(msg: string) {
+  const timestamp = new Date().toISOString();
+  fs.appendFileSync(LOG_FILE, `[${timestamp}] ${msg}\n`);
+}
+
+export function initLog() {
+  fs.writeFileSync(LOG_FILE, "");
+}
+
+export function runCommand(cmd: string, cwd?: string): Promise<string> {
+  appendLog(`$ ${cmd}${cwd ? ` (in ${cwd})` : ""}`);
+  return new Promise((resolve, reject) => {
+    const child = spawn("sh", ["-c", cmd], {
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+
+    const stdout: string[] = [];
+    const stderr: string[] = [];
+
+    child.stdout.on("data", (data) => stdout.push(data.toString()));
+    child.stderr.on("data", (data) => stderr.push(data.toString()));
+
+    child.on("close", (code) => {
+      const out = stdout.join("").trim();
+      const errOut = stderr.join("").trim();
+      if (out) appendLog(out);
+
+      if (code !== 0) {
+        appendLog(`EXIT CODE ${code}`);
+        if (errOut) appendLog(`STDERR: ${errOut}`);
+        reject(
+          new Error(
+            `Command failed: ${cmd}\nSee ${path.resolve(LOG_FILE)} for details`,
+          ),
+        );
+      } else {
+        resolve(out);
+      }
+    });
+
+    child.on("error", (err) => {
+      appendLog(`SPAWN ERROR: ${err.message}`);
+      reject(
+        new Error(
+          `Command failed: ${cmd}\nSee ${path.resolve(LOG_FILE)} for details`,
+        ),
+      );
+    });
+  });
+}
+
+export function delay(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+export function checkCommand(cmd: string): boolean {
+  try {
+    execSync(`which ${cmd}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function skillDisplayName(skill: string): string {
+  // "org/repo@skill-name" → "skill-name"
+  if (skill.includes("@")) return skill.split("@").pop()!;
+  // "org/repo --skill skill-name" → "skill-name"
+  const flag = skill.match(/--skill\s+(\S+)/);
+  if (flag) return flag[1];
+  // fallback: "org/repo" → "repo"
+  return skill.split("/").pop()!;
+}
+
+export function validateProjectName(name: string): string | undefined {
+  if (!name) return "Project name is required.";
+  if (/\s/.test(name)) return "Project name cannot contain spaces.";
+  if (!/^[a-zA-Z0-9._-]+$/.test(name))
+    return "Project name can only contain letters, numbers, hyphens, dots, and underscores.";
+  if (fs.existsSync(name))
+    return `Directory "${name}" already exists.`;
+  return undefined;
+}

package/src/wizard.ts

@@ -0,0 +1,121 @@
+import { execSync } from "node:child_process";
+import { input, select } from "@inquirer/prompts";
+import { printBanner } from "./banner.js";
+import { COMPANION_SKILLS, REQUIRED_SKILL, scaffold, ScaffoldSummary } from "./scaffold.js";
+import { amber, blue, bold, dim, red } from "./theme.js";
+import { checkCommand, runCommand, skillDisplayName, validateProjectName } from "./utils.js";
+
+const theme = {
+  prefix: { idle: blue("?"), done: blue("✔") },
+  style: {
+    answer: (text: string) => amber(text),
+    message: (text: string) => bold(text),
+    error: (text: string) => red(`> ${text}`),
+    help: (text: string) => dim(text),
+    highlight: (text: string) => blue(text),
+    key: (text: string) => blue(bold(`<${text}>`)),
+  },
+};
+
+function printSummary(summary: ScaffoldSummary) {
+  const line = (label: string, value: string) =>
+    `  ${dim(label)} ${value}`;
+
+  console.log();
+  console.log(bold("  Summary"));
+  console.log(dim("  ───────────────────────────────────"));
+  console.log(line("Project    ", summary.projectDir));
+  if (summary.claudeCodeVersion)
+    console.log(line("Claude Code", `v${summary.claudeCodeVersion}`));
+  if (summary.supabaseVersion)
+    console.log(line("Supabase   ", `v${summary.supabaseVersion}`));
+  if (summary.skills.length > 0)
+    console.log(line("Skills     ", summary.skills.join(", ")));
+  console.log(dim("  ───────────────────────────────────"));
+  console.log();
+}
+
+export async function wizard(initialName?: string, initialPrompt?: string) {
+  printBanner();
+
+  // Ensure Claude Code is installed
+  if (!checkCommand("claude")) {
+    console.log(amber("  Installing Claude Code..."));
+    await runCommand("npm install -g @anthropic-ai/claude-code");
+    console.log(blue("  ✔ Claude Code installed."));
+  }
+
+  // Ensure Claude Code is authenticated
+  const authStatus = await runCommand("claude auth status").catch(() => "");
+  const isLoggedIn = authStatus.includes('"loggedIn": true') || authStatus.includes('"loggedIn":true');
+  if (!isLoggedIn) {
+    console.log(amber("  Claude Code requires authentication. Opening login..."));
+    execSync("claude auth login", { stdio: "inherit" });
+  }
+
+  let name: string;
+  if (initialName) {
+    name = initialName;
+  } else {
+    name = await input({
+      message: "Project name",
+      default: "my-app",
+      theme,
+      validate: (val) => validateProjectName(val) ?? true,
+    });
+  }
+
+  let skills: string[];
+  if (initialName && initialPrompt) {
+    // Non-interactive: use all recommended skills
+    skills = COMPANION_SKILLS;
+  } else {
+    const skillChoice = await select({
+      message: "Install companion skills?",
+      theme,
+      choices: [
+        {
+          name: "All recommended",
+          value: "all" as const,
+          description: COMPANION_SKILLS.map(skillDisplayName).join(", "),
+        },
+        {
+          name: "Required only",
+          value: "required" as const,
+          description: skillDisplayName(REQUIRED_SKILL),
+        },
+        { name: "Skip", value: "skip" as const },
+      ],
+    });
+
+    skills = [];
+    if (skillChoice === "all") {
+      skills = COMPANION_SKILLS;
+    } else if (skillChoice === "required") {
+      skills = [REQUIRED_SKILL];
+    }
+  }
+
+  let prompt: string;
+  if (initialPrompt) {
+    prompt = initialPrompt;
+  } else {
+    prompt = await input({
+      message: "What do you want to build?",
+      default: "A todo app with auth and real-time updates",
+      theme,
+    });
+  }
+
+  const summary = await scaffold({ name, skills });
+
+  printSummary(summary);
+  console.log(blue("  Launching Claude Code..."));
+  console.log();
+
+  // Hand off to Claude Code in the project directory
+  execSync(`claude ${JSON.stringify(prompt)}`, {
+    cwd: summary.projectDir,
+    stdio: "inherit",
+  });
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: "esm",
+  target: "node18",
+  clean: true,
+  banner: {
+    js: "#!/usr/bin/env node",
+  },
+});