@recursiv/cli 0.1.6 → 0.1.8

package/dist/bin/recursiv.js

@@ -10,10 +10,10 @@ var __export = (target, all) => {
 };
 
 // src/lib/logger.ts
-import pc from "picocolors";
+import pc2 from "picocolors";
 function banner() {
   console.log();
-  console.log(pc.bold("Recursiv") + pc.dim(" \u2014 build and ship apps with AI"));
+  console.log(pc2.bold("Recursiv") + pc2.dim(" \u2014 build and ship apps with AI"));
   console.log();
 }
 var log;
@@ -22,19 +22,19 @@ var init_logger = __esm({
     "use strict";
     log = {
       info(msg) {
-        console.log(pc.cyan("info") + "  " + msg);
+        console.log(pc2.cyan("info") + "  " + msg);
       },
       success(msg) {
-        console.log(pc.green("ok") + "    " + msg);
+        console.log(pc2.green("ok") + "    " + msg);
       },
       warn(msg) {
-        console.log(pc.yellow("warn") + "  " + msg);
+        console.log(pc2.yellow("warn") + "  " + msg);
       },
       error(msg) {
-        console.error(pc.red("error") + " " + msg);
+        console.error(pc2.red("error") + " " + msg);
       },
       step(n, total, msg) {
-        console.log(pc.dim(`[${n}/${total}]`) + " " + msg);
+        console.log(pc2.dim(`[${n}/${total}]`) + " " + msg);
       },
       blank() {
         console.log();
@@ -106,10 +106,6 @@ async function writeEnvFile(dir, apiKey) {
   const content = [
     "# Recursiv API key",
     `RECURSIV_API_KEY=${apiKey}`,
-    "",
-    "# Framework-specific public keys (uncomment as needed)",
-    `# NEXT_PUBLIC_RECURSIV_API_KEY=${apiKey}`,
-    `# VITE_RECURSIV_API_KEY=${apiKey}`,
     ""
   ].join("\n");
   await writeFile2(envPath, content, "utf-8");
@@ -158,7 +154,7 @@ __export(auth_flow_exports, {
   validateApiKey: () => validateApiKey
 });
 import prompts from "prompts";
-import pc2 from "picocolors";
+import pc3 from "picocolors";
 function isValidKeyFormat(key) {
   return API_KEY_PATTERN.test(key);
 }
@@ -178,9 +174,10 @@ async function validateApiKey(apiKey, baseUrl) {
 async function terminalSignup(baseUrl) {
   const rootUrl = baseUrl.replace(/\/api\/v1\/?$/, "");
   console.log();
-  console.log(pc2.bold("Create a free Recursiv account"));
-  console.log(pc2.dim("Free tier: 1,000 API calls/day, 1 agent, 3 projects"));
-  console.log(pc2.dim("We'll send a 6-digit code to your email \u2014 no password needed."));
+  console.log(pc3.bold("Sign in to Recursiv"));
+  console.log(pc3.dim("We'll send a 6-digit code to your email \u2014 no password needed."));
+  console.log(pc3.dim("If your email isn't registered yet, we'll create a free account."));
+  console.log(pc3.dim("Free tier: 1,000 API calls/day, 1 agent, 3 projects"));
   console.log();
   const { email } = await prompts(
     {
@@ -211,7 +208,7 @@ async function terminalSignup(baseUrl) {
     log.error(
       `Could not reach ${rootUrl} \u2014 ${err instanceof Error ? err.message : "network error"}`
     );
-    log.info(`You can create an API key manually at ${pc2.underline(DASHBOARD_URL)}`);
+    log.info(`You can create an API key manually at ${pc3.underline(DASHBOARD_URL)}`);
     return null;
   }
   log.success(`Verification code sent to ${email}`);
@@ -251,7 +248,7 @@ async function terminalSignup(baseUrl) {
   }
   if (!sessionCookie) {
     log.error("No session returned from server");
-    log.info(`Create an API key manually at ${pc2.underline(DASHBOARD_URL)}`);
+    log.info(`Create an API key manually at ${pc3.underline(DASHBOARD_URL)}`);
     return null;
   }
   log.success("Authenticated");
@@ -270,7 +267,7 @@ async function terminalSignup(baseUrl) {
     if (!keyRes.ok) {
       const errBody = await keyRes.text().catch(() => "");
       log.error(`Failed to create API key (${keyRes.status}): ${errBody}`);
-      log.info(`Create one manually at ${pc2.underline(DASHBOARD_URL)}`);
+      log.info(`Create one manually at ${pc3.underline(DASHBOARD_URL)}`);
       return null;
     }
     const { data } = await keyRes.json();
@@ -280,7 +277,7 @@ async function terminalSignup(baseUrl) {
     log.error(
       `Failed to create API key: ${err instanceof Error ? err.message : "unknown error"}`
     );
-    log.info(`Create one manually at ${pc2.underline(DASHBOARD_URL)}`);
+    log.info(`Create one manually at ${pc3.underline(DASHBOARD_URL)}`);
     return null;
   }
 }
@@ -297,8 +294,8 @@ function extractSessionCookie(res) {
 }
 async function promptApiKey() {
   console.log(
-    pc2.dim(
-      `Get your API key from ${pc2.underline(DASHBOARD_URL)}
+    pc3.dim(
+      `Get your API key from ${pc3.underline(DASHBOARD_URL)}
 Keys start with sk_live_ or sk_test_`
     )
   );
@@ -345,13 +342,13 @@ async function getOrCreateApiKey(baseUrl) {
       message: "How would you like to authenticate?",
       choices: [
         {
-          title: "Create a free account",
-          description: "Sign up with email (we'll send a 6-digit code)",
+          title: "Sign in or create an account with my email",
+          description: "We'll send a 6-digit code. Works whether you're new or returning.",
           value: "signup"
         },
         {
-          title: "Enter an existing API key",
-          description: "Paste a key from your dashboard",
+          title: "Paste an existing API key",
+          description: "Use a key you've already saved from the dashboard",
           value: "paste"
         },
         {
@@ -425,7 +422,7 @@ async function saveCredentials(creds) {
   });
 }
 async function resolveRecursivKey(projectDir) {
-  const envKey = process.env.RECURSIV_API_KEY || process.env.SOCIAL_DEV_API_KEY;
+  const envKey = process.env.RECURSIV_API_KEY;
   if (envKey) return envKey;
   if (projectDir) {
     try {
@@ -461,12 +458,12 @@ __export(mcp_install_exports, {
 import { readFile as readFile5, writeFile as writeFile6, mkdir as mkdir3 } from "fs/promises";
 import { join as join5, resolve as resolve3 } from "path";
 import { homedir as homedir2, platform } from "os";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 async function mcpInstallCommand(opts) {
   const target = opts.target;
   if (!VALID_TARGETS.includes(target)) {
     console.error(
-      pc11.red("error") + ` Unknown target "${opts.target}". Valid targets: ${VALID_TARGETS.join(", ")}`
+      pc12.red("error") + ` Unknown target "${opts.target}". Valid targets: ${VALID_TARGETS.join(", ")}`
     );
     process.exit(1);
   }
@@ -474,17 +471,17 @@ async function mcpInstallCommand(opts) {
   let apiKey = opts.apiKey || await resolveRecursivKey2(process.cwd());
   if (!apiKey) {
     console.log();
-    console.log(pc11.dim("  No Recursiv API key found. Let's authenticate."));
+    console.log(pc12.dim("  No Recursiv API key found. Let's authenticate."));
     console.log();
     const { getOrCreateApiKey: getOrCreateApiKey2 } = await Promise.resolve().then(() => (init_auth_flow(), auth_flow_exports));
     const baseUrl = process.env.RECURSIV_BASE_URL || "https://api.recursiv.io/api/v1";
     apiKey = await getOrCreateApiKey2(baseUrl);
     if (!apiKey) {
-      console.error(pc11.red("  error") + " Authentication required to continue.");
+      console.error(pc12.red("  error") + " Authentication required to continue.");
       process.exit(1);
     }
     await saveCredentials2({ recursivApiKey: apiKey });
-    console.log(pc11.dim("  Credentials saved to ~/.recursiv/credentials"));
+    console.log(pc12.dim("  Credentials saved to ~/.recursiv/credentials"));
     console.log();
   }
   switch (target) {
@@ -511,14 +508,14 @@ async function installClaudeCode(apiKey, global) {
     if (!settings.mcpServers) settings.mcpServers = {};
     settings.mcpServers.recursiv = mcpServerEntry(apiKey);
     await writeFile6(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
-    console.log(pc11.green("\u2713") + ` Recursiv MCP added to ${pc11.dim(settingsPath)}`);
+    console.log(pc12.green("\u2713") + ` Recursiv MCP added to ${pc12.dim(settingsPath)}`);
   } else {
     const mcpPath = join5(process.cwd(), ".mcp.json");
     const config = await readJsonSafe(mcpPath);
     if (!config.mcpServers) config.mcpServers = {};
     config.mcpServers.recursiv = mcpServerEntry(apiKey);
     await writeFile6(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-    console.log(pc11.green("\u2713") + ` Recursiv MCP added to ${pc11.dim(mcpPath)}`);
+    console.log(pc12.green("\u2713") + ` Recursiv MCP added to ${pc12.dim(mcpPath)}`);
   }
 }
 function claudeDesktopConfigPath() {
@@ -539,8 +536,8 @@ async function installClaudeDesktop(apiKey) {
   if (!config.mcpServers) config.mcpServers = {};
   config.mcpServers.recursiv = mcpServerEntry(apiKey);
   await writeFile6(configPath2, JSON.stringify(config, null, 2) + "\n", "utf-8");
-  console.log(pc11.green("\u2713") + ` Recursiv MCP added to ${pc11.dim(configPath2)}`);
-  console.log(pc11.dim("  Restart Claude Desktop to pick up the change."));
+  console.log(pc12.green("\u2713") + ` Recursiv MCP added to ${pc12.dim(configPath2)}`);
+  console.log(pc12.dim("  Restart Claude Desktop to pick up the change."));
 }
 async function installCodex(apiKey) {
   const codexDir = join5(homedir2(), ".codex");
@@ -563,7 +560,7 @@ async function installCodex(apiKey) {
   ].join("\n");
   const final = existing.trimEnd() + "\n" + tomlBlock + "\n";
   await writeFile6(configPath2, final, "utf-8");
-  console.log(pc11.green("\u2713") + ` Recursiv MCP added to ${pc11.dim(configPath2)}`);
+  console.log(pc12.green("\u2713") + ` Recursiv MCP added to ${pc12.dim(configPath2)}`);
 }
 async function installOpenCode(apiKey, global) {
   let configPath2;
@@ -585,16 +582,16 @@ async function installOpenCode(apiKey, global) {
     }
   };
   await writeFile6(configPath2, JSON.stringify(config, null, 2) + "\n", "utf-8");
-  console.log(pc11.green("\u2713") + ` Recursiv MCP added to ${pc11.dim(configPath2)}`);
+  console.log(pc12.green("\u2713") + ` Recursiv MCP added to ${pc12.dim(configPath2)}`);
 }
 async function mcpVerifyCommand() {
   const { spawn: spawn2 } = await import("child_process");
-  const apiKey = process.env.RECURSIV_API_KEY || process.env.SOCIAL_DEV_API_KEY;
+  const apiKey = process.env.RECURSIV_API_KEY;
   if (!apiKey) {
-    console.error(pc11.red("  error") + " RECURSIV_API_KEY not set in environment.");
+    console.error(pc12.red("  error") + " RECURSIV_API_KEY not set in environment.");
     process.exit(1);
   }
-  console.log(pc11.dim("  Verifying Recursiv MCP server..."));
+  console.log(pc12.dim("  Verifying Recursiv MCP server..."));
   const child = spawn2("npx", ["-y", "@recursiv/mcp"], {
     env: { ...process.env, RECURSIV_API_KEY: apiKey },
     stdio: ["pipe", "pipe", "pipe"]
@@ -636,24 +633,24 @@ async function mcpVerifyCommand() {
   child.kill();
   switch (result) {
     case "ok":
-      console.log(pc11.green("  \u2713") + " MCP server responded successfully.");
+      console.log(pc12.green("  \u2713") + " MCP server responded successfully.");
       try {
         const parsed = JSON.parse(stdout.trim().split("\n").pop() || "{}");
         const serverName = parsed?.result?.serverInfo?.name;
         const version = parsed?.result?.serverInfo?.version;
         if (serverName) {
-          console.log(pc11.dim(`  Server: ${serverName} v${version || "?"}`));
+          console.log(pc12.dim(`  Server: ${serverName} v${version || "?"}`));
         }
       } catch {
       }
       break;
     case "error":
-      console.error(pc11.red("  \u2717") + " MCP server returned an error.");
-      if (stderr) console.error(pc11.dim(`  ${stderr.trim()}`));
+      console.error(pc12.red("  \u2717") + " MCP server returned an error.");
+      if (stderr) console.error(pc12.dim(`  ${stderr.trim()}`));
       process.exit(1);
       break;
     case "timeout":
-      console.error(pc11.red("  \u2717") + " MCP server did not respond within 10s.");
+      console.error(pc12.red("  \u2717") + " MCP server did not respond within 10s.");
       process.exit(1);
       break;
   }
@@ -703,8 +700,127 @@ var init_mcp_install = __esm({
   }
 });
 
+// src/commands/quickstart.ts
+var quickstart_exports = {};
+__export(quickstart_exports, {
+  checkGitHubCli: () => checkGitHubCli,
+  quickstartCommand: () => quickstartCommand
+});
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { platform as platform2 } from "os";
+import pc13 from "picocolors";
+async function checkGitHubCli() {
+  try {
+    await execFileAsync("gh", ["--version"]);
+  } catch {
+    return { installed: false, authenticated: false };
+  }
+  try {
+    await execFileAsync("gh", ["auth", "status"]);
+    return { installed: true, authenticated: true };
+  } catch {
+    return { installed: true, authenticated: false };
+  }
+}
+function ghInstallHint() {
+  const p = platform2();
+  if (p === "darwin") return "Install with: brew install gh";
+  if (p === "win32") return "Install with: winget install GitHub.cli";
+  return "Install instructions: https://cli.github.com/";
+}
+async function fetchUsername(apiKey, baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/users/me`, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        Accept: "application/json"
+      }
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    return body.data?.username ?? body.data?.email ?? null;
+  } catch {
+    return null;
+  }
+}
+async function quickstartCommand(opts = {}) {
+  console.log();
+  console.log(pc13.bold("  Setting up Recursiv on this machine") + pc13.dim(" \u2014 Claude Code + GitHub CLI + Recursiv account. ~3 minutes."));
+  console.log();
+  log.step(1, 3, "Checking GitHub CLI");
+  const ghCheck = opts.ghCheck ?? checkGitHubCli;
+  const gh = await ghCheck();
+  if (!gh.installed) {
+    log.error("GitHub CLI (`gh`) is not installed.");
+    log.info(ghInstallHint());
+    log.info("After installing, re-run `recursiv quickstart`.");
+    process.exit(1);
+    return;
+  }
+  if (!gh.authenticated) {
+    log.error("GitHub CLI is installed but not authenticated.");
+    log.info("Run `gh auth login` in another terminal, then re-run `recursiv quickstart`.");
+    process.exit(1);
+    return;
+  }
+  log.success("GitHub CLI installed and authenticated");
+  log.step(2, 3, "Checking Recursiv account");
+  const cwd = process.cwd();
+  const config = await readConfig(cwd).catch(() => null);
+  const baseUrl = config?.api.baseUrl ?? "https://api.recursiv.io/api/v1";
+  let apiKey = await resolveRecursivKey(cwd);
+  if (apiKey) {
+    const username = await fetchUsername(apiKey, baseUrl);
+    if (username) {
+      log.success(`Already authenticated as ${pc13.bold(username)}`);
+    } else {
+      log.success("Already authenticated (using existing API key)");
+    }
+  } else {
+    console.log();
+    console.log(pc13.dim("  No Recursiv API key found. Let's create one."));
+    console.log();
+    apiKey = await getOrCreateApiKey(baseUrl);
+    if (!apiKey) {
+      log.error("Authentication required to continue.");
+      process.exit(1);
+      return;
+    }
+    await saveCredentials({ recursivApiKey: apiKey });
+    log.success("Credentials saved to ~/.recursiv/credentials");
+  }
+  log.step(3, 3, "Configuring Recursiv MCP for Claude Code");
+  await mcpInstallCommand({ target: "claude-code", apiKey });
+  console.log();
+  console.log(pc13.green(pc13.bold("  Done.")) + pc13.dim(" Next steps:"));
+  console.log();
+  const quitHint = platform2() === "win32" ? "fully quit Claude Code (exit from the system tray)" : "fully quit Claude Code (Cmd-Q on macOS)";
+  console.log("    1. " + quitHint);
+  console.log("    2. Reopen Claude Code in this folder");
+  console.log("    3. Paste the prompt from " + pc13.underline(TUTORIAL_URL));
+  console.log("       into your first chat message");
+  console.log();
+  console.log(pc13.dim("  Tip: when Claude Code asks to approve the first Recursiv tool call,"));
+  console.log(pc13.dim('  choose "Always allow recursiv" so you are not prompted again.'));
+  console.log();
+}
+var execFileAsync, TUTORIAL_URL;
+var init_quickstart = __esm({
+  "src/commands/quickstart.ts"() {
+    "use strict";
+    init_logger();
+    init_config();
+    init_credentials();
+    init_auth_flow();
+    init_mcp_install();
+    execFileAsync = promisify(execFile);
+    TUTORIAL_URL = "https://docs.recursiv.io/guides/tutorials/build-your-first-app";
+  }
+});
+
 // src/chat/renderer.ts
-import pc12 from "picocolors";
+import pc14 from "picocolors";
 function getWidth() {
   return Math.max((process.stdout.columns || 80) - INDENT.length, 40);
 }
@@ -730,23 +846,23 @@ function wordWrap(text, width, indent = INDENT) {
   return lines.join("\n");
 }
 function colorize(text) {
-  text = text.replace(/(https?:\/\/[^\s)\]>]+)/g, pc12.cyan(pc12.underline("$1")));
-  text = text.replace(/`([^`]+)`/g, pc12.yellow("`$1`"));
-  text = text.replace(/\*\*([^*]+)\*\*/g, pc12.bold("$1"));
-  text = text.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, pc12.italic("$1"));
+  text = text.replace(/(https?:\/\/[^\s)\]>]+)/g, pc14.cyan(pc14.underline("$1")));
+  text = text.replace(/`([^`]+)`/g, pc14.yellow("`$1`"));
+  text = text.replace(/\*\*([^*]+)\*\*/g, pc14.bold("$1"));
+  text = text.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, pc14.italic("$1"));
   return text;
 }
 function printBanner(opts) {
   const v = opts?.version ?? "0.1.4";
   const logo = [
-    pc12.cyan("  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"),
-    pc12.cyan("  \u2502 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502"),
-    pc12.cyan("  \u2502 \u2502 \u250C\u2500\u2500\u2500\u2500\u2500\u2510 \u2502 \u2502") + "   " + pc12.bold(pc12.cyan("recursiv")) + pc12.dim(` v${v}`),
-    pc12.cyan("  \u2502 \u2502 \u2502 \u250C\u2500\u2510 \u2502 \u2502 \u2502") + "   " + pc12.dim("https://recursiv.io"),
-    pc12.cyan("  \u2502 \u2502 \u2502 \u2514\u2500\u2518 \u2502 \u2502 \u2502"),
-    pc12.cyan("  \u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2518 \u2502 \u2502"),
-    pc12.cyan("  \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502"),
-    pc12.cyan("  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518")
+    pc14.cyan("  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"),
+    pc14.cyan("  \u2502 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510 \u2502"),
+    pc14.cyan("  \u2502 \u2502 \u250C\u2500\u2500\u2500\u2500\u2500\u2510 \u2502 \u2502") + "   " + pc14.bold(pc14.cyan("recursiv")) + pc14.dim(` v${v}`),
+    pc14.cyan("  \u2502 \u2502 \u2502 \u250C\u2500\u2510 \u2502 \u2502 \u2502") + "   " + pc14.dim("https://recursiv.io"),
+    pc14.cyan("  \u2502 \u2502 \u2502 \u2514\u2500\u2518 \u2502 \u2502 \u2502"),
+    pc14.cyan("  \u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2518 \u2502 \u2502"),
+    pc14.cyan("  \u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518 \u2502"),
+    pc14.cyan("  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518")
   ];
   console.log();
   for (const line of logo) {
@@ -754,26 +870,26 @@ function printBanner(opts) {
   }
   console.log();
   if (opts?.email || opts?.username) {
-    const identity = opts.email ? `${opts.username ? pc12.bold(`@${opts.username}`) : "signed in"} ${pc12.dim(`(${opts.email})`)}` : pc12.bold(`@${opts.username}`);
-    console.log(pc12.dim("  ") + identity);
+    const identity = opts.email ? `${opts.username ? pc14.bold(`@${opts.username}`) : "signed in"} ${pc14.dim(`(${opts.email})`)}` : pc14.bold(`@${opts.username}`);
+    console.log(pc14.dim("  ") + identity);
   }
   if (opts?.resumed) {
     console.log(
-      pc12.dim("  ") + pc12.dim(`resumed session ${opts.resumed.id} (${opts.resumed.messageCount} messages)`)
+      pc14.dim("  ") + pc14.dim(`resumed session ${opts.resumed.id} (${opts.resumed.messageCount} messages)`)
     );
   }
   console.log();
-  console.log(pc12.dim("  Type a message to get started. /help for commands. Ctrl-D to exit."));
+  console.log(pc14.dim("  Type a message to get started. /help for commands. Ctrl-D to exit."));
 }
 function printPrompt() {
-  process.stdout.write(pc12.bold(pc12.green("> ")));
+  process.stdout.write(pc14.bold(pc14.green("> ")));
 }
 function printTips(context = "welcome") {
   const tips = HINT_MAP[context] || HINT_MAP.default;
   console.log();
   for (const [cmd, desc] of tips) {
     console.log(
-      INDENT + pc12.dim("  ") + pc12.cyan(cmd) + pc12.dim(` \u2014 ${desc}`)
+      INDENT + pc14.dim("  ") + pc14.cyan(cmd) + pc14.dim(` \u2014 ${desc}`)
     );
   }
   console.log();
@@ -790,23 +906,23 @@ function detectHintContext(responseText) {
 }
 function printAssistantLabel() {
   console.log();
-  process.stdout.write(pc12.bold(pc12.cyan("recursiv ")) + "\n");
+  process.stdout.write(pc14.bold(pc14.cyan("recursiv ")) + "\n");
 }
 function printToolCall(name) {
-  console.log(pc12.yellow("  \u25B8 ") + pc12.dim(name));
+  console.log(pc14.yellow("  \u25B8 ") + pc14.dim(name));
 }
 function printToolResult(name, success) {
   if (success) {
-    console.log(pc12.green("  \u2713 ") + pc12.dim(name));
+    console.log(pc14.green("  \u2713 ") + pc14.dim(name));
   } else {
-    console.log(pc12.red("  \u2717 ") + pc12.dim(name));
+    console.log(pc14.red("  \u2717 ") + pc14.dim(name));
   }
 }
 function startThinking() {
   const frames = ["   \xB7", "   \xB7\xB7", "   \xB7\xB7\xB7"];
   let i = 0;
   const interval = setInterval(() => {
-    process.stdout.write(`\r${pc12.dim(frames[i % frames.length])}  `);
+    process.stdout.write(`\r${pc14.dim(frames[i % frames.length])}  `);
     i++;
   }, 250);
   return {
@@ -817,11 +933,11 @@ function startThinking() {
   };
 }
 async function confirmAction(description) {
-  const { createInterface: createInterface2 } = await import("readline");
-  const rl = createInterface2({ input: process.stdin, output: process.stdout, terminal: true });
+  const readline = await import("readline");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
   return new Promise((resolve4) => {
     process.stdout.write(
-      pc12.yellow("  ? ") + description + pc12.dim(" (y/n) ")
+      pc14.yellow("  ? ") + description + pc14.dim(" (y/n) ")
     );
     rl.once("line", (line) => {
       rl.close();
@@ -832,10 +948,10 @@ async function confirmAction(description) {
   });
 }
 function printError(message) {
-  console.log(pc12.red("  \u2717 ") + message);
+  console.log(pc14.red("  \u2717 ") + message);
 }
 function printInfo(message) {
-  console.log(pc12.dim(message));
+  console.log(pc14.dim(message));
 }
 var INDENT, StreamWriter, HINT_MAP;
 var init_renderer = __esm({
@@ -861,11 +977,11 @@ var init_renderer = __esm({
         const width = getWidth();
         if (line.trimStart().startsWith("```")) {
           this.inCodeBlock = !this.inCodeBlock;
-          process.stdout.write(INDENT + pc12.dim(line));
+          process.stdout.write(INDENT + pc14.dim(line));
           return;
         }
         if (this.inCodeBlock) {
-          process.stdout.write(INDENT + pc12.cyan(line));
+          process.stdout.write(INDENT + pc14.cyan(line));
           return;
         }
         if (line.trim() === "") {
@@ -874,18 +990,18 @@ var init_renderer = __esm({
         }
         const headingMatch = line.match(/^(#{1,3})\s+(.+)\n?$/);
         if (headingMatch) {
-          process.stdout.write(INDENT + pc12.bold(pc12.cyan(headingMatch[2])) + "\n");
+          process.stdout.write(INDENT + pc14.bold(pc14.cyan(headingMatch[2])) + "\n");
           return;
         }
         if (/^---+\s*\n?$/.test(line)) {
-          process.stdout.write(INDENT + pc12.dim("\u2500".repeat(Math.min(width, 60))) + "\n");
+          process.stdout.write(INDENT + pc14.dim("\u2500".repeat(Math.min(width, 60))) + "\n");
           return;
         }
         const bulletMatch = line.match(/^(\s*)([-*])\s+(.*)$/);
         if (bulletMatch) {
           const extraIndent = bulletMatch[1];
           const content = colorize(bulletMatch[3]);
-          const prefix = INDENT + extraIndent + pc12.cyan("\u2022") + " ";
+          const prefix = INDENT + extraIndent + pc14.cyan("\u2022") + " ";
           process.stdout.write(prefix + content + "\n");
           return;
         }
@@ -894,7 +1010,7 @@ var init_renderer = __esm({
           const extraIndent = numMatch[1];
           const num = numMatch[2];
           const content = colorize(numMatch[3]);
-          const prefix = INDENT + extraIndent + pc12.cyan(num + ".") + " ";
+          const prefix = INDENT + extraIndent + pc14.cyan(num + ".") + " ";
           process.stdout.write(prefix + content + "\n");
           return;
         }
@@ -910,7 +1026,7 @@ var init_renderer = __esm({
           const remaining = this.lineBuffer;
           this.lineBuffer = "";
           if (this.inCodeBlock) {
-            process.stdout.write(pc12.cyan(remaining));
+            process.stdout.write(pc14.cyan(remaining));
           } else {
             process.stdout.write(colorize(remaining));
           }
@@ -1764,8 +1880,8 @@ import { createInterface } from "readline";
 import { existsSync as existsSync3, readFileSync } from "fs";
 import { basename as basename2, join as join7 } from "path";
 import { execSync as execSync2 } from "child_process";
-import { Recursiv } from "@recursiv/sdk";
-import pc13 from "picocolors";
+import { Recursiv, InsufficientCreditsError as InsufficientCreditsError2 } from "@recursiv/sdk";
+import pc15 from "picocolors";
 async function startAgent(config) {
   const client = new Recursiv({
     apiKey: config.recursivApiKey,
@@ -1868,7 +1984,7 @@ async function replProxy(rl, client, session) {
 ${trimmed}` : trimmed;
     try {
       if (planMode) {
-        console.log(pc13.dim("  \u25C6 plan mode"));
+        console.log(pc15.dim("  \u25C6 plan mode"));
       }
       printAssistantLabel();
       const thinking = startThinking();
@@ -1917,6 +2033,12 @@ ${trimmed}` : trimmed;
         printTips(hintCtx);
       }
     } catch (err) {
+      if (err instanceof InsufficientCreditsError2) {
+        printError("Out of credits \u2014 your account has no remaining balance.");
+        printInfo(`  Upgrade: ${err.upgradeUrl}`);
+        console.log();
+        continue;
+      }
       const message = err instanceof Error ? err.message : String(err);
       if (message.includes("rate_limit") || message.includes("429")) {
         printError("Rate limited \u2014 wait a moment and try again.");
@@ -2087,39 +2209,39 @@ async function handleSlashCommand(input, session, client) {
     case "/plan":
       planMode = !planMode;
       if (planMode) {
-        console.log(pc13.cyan("  \u25C6 Plan mode ON") + pc13.dim(" \u2014 agent will outline steps before executing"));
+        console.log(pc15.cyan("  \u25C6 Plan mode ON") + pc15.dim(" \u2014 agent will outline steps before executing"));
       } else {
-        console.log(pc13.green("  \u25C6 Plan mode OFF") + pc13.dim(" \u2014 agent will execute immediately"));
+        console.log(pc15.green("  \u25C6 Plan mode OFF") + pc15.dim(" \u2014 agent will execute immediately"));
       }
       console.log();
       return true;
     case "/clear":
       session.messages = [];
-      console.log(pc13.dim("  Conversation cleared."));
+      console.log(pc15.dim("  Conversation cleared."));
       console.log();
       return true;
     case "/help":
       console.log();
-      console.log(pc13.bold("  Commands"));
-      console.log(pc13.dim("  /help       ") + "Show this help");
-      console.log(pc13.dim("  /plan       ") + "Toggle plan mode (outline before executing)");
-      console.log(pc13.dim("  /clear      ") + "Clear conversation history");
-      console.log(pc13.dim("  /status     ") + "Show connection status");
-      console.log(pc13.dim("  /context    ") + "Show full user context (profile, orgs, tier)");
-      console.log(pc13.dim("  /sessions   ") + "List recent sessions");
-      console.log(pc13.dim("  /load <id>  ") + "Load a previous session by ID");
-      console.log(pc13.dim("  /exit       ") + "Exit the CLI");
+      console.log(pc15.bold("  Commands"));
+      console.log(pc15.dim("  /help       ") + "Show this help");
+      console.log(pc15.dim("  /plan       ") + "Toggle plan mode (outline before executing)");
+      console.log(pc15.dim("  /clear      ") + "Clear conversation history");
+      console.log(pc15.dim("  /status     ") + "Show connection status");
+      console.log(pc15.dim("  /context    ") + "Show full user context (profile, orgs, tier)");
+      console.log(pc15.dim("  /sessions   ") + "List recent sessions");
+      console.log(pc15.dim("  /load <id>  ") + "Load a previous session by ID");
+      console.log(pc15.dim("  /exit       ") + "Exit the CLI");
       console.log();
-      console.log(pc13.bold("  Usage"));
-      console.log(pc13.dim("  Just type naturally. Examples:"));
-      console.log(pc13.dim('  "show my posts"'));
-      console.log(pc13.dim('  "create a post saying hello world"'));
-      console.log(pc13.dim('  "list my agents"'));
-      console.log(pc13.dim('  "what communities can I join?"'));
-      console.log(pc13.dim('  "check my unread messages"'));
-      console.log(pc13.dim('  "show dispatcher tasks"'));
+      console.log(pc15.bold("  Usage"));
+      console.log(pc15.dim("  Just type naturally. Examples:"));
+      console.log(pc15.dim('  "show my posts"'));
+      console.log(pc15.dim('  "create a post saying hello world"'));
+      console.log(pc15.dim('  "list my agents"'));
+      console.log(pc15.dim('  "what communities can I join?"'));
+      console.log(pc15.dim('  "check my unread messages"'));
+      console.log(pc15.dim('  "show dispatcher tasks"'));
       console.log();
-      console.log(pc13.dim("  Destructive actions (delete, deploy, send) require confirmation."));
+      console.log(pc15.dim("  Destructive actions (delete, deploy, send) require confirmation."));
       console.log();
       return true;
     case "/status":
@@ -2127,11 +2249,11 @@ async function handleSlashCommand(input, session, client) {
         const profile = await client.profiles.me();
         const data = profile.data;
         console.log();
-        console.log(pc13.bold("  Status"));
-        console.log(pc13.dim("  User:    ") + pc13.bold(`@${data.username || "unknown"}`));
-        if (data.email) console.log(pc13.dim("  Email:   ") + data.email);
-        console.log(pc13.dim("  Session: ") + session.id.slice(0, 8));
-        console.log(pc13.dim("  History: ") + `${session.messages.length} messages`);
+        console.log(pc15.bold("  Status"));
+        console.log(pc15.dim("  User:    ") + pc15.bold(`@${data.username || "unknown"}`));
+        if (data.email) console.log(pc15.dim("  Email:   ") + data.email);
+        console.log(pc15.dim("  Session: ") + session.id.slice(0, 8));
+        console.log(pc15.dim("  History: ") + `${session.messages.length} messages`);
         console.log();
       } catch {
         printError("Could not fetch status \u2014 check your API key");
@@ -2146,35 +2268,35 @@ async function handleSlashCommand(input, session, client) {
           client.freeTier.getTier()
         ]);
         console.log();
-        console.log(pc13.bold("  User Context"));
+        console.log(pc15.bold("  User Context"));
         if (profile.status === "fulfilled") {
           const p = profile.value.data;
-          console.log(pc13.dim("  User:      ") + pc13.bold(`@${p.username || "unknown"}`));
-          console.log(pc13.dim("  Name:      ") + (p.name || "-"));
-          console.log(pc13.dim("  Email:     ") + (p.email || "-"));
-          console.log(pc13.dim("  Followers: ") + (p.followers_count ?? 0));
-          console.log(pc13.dim("  Following: ") + (p.following_count ?? 0));
+          console.log(pc15.dim("  User:      ") + pc15.bold(`@${p.username || "unknown"}`));
+          console.log(pc15.dim("  Name:      ") + (p.name || "-"));
+          console.log(pc15.dim("  Email:     ") + (p.email || "-"));
+          console.log(pc15.dim("  Followers: ") + (p.followers_count ?? 0));
+          console.log(pc15.dim("  Following: ") + (p.following_count ?? 0));
         }
         if (orgs.status === "fulfilled") {
           const orgList = orgs.value.data;
           console.log();
-          console.log(pc13.bold("  Organizations"));
+          console.log(pc15.bold("  Organizations"));
           if (orgList.length === 0) {
-            console.log(pc13.dim("  None"));
+            console.log(pc15.dim("  None"));
           } else {
             for (const org of orgList) {
-              const role = org.role ? pc13.dim(` (${org.role})`) : "";
-              console.log(`  - ${pc13.bold(org.name)}${role}`);
+              const role = org.role ? pc15.dim(` (${org.role})`) : "";
+              console.log(`  - ${pc15.bold(org.name)}${role}`);
             }
           }
         }
         if (tier.status === "fulfilled") {
           const t = tier.value.data;
           console.log();
-          console.log(pc13.bold("  Tier"));
-          console.log(pc13.dim("  Plan:  ") + (t.tier || t.plan || "free"));
+          console.log(pc15.bold("  Tier"));
+          console.log(pc15.dim("  Plan:  ") + (t.tier || t.plan || "free"));
           if (t.api_calls_remaining != null) {
-            console.log(pc13.dim("  Calls: ") + `${t.api_calls_remaining} remaining`);
+            console.log(pc15.dim("  Calls: ") + `${t.api_calls_remaining} remaining`);
           }
         }
         console.log();
@@ -2187,14 +2309,14 @@ async function handleSlashCommand(input, session, client) {
       const sessions = await listSessions();
       console.log();
       if (sessions.length === 0) {
-        console.log(pc13.dim("  No saved sessions."));
+        console.log(pc15.dim("  No saved sessions."));
       } else {
-        console.log(pc13.bold("  Recent Sessions"));
+        console.log(pc15.bold("  Recent Sessions"));
         for (const s of sessions) {
-          const current = s.id === session.id ? pc13.green(" (current)") : "";
+          const current = s.id === session.id ? pc15.green(" (current)") : "";
           const date = new Date(s.createdAt).toLocaleDateString();
           console.log(
-            pc13.dim("  ") + pc13.bold(s.id.slice(0, 8)) + pc13.dim(` \u2014 ${date}, ${s.messageCount} messages`) + current
+            pc15.dim("  ") + pc15.bold(s.id.slice(0, 8)) + pc15.dim(` \u2014 ${date}, ${s.messageCount} messages`) + current
           );
         }
       }
@@ -2205,7 +2327,7 @@ async function handleSlashCommand(input, session, client) {
       const parts = input.split(/\s+/);
       const targetId = parts[1];
       if (!targetId) {
-        console.log(pc13.dim("  Usage: /load <session-id>"));
+        console.log(pc15.dim("  Usage: /load <session-id>"));
         console.log();
         return true;
       }
@@ -2226,13 +2348,13 @@ async function handleSlashCommand(input, session, client) {
       session.createdAt = loaded.createdAt;
       session.messages = loaded.messages;
       console.log(
-        pc13.dim("  ") + `Loaded session ${pc13.bold(loaded.id.slice(0, 8))} (${loaded.messages.length} messages)`
+        pc15.dim("  ") + `Loaded session ${pc15.bold(loaded.id.slice(0, 8))} (${loaded.messages.length} messages)`
       );
       console.log();
       return true;
     }
     default:
-      console.log(pc13.dim(`  Unknown command: ${cmd}. Type /help for available commands.`));
+      console.log(pc15.dim(`  Unknown command: ${cmd}. Type /help for available commands.`));
       console.log();
       return true;
   }
@@ -2329,6 +2451,19 @@ Tone: precise, efficient, slightly warm. Senior engineer energy.`;
 // src/bin/recursiv.ts
 import { Command } from "commander";
 
+// src/lib/cli-errors.ts
+import pc from "picocolors";
+import { InsufficientCreditsError } from "@recursiv/sdk";
+function printCliError(err) {
+  if (err instanceof InsufficientCreditsError) {
+    console.error(pc.red("  Out of credits."));
+    console.error(`  ${err.message.split("\n")[0]}`);
+    console.error(`  Upgrade: ${pc.bold(pc.cyan(err.upgradeUrl))}`);
+    return;
+  }
+  console.error(err instanceof Error ? err.message : err);
+}
+
 // src/commands/init.ts
 init_logger();
 init_config();
@@ -2338,7 +2473,7 @@ import { mkdir, readFile as readFile3, unlink, writeFile as writeFile3 } from "f
 import { resolve } from "path";
 import { execSync } from "child_process";
 import prompts2 from "prompts";
-import pc3 from "picocolors";
+import pc4 from "picocolors";
 import ora2 from "ora";
 
 // src/lib/templates.ts
@@ -2450,12 +2585,12 @@ async function initCommand(nameArg) {
   }
   const projectDir = resolve(process.cwd(), projectName);
   if (existsSync2(projectDir)) {
-    log.error(`Directory ${pc3.bold(projectName)} already exists`);
+    log.error(`Directory ${pc4.bold(projectName)} already exists`);
     process.exit(1);
   }
   log.step(2, totalSteps, "Choose a template");
   const templateChoices = templates.map((t) => ({
-    title: t.recommended ? `${t.name} ${pc3.dim("(recommended)")}` : t.name,
+    title: t.recommended ? `${t.name} ${pc4.dim("(recommended)")}` : t.name,
     description: t.description,
     value: t.id
   }));
@@ -2510,7 +2645,7 @@ async function initCommand(nameArg) {
     );
   }
   log.step(6, totalSteps, "Installing dependencies");
-  const installSpinner = ora2(`Running ${pc3.bold(installCommand(pm))}...`).start();
+  const installSpinner = ora2(`Running ${pc4.bold(installCommand(pm))}...`).start();
   try {
     execSync(installCommand(pm), {
       cwd: projectDir,
@@ -2534,18 +2669,18 @@ async function initCommand(nameArg) {
     log.warn("Could not initialize git repository");
   }
   log.blank();
-  console.log(pc3.bold(pc3.green("Your Recursiv app is ready!")));
+  console.log(pc4.bold(pc4.green("Your Recursiv app is ready!")));
   log.blank();
   console.log("  Next steps:");
   console.log();
-  console.log(`  ${pc3.dim("$")} cd ${projectName}`);
+  console.log(`  ${pc4.dim("$")} cd ${projectName}`);
   if (!apiKey) {
-    console.log(`  ${pc3.dim("$")} ${pc3.dim("# Add your API key to .env")}`);
+    console.log(`  ${pc4.dim("$")} ${pc4.dim("# Add your API key to .env")}`);
   }
-  console.log(`  ${pc3.dim("$")} ${runCommand(pm, "dev")}`);
+  console.log(`  ${pc4.dim("$")} ${runCommand(pm, "dev")}`);
   log.blank();
-  console.log(pc3.dim("Docs: https://docs.recursiv.io"));
-  console.log(pc3.dim("Dashboard: https://recursiv.io/dashboard"));
+  console.log(pc4.dim("Docs: https://docs.recursiv.io"));
+  console.log(pc4.dim("Dashboard: https://recursiv.io/dashboard"));
   log.blank();
 }
 
@@ -2554,13 +2689,13 @@ init_logger();
 init_config();
 init_env();
 import { spawn } from "child_process";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 async function devCommand(opts) {
   const cwd = process.cwd();
   const config = await readConfig(cwd);
   if (!config) {
     log.error("No .recursiv.json found \u2014 are you in a Recursiv project?");
-    log.info(`Run ${pc4.bold("create-recursiv-app")} to create a new project`);
+    log.info(`Run ${pc5.bold("create-recursiv-app")} to create a new project`);
     process.exit(1);
   }
   const apiKey = await readApiKeyFromEnv(cwd);
@@ -2576,14 +2711,9 @@ async function devCommand(opts) {
   };
   if (apiKey) {
     env.RECURSIV_API_KEY = apiKey;
-    if (config.project.framework === "nextjs") {
-      env.NEXT_PUBLIC_RECURSIV_API_KEY = apiKey;
-    } else if (config.project.framework === "vite") {
-      env.VITE_RECURSIV_API_KEY = apiKey;
-    }
   }
-  log.info(`Starting dev server on port ${pc4.bold(port)}`);
-  log.info(`Running: ${pc4.dim(devCmd)}`);
+  log.info(`Starting dev server on port ${pc5.bold(port)}`);
+  log.info(`Running: ${pc5.dim(devCmd)}`);
   console.log();
   const [cmd, ...args] = devCmd.split(" ");
   const child = spawn(cmd, args, {
@@ -2607,7 +2737,7 @@ init_logger();
 init_config();
 import { writeFile as writeFile4 } from "fs/promises";
 import { resolve as resolve2 } from "path";
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 import ora3 from "ora";
 var targets = [
   {
@@ -2693,12 +2823,12 @@ async function deployCommand(target) {
   }
   if (target === "cloud") {
     log.info("Cloud deployment via Recursiv is coming soon");
-    log.info(`For now, deploy to Vercel, Render, or Railway with ${pc5.bold("recursiv deploy <target>")}`);
+    log.info(`For now, deploy to Vercel, Render, or Railway with ${pc6.bold("recursiv deploy <target>")}`);
     return;
   }
   const deployTarget = targets.find((t) => t.id === target);
   if (!deployTarget) {
-    log.error(`Unknown target: ${pc5.bold(target)}`);
+    log.error(`Unknown target: ${pc6.bold(target)}`);
     log.info(`Available targets: ${targets.map((t) => t.id).join(", ")}, cloud`);
     process.exit(1);
   }
@@ -2708,9 +2838,9 @@ async function deployCommand(target) {
     config.project.framework
   );
   await writeFile4(resolve2(cwd, file), content + "\n", "utf-8");
-  spinner.succeed(`Created ${pc5.bold(file)}`);
+  spinner.succeed(`Created ${pc6.bold(file)}`);
   log.blank();
-  log.info(`Remember to set ${pc5.bold("RECURSIV_API_KEY")} in your ${deployTarget.name} environment`);
+  log.info(`Remember to set ${pc6.bold("RECURSIV_API_KEY")} in your ${deployTarget.name} environment`);
 }
 
 // src/commands/auth.ts
@@ -2719,14 +2849,14 @@ init_env();
 init_auth_flow();
 init_config();
 init_credentials();
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 async function loginCommand() {
   const cwd = process.cwd();
   const config = await readConfig(cwd);
   const baseUrl = config?.api.baseUrl ?? "https://api.recursiv.io/api/v1";
   const existing = await resolveRecursivKey(cwd);
   if (existing) {
-    log.info(`Existing key found: ${pc6.dim(maskKey(existing))}`);
+    log.info(`Existing key found: ${pc7.dim(maskKey(existing))}`);
     log.info("Enter a new key to replace it, or press Enter to keep it");
   }
   const apiKey = await getOrCreateApiKey(baseUrl);
@@ -2757,10 +2887,10 @@ async function whoamiCommand() {
   const apiKey = await resolveRecursivKey(cwd);
   if (!apiKey) {
     log.error("No API key found in .env");
-    log.info(`Run ${pc6.bold("recursiv auth login")} to set one`);
+    log.info(`Run ${pc7.bold("recursiv auth login")} to set one`);
     return;
   }
-  log.info(`Key: ${pc6.dim(maskKey(apiKey))}`);
+  log.info(`Key: ${pc7.dim(maskKey(apiKey))}`);
   try {
     const res = await fetch(`${baseUrl}/users/me`, {
       headers: {
@@ -2773,7 +2903,7 @@ async function whoamiCommand() {
       return;
     }
     const body = await res.json();
-    if (body.data.username) log.info(`User: ${pc6.bold(body.data.username)}`);
+    if (body.data.username) log.info(`User: ${pc7.bold(body.data.username)}`);
     if (body.data.email) log.info(`Email: ${body.data.email}`);
   } catch {
     log.warn("Could not reach API \u2014 check your network");
@@ -2788,30 +2918,30 @@ function maskKey(key) {
 init_logger();
 init_config();
 init_env();
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 async function infoCommand() {
   const cwd = process.cwd();
   const config = await readConfig(cwd);
   if (!config) {
     log.error("No .recursiv.json found \u2014 are you in a Recursiv project?");
-    log.info(`Run ${pc7.bold("create-recursiv-app")} to create a new project`);
+    log.info(`Run ${pc8.bold("create-recursiv-app")} to create a new project`);
     process.exit(1);
   }
   const apiKey = await readApiKeyFromEnv(cwd);
   const pm = detectPackageManager(cwd);
   const template = getTemplate(config.project.template);
   console.log();
-  console.log(pc7.bold("Project Info"));
+  console.log(pc8.bold("Project Info"));
   console.log();
-  console.log(`  Name:       ${pc7.bold(config.project.name)}`);
+  console.log(`  Name:       ${pc8.bold(config.project.name)}`);
   console.log(`  Template:   ${template?.name ?? config.project.template}`);
   console.log(`  Framework:  ${config.project.framework}`);
   console.log(`  Dev port:   ${config.dev.port}`);
-  console.log(`  Dev cmd:    ${pc7.dim(config.dev.command)}`);
+  console.log(`  Dev cmd:    ${pc8.dim(config.dev.command)}`);
   console.log(`  Pkg mgr:    ${pm}`);
-  console.log(`  API URL:    ${pc7.dim(config.api.baseUrl)}`);
-  console.log(`  API key:    ${apiKey ? pc7.green("configured") : pc7.yellow("not set")}`);
-  console.log(`  Config:     ${pc7.dim(".recursiv.json v" + config.version)}`);
+  console.log(`  API URL:    ${pc8.dim(config.api.baseUrl)}`);
+  console.log(`  API key:    ${apiKey ? pc8.green("configured") : pc8.yellow("not set")}`);
+  console.log(`  Config:     ${pc8.dim(".recursiv.json v" + config.version)}`);
   console.log();
   if (apiKey) {
     try {
@@ -2905,7 +3035,7 @@ A neural CLI reflection of your product surface with neurons, particles, and wav
 
 ## Data + Realtime
 - PostgreSQL + Drizzle ORM
-- Kafka + Socket.IO
+- Socket.IO + optional Redis adapter
 
 ## Agents
 - Composio + E2B + OpenRouter`
@@ -3537,7 +3667,7 @@ async function studioCommand(opts) {
 }
 
 // src/commands/browser-use.ts
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 import { BrowserUse } from "browser-use-sdk";
 function getClient() {
   const apiKey = process.env.BROWSER_USE_API_KEY;
@@ -3563,11 +3693,11 @@ async function browserUseRunCommand(opts) {
     console.log(JSON.stringify(result, null, 2));
     return;
   }
-  console.log(pc8.green("Browser Use task complete"));
-  console.log(`${pc8.dim("Task:")} ${opts.task}`);
-  console.log(`${pc8.dim("Status:")} ${result.status}`);
+  console.log(pc9.green("Browser Use task complete"));
+  console.log(`${pc9.dim("Task:")} ${opts.task}`);
+  console.log(`${pc9.dim("Status:")} ${result.status}`);
   if (result.output) {
-    console.log(`${pc8.dim("Output:")} ${String(result.output)}`);
+    console.log(`${pc9.dim("Output:")} ${String(result.output)}`);
   }
 }
 async function browserUseMcpSnippetCommand(opts) {
@@ -3611,19 +3741,19 @@ async function browserUseMcpSnippetCommand(opts) {
 }
 
 // src/commands/api.ts
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 
 // src/lib/api.ts
 init_config();
 init_env();
 init_logger();
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 async function getApiContext(cwd) {
   const config = await readConfig(cwd);
   const apiKey = await readApiKeyFromEnv(cwd);
   if (!apiKey) {
     log.error("No API key configured.");
-    log.info(`Run ${pc9.bold("recursiv auth login")} to set your key.`);
+    log.info(`Run ${pc10.bold("recursiv auth login")} to set your key.`);
     process.exit(1);
   }
   return {
@@ -3672,14 +3802,14 @@ async function usersMeCommand(opts) {
   const res = await apiRequest(ctx, { method: "GET", path: "users/me" });
   output(res, opts.json, (data) => {
     log.blank();
-    console.log(pc10.bold("User"));
-    console.log(`  ${pc10.dim("id")}: ${data.id}`);
-    console.log(`  ${pc10.dim("name")}: ${data.name ?? "-"}`);
-    console.log(`  ${pc10.dim("username")}: ${data.username ?? "-"}`);
-    console.log(`  ${pc10.dim("email")}: ${data.email ?? "-"}`);
-    console.log(`  ${pc10.dim("followers")}: ${data.followers_count ?? 0}`);
-    console.log(`  ${pc10.dim("following")}: ${data.following_count ?? 0}`);
-    console.log(`  ${pc10.dim("posts")}: ${data.posts_count ?? 0}`);
+    console.log(pc11.bold("User"));
+    console.log(`  ${pc11.dim("id")}: ${data.id}`);
+    console.log(`  ${pc11.dim("name")}: ${data.name ?? "-"}`);
+    console.log(`  ${pc11.dim("username")}: ${data.username ?? "-"}`);
+    console.log(`  ${pc11.dim("email")}: ${data.email ?? "-"}`);
+    console.log(`  ${pc11.dim("followers")}: ${data.followers_count ?? 0}`);
+    console.log(`  ${pc11.dim("following")}: ${data.following_count ?? 0}`);
+    console.log(`  ${pc11.dim("posts")}: ${data.posts_count ?? 0}`);
     log.blank();
   });
 }
@@ -3695,13 +3825,13 @@ async function communitiesListCommand(opts) {
   });
   output(res, opts.json, (data, meta) => {
     log.blank();
-    console.log(pc10.bold("Communities"));
+    console.log(pc11.bold("Communities"));
     data.forEach((comm) => {
-      const name = pc10.bold(comm.name);
-      const slug = comm.slug ? pc10.dim(`/${comm.slug}`) : "";
-      const members = pc10.dim(`members ${comm.member_count ?? 0}`);
+      const name = pc11.bold(comm.name);
+      const slug = comm.slug ? pc11.dim(`/${comm.slug}`) : "";
+      const members = pc11.dim(`members ${comm.member_count ?? 0}`);
       console.log(`  ${name} ${slug} ${members}`);
-      if (comm.description) console.log(`    ${pc10.dim(comm.description)}`);
+      if (comm.description) console.log(`    ${pc11.dim(comm.description)}`);
     });
     printMeta(meta);
   });
@@ -3723,7 +3853,7 @@ async function communitiesCreateCommand(opts) {
     }
   });
   output(res, opts.json, (data) => {
-    log.success(`Community created: ${pc10.bold(data.name)} (${data.id})`);
+    log.success(`Community created: ${pc11.bold(data.name)} (${data.id})`);
   });
 }
 async function postsListCommand(opts) {
@@ -3740,11 +3870,11 @@ async function postsListCommand(opts) {
   });
   output(res, opts.json, (data, meta) => {
     log.blank();
-    console.log(pc10.bold("Posts"));
+    console.log(pc11.bold("Posts"));
     data.forEach((post) => {
       const author = post.author?.username ? `@${post.author.username}` : "unknown";
       const content = truncate(post.content ?? "", 100);
-      console.log(`  ${pc10.bold(author)} ${pc10.dim(post.id)}`);
+      console.log(`  ${pc11.bold(author)} ${pc11.dim(post.id)}`);
       console.log(`    ${content}`);
     });
     printMeta(meta);
@@ -3770,7 +3900,7 @@ async function postsCreateCommand(opts) {
     }
   });
   output(res, opts.json, (data) => {
-    log.success(`Post created: ${pc10.dim(data.id)}`);
+    log.success(`Post created: ${pc11.dim(data.id)}`);
   });
 }
 async function projectsListCommand(opts) {
@@ -3786,11 +3916,11 @@ async function projectsListCommand(opts) {
   });
   output(res, opts.json, (data, meta) => {
     log.blank();
-    console.log(pc10.bold("Projects"));
+    console.log(pc11.bold("Projects"));
     data.forEach((proj) => {
-      const name = pc10.bold(proj.name);
-      const slug = proj.slug ? pc10.dim(`/${proj.slug}`) : "";
-      const org = proj.organization?.slug ? pc10.dim(`org ${proj.organization.slug}`) : "";
+      const name = pc11.bold(proj.name);
+      const slug = proj.slug ? pc11.dim(`/${proj.slug}`) : "";
+      const org = proj.organization?.slug ? pc11.dim(`org ${proj.organization.slug}`) : "";
       console.log(`  ${name} ${slug} ${org}`);
     });
     printMeta(meta);
@@ -3815,7 +3945,7 @@ async function projectsCreateCommand(opts) {
     }
   });
   output(res, opts.json, (data) => {
-    log.success(`Project created: ${pc10.bold(data.name)} (${data.id})`);
+    log.success(`Project created: ${pc11.bold(data.name)} (${data.id})`);
   });
 }
 async function agentsListCommand(opts) {
@@ -3830,11 +3960,11 @@ async function agentsListCommand(opts) {
   });
   output(res, opts.json, (data, meta) => {
     log.blank();
-    console.log(pc10.bold("Agents"));
+    console.log(pc11.bold("Agents"));
     data.forEach((agent) => {
-      const name = pc10.bold(agent.name);
-      const handle = agent.username ? pc10.dim(`@${agent.username}`) : "";
-      const model = agent.model ? pc10.dim(agent.model) : "";
+      const name = pc11.bold(agent.name);
+      const handle = agent.username ? pc11.dim(`@${agent.username}`) : "";
+      const model = agent.model ? pc11.dim(agent.model) : "";
       console.log(`  ${name} ${handle} ${model}`);
     });
     printMeta(meta);
@@ -3863,7 +3993,7 @@ async function agentsCreateCommand(opts) {
     }
   });
   output(res, opts.json, (data) => {
-    log.success(`Agent created: ${pc10.bold(data.name)} (${data.id})`);
+    log.success(`Agent created: ${pc11.bold(data.name)} (${data.id})`);
   });
 }
 function output(res, json, render2) {
@@ -3876,7 +4006,7 @@ function output(res, json, render2) {
 function printMeta(meta) {
   if (!meta) return;
   log.blank();
-  console.log(pc10.dim(`limit ${meta.limit ?? 0} offset ${meta.offset ?? 0} has_more ${meta.has_more ?? false}`));
+  console.log(pc11.dim(`limit ${meta.limit ?? 0} offset ${meta.offset ?? 0} has_more ${meta.has_more ?? false}`));
   log.blank();
 }
 function truncate(value, max) {
@@ -3891,7 +4021,7 @@ program.command("chat").description("Start the chat-first AI agent (default when
   try {
     await launchChatAgent({ model: opts.model, resume: opts.resume });
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3899,7 +4029,7 @@ program.command("create [name]").description("Create a new Recursiv application"
   try {
     await initCommand(name);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3907,7 +4037,7 @@ program.command("dev").description("Start the development server").option("-p, -
   try {
     await devCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3915,7 +4045,7 @@ program.command("deploy <target>").description("Generate deployment config (verc
   try {
     await deployCommand(target);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3924,7 +4054,7 @@ auth.command("login").description("Set or update your API key").action(async ()
   try {
     await loginCommand();
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3932,7 +4062,7 @@ auth.command("logout").description("Remove API key from .env").action(async () =
   try {
     await logoutCommand();
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3940,7 +4070,7 @@ auth.command("whoami").description("Show current authenticated user").action(asy
   try {
     await whoamiCommand();
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3948,7 +4078,7 @@ program.command("info").description("Display project information").action(async
   try {
     await infoCommand();
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3957,7 +4087,7 @@ browserUse.command("run").description("Run a Browser Use task with the official
   try {
     await browserUseRunCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3965,7 +4095,7 @@ browserUse.command("mcp-snippet").description("Print Browser Use MCP configurati
   try {
     await browserUseMcpSnippetCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3974,7 +4104,7 @@ users.command("me").description("Show current authenticated user").option("--jso
   try {
     await usersMeCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3983,7 +4113,7 @@ communities.command("list").description("List communities").option("--limit <lim
   try {
     await communitiesListCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -3991,7 +4121,7 @@ communities.command("create").description("Create a community").requiredOption("
   try {
     await communitiesCreateCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4000,7 +4130,7 @@ posts.command("list").description("List posts").option("--community-id <id>", "f
   try {
     await postsListCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4008,7 +4138,7 @@ posts.command("create").description("Create a post").requiredOption("--content <
   try {
     await postsCreateCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4022,7 +4152,7 @@ projects.command("list").description("List projects").option("--org <id>", "orga
       json: opts.json
     });
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4038,7 +4168,7 @@ projects.command("create").description("Create a project").requiredOption("--org
       json: opts.json
     });
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4047,7 +4177,7 @@ agents.command("list").description("List agents").option("--limit <limit>", "num
   try {
     await agentsListCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4067,7 +4197,7 @@ agents.command("create").description("Create an AI agent").requiredOption("--nam
       json: opts.json
     });
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4075,7 +4205,7 @@ program.command("brain").description("Launch the visual Recursiv brain TUI").opt
   try {
     await brainCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4083,7 +4213,16 @@ program.command("studio").description("Legacy alias for brain").option("--no-ani
   try {
     await studioCommand(opts);
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
+    process.exit(1);
+  }
+});
+program.command("quickstart").description("Set up Claude Code + GitHub CLI + Recursiv account in one shot (~3 min)").action(async () => {
+  try {
+    const { quickstartCommand: quickstartCommand2 } = await Promise.resolve().then(() => (init_quickstart(), quickstart_exports));
+    await quickstartCommand2();
+  } catch (err) {
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4093,7 +4232,7 @@ mcp.command("install <target>").description("Configure Recursiv MCP server for a
     const { mcpInstallCommand: mcpInstallCommand2 } = await Promise.resolve().then(() => (init_mcp_install(), mcp_install_exports));
     await mcpInstallCommand2({ target, apiKey: opts.apiKey, global: opts.global });
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4102,7 +4241,7 @@ mcp.command("verify").description("Verify that the Recursiv MCP server starts an
     const { mcpVerifyCommand: mcpVerifyCommand2 } = await Promise.resolve().then(() => (init_mcp_install(), mcp_install_exports));
     await mcpVerifyCommand2();
   } catch (err) {
-    console.error(err instanceof Error ? err.message : err);
+    printCliError(err);
     process.exit(1);
   }
 });
@@ -4111,7 +4250,7 @@ async function launchChatAgent(opts) {
   const { readConfig: readConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
   const { resolveRecursivKey: resolveRecursivKey2, resolveAnthropicKey: resolveAnthropicKey2, saveCredentials: saveCredentials2 } = await Promise.resolve().then(() => (init_credentials(), credentials_exports));
   const { getOrCreateApiKey: getOrCreateApiKey2 } = await Promise.resolve().then(() => (init_auth_flow(), auth_flow_exports));
-  const pc14 = (await import("picocolors")).default;
+  const pc16 = (await import("picocolors")).default;
   const prompts3 = (await import("prompts")).default;
   const cwd = process.cwd();
   const config = await readConfig2(cwd);
@@ -4119,16 +4258,16 @@ async function launchChatAgent(opts) {
   let recursivApiKey = await resolveRecursivKey2(cwd);
   if (!recursivApiKey) {
     console.log();
-    console.log(pc14.bold("  Welcome to Recursiv"));
-    console.log(pc14.dim("  Let's get you authenticated."));
+    console.log(pc16.bold("  Welcome to Recursiv"));
+    console.log(pc16.dim("  Let's get you authenticated."));
     console.log();
     recursivApiKey = await getOrCreateApiKey2(baseUrl);
     if (!recursivApiKey) {
-      console.error(pc14.red("  error") + " Authentication required to continue.");
+      console.error(pc16.red("  error") + " Authentication required to continue.");
       process.exit(1);
     }
     await saveCredentials2({ recursivApiKey });
-    console.log(pc14.dim("  Credentials saved to ~/.recursiv/credentials"));
+    console.log(pc16.dim("  Credentials saved to ~/.recursiv/credentials"));
     console.log();
   }
   const anthropicApiKey = await resolveAnthropicKey2() ?? void 0;
@@ -4161,7 +4300,7 @@ async function main() {
     try {
       await launchChatAgent();
     } catch (err) {
-      console.error(err instanceof Error ? err.message : err);
+      printCliError(err);
       process.exit(1);
     }
     return;