@agentlink.sh/cli 0.10.1 → 0.11.0

package/README.md

@@ -41,16 +41,19 @@ The install scripts automatically detect your OS, install Node.js if needed, and
 ## Quick start
 
 ```bash
-# Create a new project (cloud by default, zero questions with name + prompt)
-agentlink my-app "Build a project management tool with kanban boards"
+# Create a new project (cloud by default)
+agentlink my-app
+
+# With a prompt for Claude Code
+agentlink my-app --prompt "Build a project management tool with kanban boards"
 
-# Interactive wizard (asks project name and frontend choice)
+# Interactive wizard
 agentlink
 ```
 
 ## Commands
 
-### `agentlink [name] [prompt]`
+### `agentlink [name]`
 
 Interactive wizard that scaffolds a new project or updates an existing one. Uses Supabase Cloud by default — region is auto-detected from your timezone, all recommended skills are installed automatically.
 
@@ -61,8 +64,8 @@ agentlink
 # With project name
 agentlink my-app
 
-# With name and prompt (zero questions — express mode)
-agentlink my-app "Build a project management tool with kanban boards"
+# With prompt (passed to Claude Code on launch)
+agentlink my-app --prompt "Build a project management tool"
 
 # Local Docker mode (instead of cloud)
 agentlink my-app --local

package/dist/{chunk-DOWH47I5.js → chunk-2CNK2BQY.js}

@@ -181,7 +181,7 @@ async function ensureAccessToken(nonInteractive, projectDir) {
     }
     if (creds.oauth.refresh_token) {
       try {
-        const { refreshOAuthToken } = await import("./oauth-J4X62CY4.js");
+        const { refreshOAuthToken } = await import("./oauth-VTSNCG7U.js");
         const tokens = await refreshOAuthToken(creds.oauth.refresh_token);
         const updated = {
           ...creds,
@@ -230,7 +230,7 @@ async function ensureAccessToken(nonInteractive, projectDir) {
     ]
   });
   if (method === "oauth") {
-    const { oauthLogin } = await import("./oauth-J4X62CY4.js");
+    const { oauthLogin } = await import("./oauth-VTSNCG7U.js");
     const tokens = await oauthLogin();
     process.env.SUPABASE_ACCESS_TOKEN = tokens.access_token;
     saveCredentials({

package/dist/{cloud-N7CILHLD.js → cloud-2AWCJAG5.js}

@@ -20,7 +20,7 @@ import {
   updateAuthConfig,
   updatePostgrestConfig,
   waitForProjectReady
-} from "./chunk-DOWH47I5.js";
+} from "./chunk-2CNK2BQY.js";
 import "./chunk-G3HVUCWY.js";
 export {
   createProject,

package/dist/index.js

@@ -26,7 +26,7 @@ import {
   updatePostgrestConfig,
   validateProjectName,
   waitForProjectReady
-} from "./chunk-DOWH47I5.js";
+} from "./chunk-2CNK2BQY.js";
 import {
   SKILLS_VERSION,
   SUPPORTED_SUPABASE_CLI,
@@ -2361,7 +2361,7 @@ async function connectExistingProject() {
   };
 }
 async function createNewProject(envName, opts) {
-  const { listOrganizations: listOrganizations2, listRegions: listRegions2 } = await import("./cloud-N7CILHLD.js");
+  const { listOrganizations: listOrganizations2, listRegions: listRegions2 } = await import("./cloud-2AWCJAG5.js");
   const orgs = await listOrganizations2();
   if (orgs.length === 0) {
     throw new Error("No Supabase organizations found. Create one at https://supabase.com/dashboard.");
@@ -3664,12 +3664,14 @@ async function scaffold(options) {
         "pgdelta binary not found. Run `npm install` in the CLI package first."
       );
     }
-    if (checkCommand("psql")) {
-      spinner.text = "Checking prerequisites \u2014 PostgreSQL client installed";
-    } else {
-      throw new Error(
-        "psql is required but not installed.\n  macOS:  brew install libpq && brew link --force libpq\n  Ubuntu: sudo apt install postgresql-client\n  See: https://www.postgresql.org/download/"
-      );
+    if (!options.cloud) {
+      if (checkCommand("psql")) {
+        spinner.text = "Checking prerequisites \u2014 PostgreSQL client installed";
+      } else {
+        throw new Error(
+          "psql is required for local mode but not installed.\n  macOS:  brew install libpq && brew link --force libpq\n  Ubuntu: sudo apt install postgresql-client\n  Or remove --local to use Supabase Cloud (no psql needed).\n  See: https://www.postgresql.org/download/"
+        );
+      }
     }
   });
   console.log();
@@ -3709,6 +3711,9 @@ async function scaffold(options) {
   if (options.cloud) {
     await trackedStep("start-supabase", "Creating Supabase cloud project", async (spinner) => {
       if (isResume && ctx.projectRef) {
+        if (ctx.apiUrl && ctx.publishableKey && ctx.secretKey) {
+          return;
+        }
         spinner.text = "Creating Supabase cloud project \u2014 Waiting for project to be ready";
         await waitForProjectReady(ctx.projectRef, spinner);
         return;
@@ -3773,6 +3778,9 @@ async function scaffold(options) {
     });
   }
   await trackedStep("read-config", "Reading Supabase configuration", async () => {
+    if (ctx.apiUrl && ctx.publishableKey && ctx.secretKey && (ctx.dbUrl || options.cloud)) {
+      return;
+    }
     if (options.cloud) {
       const keys = await getApiKeys(ctx.projectRef);
       ctx.apiUrl = `https://${ctx.projectRef}.supabase.co`;
@@ -4436,25 +4444,71 @@ function finishScaffold(summary, frontend, cloudConfig, prompt, launchClaude, sk
   console.log(`  ${dim("Switch env")}       agentlink env use <name>`);
   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();
-  if (launchClaude === false || nonInteractive) {
+  if (launchClaude === false || nonInteractive || !prompt) {
     return;
   }
   console.log(blue("  Launching Claude Code..."));
   console.log();
-  const launchArgs = prompt ? `${JSON.stringify(prompt)}` : "";
-  execSync(`claude ${launchArgs}`, {
+  execSync(`claude ${JSON.stringify(prompt)}`, {
     cwd: summary.projectDir,
     stdio: "inherit"
   });
 }
-async function wizard(initialName, initialPrompt, opts = {}) {
+async function wizard(initialName, opts = {}) {
   const { forceUpdate, frontend: initialFrontend, local: localMode, skills: installSkills, launch: launchClaude, yes: autoYes, nonInteractive } = opts;
-  if (opts.prompt) {
-    initialPrompt = opts.prompt;
-  }
   if (opts.token) {
     process.env.SUPABASE_ACCESS_TOKEN = opts.token;
   }
+  if (opts.link) {
+    const { projectRef, dbUrl, apiUrl, publishableKey, secretKey } = opts.link;
+    if (!projectRef || !dbUrl || !apiUrl || !publishableKey || !secretKey) {
+      throw new Error(
+        "--link requires all connection flags:\n  --project-ref, --db-url, --api-url, --publishable-key, --secret-key"
+      );
+    }
+    const name2 = initialName === "." ? path15.basename(process.cwd()) : initialName ?? "my-app";
+    const scaffoldHere2 = initialName === ".";
+    const projectDir2 = scaffoldHere2 ? process.cwd() : path15.resolve(process.cwd(), name2);
+    const frontend2 = initialFrontend ?? "vite";
+    const skills2 = installSkills === false ? [] : getCompanionSkills(frontend2);
+    const region = projectRef.length > 0 ? "us-east-1" : "us-east-1";
+    if (!scaffoldHere2) {
+      fs15.mkdirSync(projectDir2, { recursive: true });
+    }
+    const cloudConfig2 = { orgId: "", region, label: "dev" };
+    printBanner();
+    console.log(dim(`  v${pkg2.version}`));
+    console.log();
+    console.log(`  ${blue("\u25CF")} Linking to Supabase project ${dim(projectRef)}`);
+    console.log();
+    const scaffoldOpts2 = { name: name2, skills: skills2, mode: "new", frontend: frontend2, cloud: cloudConfig2, nonInteractive: true };
+    saveProgress(projectDir2, {
+      version: pkg2.version,
+      options: scaffoldOpts2,
+      ctx: {
+        dbUrl,
+        apiUrl,
+        publishableKey,
+        secretKey,
+        projectRef
+      },
+      completedSteps: [],
+      prompt: opts.prompt ?? "",
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    saveSession(projectDir2, name2);
+    const summary2 = await scaffold({
+      ...scaffoldOpts2,
+      resume: {
+        completedSteps: [],
+        ctx: { dbUrl, apiUrl, publishableKey, secretKey, projectRef },
+        prompt: opts.prompt ?? "",
+        projectDir: projectDir2
+      }
+    });
+    finishScaffold(summary2, frontend2, cloudConfig2, opts.prompt ?? "", launchClaude, skills2, true);
+    return;
+  }
   printBanner();
   console.log(dim(`  v${pkg2.version}`));
   console.log();
@@ -4630,7 +4684,23 @@ Run without --resume to start fresh.`
   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" });
+    try {
+      execSync("claude auth login", { stdio: "inherit" });
+    } catch {
+      throw new Error(
+        `Claude Code login failed.
+  Run ${dim("claude auth login")} manually, then retry with:
+  ${dim("npx @agentlink.sh/cli@latest")}`
+      );
+    }
+    const recheck = await runCommand("claude auth status").catch(() => "");
+    if (!recheck.includes('"loggedIn": true') && !recheck.includes('"loggedIn":true')) {
+      throw new Error(
+        `Claude Code authentication did not complete.
+  Run ${dim("claude auth login")} manually, then retry with:
+  ${dim("npx @agentlink.sh/cli@latest")}`
+      );
+    }
   }
   const hasSupabase = fs15.existsSync(path15.join(process.cwd(), "supabase", "config.toml"));
   const hasPackageJson = fs15.existsSync(path15.join(process.cwd(), "package.json"));
@@ -4658,7 +4728,6 @@ Run without --resume to start fresh.`
       });
     }
   } else if (initialName === ".") {
-    mode = "existing";
     name = path15.basename(process.cwd());
   } else if (initialName) {
     if (mode === "new") {
@@ -4686,7 +4755,7 @@ ${red("Error:")} ${error}`);
   if (mode === "new") {
     if (initialFrontend !== void 0) {
       frontend = initialFrontend;
-    } else if (nonInteractive || initialName && initialPrompt) {
+    } else if (nonInteractive || initialName && opts.prompt) {
       frontend = "vite";
     } else {
       frontend = await select3({
@@ -4757,7 +4826,7 @@ ${red("Error:")} No organizations found. Create one at ${link("https://supabase.
   if (mode === "existing") {
     prompt = "Analyze the current project and plan a migration to the architecture proposed by AgentLink";
   } else {
-    prompt = initialPrompt ?? "";
+    prompt = opts.prompt ?? "";
   }
   if (!useCloud && mode === "existing" && !autoYes && !nonInteractive) {
     const proceed = await confirm5({
@@ -4773,9 +4842,10 @@ ${amber("Aborted.")} Stop other Supabase instances manually before running again
       process.exit(0);
     }
   }
-  const projectDir = mode === "existing" ? process.cwd() : path15.resolve(process.cwd(), name);
+  const scaffoldHere = mode === "existing" || initialName === ".";
+  const projectDir = scaffoldHere ? process.cwd() : path15.resolve(process.cwd(), name);
   const scaffoldOpts = { name, skills, mode, frontend, cloud: cloudConfig, nonInteractive };
-  if (mode === "new") {
+  if (!scaffoldHere) {
     fs15.mkdirSync(projectDir, { recursive: true });
   }
   saveProgress(projectDir, {
@@ -4801,7 +4871,7 @@ function enableDebug(cmd) {
   if (debug) initLog(true);
 }
 program.hook("preAction", (thisCommand) => enableDebug(thisCommand));
-program.name("agentlink").description("CLI for scaffolding Supabase apps with AI agents").version(pkg3.version).argument("[name]", "Project name").argument("[prompt]", "What do you want to build?").option("--debug", "Write debug log to agentlink-debug.log").option("--force-update", "Force update even if project is up to date").option("--no-frontend", "Skip frontend scaffolding").option("--nextjs", "Use NextJS instead of React + Vite for frontend").option("--local", "Use local Docker instead of Supabase Cloud").option("--no-skills", "Skip companion skill installation").option("--no-launch", "Skip launching Claude Code after scaffold").option("-y, --yes", "Auto-confirm all prompts").option("--token <token>", "Supabase access token (skips interactive login)").option("--org <id>", "Supabase organization ID").option("--region <region>", "Supabase Cloud region (e.g. us-east-1)").option("--prompt <prompt>", "What to build (alternative to positional arg)").option("--resume", "Resume a previously failed scaffold").option("--non-interactive", "Error instead of prompting when info is missing").action(async (name, prompt) => {
+program.name("agentlink").description("CLI for scaffolding Supabase apps with AI agents").version(pkg3.version).argument("[name]", "Project name (use . to scaffold in current directory)").option("--debug", "Write debug log to agentlink-debug.log").option("--force-update", "Force update even if project is up to date").option("--no-frontend", "Skip frontend scaffolding").option("--nextjs", "Use NextJS instead of React + Vite for frontend").option("--local", "Use local Docker instead of Supabase Cloud").option("--no-skills", "Skip companion skill installation").option("--no-launch", "Skip launching Claude Code after scaffold").option("-y, --yes", "Auto-confirm all prompts").option("--token <token>", "Supabase access token (skips interactive login)").option("--org <id>", "Supabase organization ID").option("--region <region>", "Supabase Cloud region (e.g. us-east-1)").option("--prompt <prompt>", "What to build (passed to Claude Code on launch)").option("--resume", "Resume a previously failed scaffold").option("--non-interactive", "Error instead of prompting when info is missing").option("--link", "Link to an existing Supabase project (requires --project-ref and connection flags)").option("--project-ref <ref>", "Supabase project ref (used with --link)").option("--db-url <url>", "Database URL (used with --link)").option("--api-url <url>", "Supabase API URL (used with --link)").option("--publishable-key <key>", "Supabase publishable key (used with --link)").option("--secret-key <key>", "Supabase secret key (used with --link)").action(async (name) => {
   const opts = program.opts();
   const debug = opts.debug ?? false;
   initLog(debug);
@@ -4814,7 +4884,7 @@ program.name("agentlink").description("CLI for scaffolding Supabase apps with AI
     } else if (opts.frontend !== void 0) {
       frontend = "vite";
     }
-    await wizard(name, prompt, {
+    await wizard(name, {
       forceUpdate: opts.forceUpdate,
       frontend,
       local: opts.local,
@@ -4826,7 +4896,14 @@ program.name("agentlink").description("CLI for scaffolding Supabase apps with AI
       region: opts.region,
       prompt: opts.prompt,
       resume: opts.resume,
-      nonInteractive: opts.nonInteractive
+      nonInteractive: opts.nonInteractive,
+      link: opts.link ? {
+        projectRef: opts.projectRef,
+        dbUrl: opts.dbUrl,
+        apiUrl: opts.apiUrl,
+        publishableKey: opts.publishableKey,
+        secretKey: opts.secretKey
+      } : void 0
     });
   } catch (err) {
     const msg = `
@@ -4881,8 +4958,8 @@ program.command("info [name]").description("Show documentation about AgentLink c
 });
 program.command("login").description("Authenticate with Supabase via OAuth (opens browser)").action(async () => {
   try {
-    const { oauthLogin } = await import("./oauth-J4X62CY4.js");
-    const { saveCredentials: saveCredentials2, loadCredentials: loadCredentials2, credentialsPath: credentialsPath2 } = await import("./cloud-N7CILHLD.js");
+    const { oauthLogin } = await import("./oauth-VTSNCG7U.js");
+    const { saveCredentials: saveCredentials2, loadCredentials: loadCredentials2, credentialsPath: credentialsPath2 } = await import("./cloud-2AWCJAG5.js");
     console.log();
     const tokens = await oauthLogin();
     saveCredentials2({

package/dist/{oauth-J4X62CY4.js → oauth-VTSNCG7U.js}

@@ -4,6 +4,7 @@ import {
   OAUTH_CLIENT_SECRET,
   amber,
   blue,
+  bold,
   dim
 } from "./chunk-G3HVUCWY.js";
 
@@ -12,11 +13,21 @@ import { createHash, randomBytes } from "crypto";
 import { createServer } from "http";
 import { URL } from "url";
 import { execSync } from "child_process";
+import { select } from "@inquirer/prompts";
+var theme = {
+  prefix: { idle: blue("?"), done: blue("\u2714") },
+  style: {
+    answer: (text) => amber(text),
+    message: (text) => bold(text),
+    highlight: (text) => blue(text),
+    key: (text) => blue(bold(`<${text}>`))
+  }
+};
 var AUTHORIZE_URL = "https://api.supabase.com/v1/oauth/authorize";
 var TOKEN_URL = "https://api.supabase.com/v1/oauth/token";
 var PORT_RANGE_START = 54320;
 var PORT_RANGE_END = 54330;
-var TIMEOUT_MS = 12e4;
+var CHECK_IN_MS = 3e4;
 function generateCodeVerifier() {
   return randomBytes(64).toString("base64url");
 }
@@ -87,25 +98,15 @@ function openBrowser(url) {
     console.log(`  ${dim(url)}`);
   }
 }
-async function oauthLogin() {
-  const codeVerifier = generateCodeVerifier();
-  const codeChallenge = generateCodeChallenge(codeVerifier);
-  const state = randomBytes(16).toString("hex");
-  const port = await findOpenPort();
-  const redirectUri = `http://localhost:${port}/callback`;
-  const authorizeUrl = new URL(AUTHORIZE_URL);
-  authorizeUrl.searchParams.set("client_id", OAUTH_CLIENT_ID);
-  authorizeUrl.searchParams.set("redirect_uri", redirectUri);
-  authorizeUrl.searchParams.set("response_type", "code");
-  authorizeUrl.searchParams.set("code_challenge", codeChallenge);
-  authorizeUrl.searchParams.set("code_challenge_method", "S256");
-  authorizeUrl.searchParams.set("state", state);
-  const code = await new Promise((resolve, reject) => {
-    const timeout = setTimeout(() => {
-      server.close();
-      reject(new Error("OAuth login timed out. Try again."));
-    }, TIMEOUT_MS);
-    const server = createServer((req, res) => {
+function waitForCallback(port, state, timeoutMs) {
+  let server;
+  let timer;
+  const promise = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      server?.close();
+      resolve(null);
+    }, timeoutMs);
+    server = createServer((req, res) => {
       const url = new URL(req.url, `http://localhost:${port}`);
       if (url.pathname !== "/callback") {
         res.writeHead(404);
@@ -117,43 +118,93 @@ async function oauthLogin() {
         const desc = url.searchParams.get("error_description") ?? error;
         res.writeHead(400, { "Content-Type": "text/html" });
         res.end(ERROR_HTML(desc));
-        clearTimeout(timeout);
+        clearTimeout(timer);
         server.close();
-        reject(new Error(`OAuth error: ${desc}`));
+        console.log(`  ${amber("\u25B2")} OAuth error: ${desc}`);
+        resolve(null);
         return;
       }
       const returnedState = url.searchParams.get("state");
       if (returnedState !== state) {
         res.writeHead(400, { "Content-Type": "text/html" });
         res.end(ERROR_HTML("State mismatch \u2014 possible CSRF attack."));
-        clearTimeout(timeout);
+        clearTimeout(timer);
         server.close();
-        reject(new Error("OAuth state mismatch."));
+        resolve(null);
         return;
       }
       const authCode = url.searchParams.get("code");
       if (!authCode) {
         res.writeHead(400, { "Content-Type": "text/html" });
         res.end(ERROR_HTML("No authorization code received."));
-        clearTimeout(timeout);
+        clearTimeout(timer);
         server.close();
-        reject(new Error("No authorization code in callback."));
+        resolve(null);
         return;
       }
       res.writeHead(200, { "Content-Type": "text/html" });
       res.end(SUCCESS_HTML);
-      clearTimeout(timeout);
+      clearTimeout(timer);
       server.close();
       resolve(authCode);
     });
-    server.listen(port, "127.0.0.1", () => {
-      console.log(`  ${blue("\u25CF")} Opening browser for Supabase login...`);
-      openBrowser(authorizeUrl.toString());
-      console.log(`  ${dim("Waiting for authorization...")}`);
-      console.log();
-    });
+    server.listen(port, "127.0.0.1");
   });
-  return exchangeCode(code, redirectUri, codeVerifier);
+  return {
+    promise,
+    cleanup: () => {
+      clearTimeout(timer);
+      server?.close();
+    }
+  };
+}
+async function oauthLogin() {
+  while (true) {
+    const codeVerifier = generateCodeVerifier();
+    const codeChallenge = generateCodeChallenge(codeVerifier);
+    const state = randomBytes(16).toString("hex");
+    const port = await findOpenPort();
+    const redirectUri = `http://localhost:${port}/callback`;
+    const authorizeUrl = new URL(AUTHORIZE_URL);
+    authorizeUrl.searchParams.set("client_id", OAUTH_CLIENT_ID);
+    authorizeUrl.searchParams.set("redirect_uri", redirectUri);
+    authorizeUrl.searchParams.set("response_type", "code");
+    authorizeUrl.searchParams.set("code_challenge", codeChallenge);
+    authorizeUrl.searchParams.set("code_challenge_method", "S256");
+    authorizeUrl.searchParams.set("state", state);
+    console.log(`  ${blue("\u25CF")} Opening browser for Supabase login...`);
+    openBrowser(authorizeUrl.toString());
+    console.log(`  ${dim("Waiting for authorization...")}`);
+    console.log();
+    let code = null;
+    const first = waitForCallback(port, state, CHECK_IN_MS);
+    code = await first.promise;
+    if (code) {
+      return exchangeCode(code, redirectUri, codeVerifier);
+    }
+    while (true) {
+      const action = await select({
+        message: "No response yet. What would you like to do?",
+        theme,
+        choices: [
+          { name: "Keep waiting (30s more)", value: "wait" },
+          { name: "Retry (open browser again)", value: "retry" },
+          { name: "Cancel", value: "cancel" }
+        ]
+      });
+      if (action === "cancel") {
+        throw new Error("OAuth login cancelled.");
+      }
+      if (action === "retry") {
+        break;
+      }
+      const next = waitForCallback(port, state, CHECK_IN_MS);
+      code = await next.promise;
+      if (code) {
+        return exchangeCode(code, redirectUri, codeVerifier);
+      }
+    }
+  }
 }
 async function exchangeCode(code, redirectUri, codeVerifier) {
   const res = await fetch(TOKEN_URL, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlink.sh/cli",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "CLI for scaffolding Supabase apps with AI agents",
   "bin": {
     "agentlink": "dist/index.js"