@animaapp/cli 0.4.0 → 0.5.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command10 } from "commander";
+import { Command as Command13 } from "commander";
 
 // src/commands/create.ts
 import { Command } from "commander";
@@ -271,7 +271,7 @@ function connectionError(err) {
   const message = err instanceof Error ? err.message : String(err);
   return new CliError(
     "CONNECTION_ERROR",
-    `Could not reach the Anima MCP endpoint: ${message}`,
+    `Could not reach the AgentGrid MCP endpoint: ${message}`,
     1
   );
 }
@@ -370,7 +370,7 @@ function printSessionResult(result) {
   printSuccess("Playground created successfully!");
   printKeyValue("Session ID", result.sessionId);
   if (result.playgroundUrl) {
-    printKeyValue("Playground", chalk.cyan.underline(result.playgroundUrl));
+    printKeyValue("Your playground", chalk.cyan.underline(result.playgroundUrl));
   }
   if (result.tokenUsage) {
     printKeyValue("Token usage", result.tokenUsage.toLocaleString());
@@ -514,13 +514,32 @@ function collectProjectSource(fromPath) {
   return { kind: "files", files, fileCount: paths.length };
 }
 
+// src/utils/playgroundUrl.ts
+var PLAYGROUND_BASE = "https://dev.animaapp.com/chat";
+function parsePlaygroundUrl(input) {
+  if (!input.includes("/")) {
+    return input;
+  }
+  try {
+    const url = new URL(input);
+    const parts = url.pathname.split("/").filter(Boolean);
+    const markerIndex = parts.findIndex((p) => p === "chat" || p === "artifacts");
+    if (markerIndex !== -1 && markerIndex + 1 < parts.length) {
+      return parts[markerIndex + 1];
+    }
+    return parts[parts.length - 1];
+  } catch {
+    return input;
+  }
+}
+
 // src/config/store.ts
 import fs3 from "fs";
 import path3 from "path";
 import os2 from "os";
 var CONFIG_DIR2 = path3.join(os2.homedir(), ".config", "anima");
 var CONFIG_FILE = path3.join(CONFIG_DIR2, "config.json");
-var DEFAULT_API_URL = "https://public-api.animaapp.com";
+var DEFAULT_API_URL = "https://api.agentgrid.io";
 var CONFIG_KEYS = {
   "api-url": "apiUrl"
 };
@@ -570,12 +589,11 @@ function resolveApiUrl(flagValue) {
 }
 
 // src/commands/create.ts
-var PLAYGROUND_BASE = "https://dev.animaapp.com/chat";
 var createCommand = new Command("create").description(
-  "Create a playground: AI-generated (p2c/l2c/f2c, 3-7 min), empty for code you'll push (instant), or import your existing code (instant)"
+  "Create a playground from your own code: empty for code you'll push (instant) or import your existing code (instant). Also supports AI generation: p2c/l2c/f2c (3-7 min)."
 ).requiredOption(
   "-t, --type <type>",
-  "p2c, l2c, f2c, empty (empty repo you push to), or import (create FROM your code \u2014 use --from)"
+  "empty (empty repo you push to), import (create FROM your code \u2014 use --from), or AI-generated: p2c, l2c, f2c"
 ).option("-p, --prompt <prompt>", "Text prompt (p2c)").option("-u, --url <url>", "Website URL (l2c)").option("--file-key <key>", "Figma file key or URL (f2c)").option("--nodes <nodes>", "Figma node IDs, comma-separated (f2c)").option("--figma-token <token>", "Figma personal access token (f2c)").option(
   "--framework <fw>",
   "html | react \u2014 the only supported frameworks. REQUIRED for empty (declare react if you will push React code); detected from package.json for import"
@@ -690,8 +708,8 @@ ${result.nextSteps}` : message, result);
   }
 });
 function validateCreateOptions(type, opts) {
-  if (!["p2c", "l2c", "f2c", "empty", "import"].includes(type)) {
-    throw validationError(`Invalid type "${type}". Must be p2c, l2c, f2c, empty, or import.`);
+  if (!["empty", "import", "p2c", "l2c", "f2c"].includes(type)) {
+    throw validationError(`Invalid type "${type}". Must be empty, import, p2c, l2c, or f2c.`);
   }
   if (type === "p2c" && !opts.prompt) {
     throw validationError("--prompt is required for p2c type");
@@ -764,9 +782,86 @@ function buildCreateArgs(type, opts) {
   return args;
 }
 
-// src/commands/publish.ts
+// src/commands/list.ts
 import { Command as Command2 } from "commander";
-var publishCommand = new Command2("publish").description("Deploy playground to live URL or npm package (1-3 min)").argument("<sessionId>", "Session ID from create command").option("--mode <mode>", "webapp | designSystem", "webapp").option("--package-name <name>", "NPM package name (designSystem mode)").option("--package-version <version>", "NPM package version (designSystem mode)").option("--json", "Output as JSON").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (sessionId, opts) => {
+import chalk3 from "chalk";
+var listCommand = new Command2("list").aliases(["ls", "artifacts"]).description(
+  "List your team's artifacts (most-recently-updated first) so you can resume existing work."
+).option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (opts) => {
+  const mode = detectOutputMode(opts);
+  initLogger(opts.logFile);
+  try {
+    const auth = resolveAuth();
+    const result = await withMcp(
+      { apiBaseUrl: resolveApiUrl(opts.apiUrl), token: auth.token, teamId: auth.teamId },
+      (client) => client.callTool("workspace-list_artifacts", {})
+    );
+    if (!result.success) {
+      const message = result.reason || result.error || "Could not list artifacts";
+      throw apiError(message, result);
+    }
+    const artifacts = result.artifacts ?? [];
+    logEvent("artifacts_listed", { count: artifacts.length, truncated: result.truncated ?? false });
+    if (mode === "pretty") {
+      if (artifacts.length === 0) {
+        console.log();
+        console.log(
+          "  No artifacts yet \u2014 create one with `create -t empty` or `create -t import`."
+        );
+        console.log();
+      } else {
+        console.log();
+        for (const a of artifacts) {
+          console.log(`  ${chalk3.bold(a.name)} ${chalk3.gray(`(${a.type})`)}`);
+          if (a.sessionId) {
+            console.log(`    ${chalk3.gray("session:")} ${a.sessionId}`);
+          }
+          console.log(`    ${chalk3.gray("updated:")} ${formatUpdatedAt(a.updatedAt)}`);
+          if (a.sessionId) {
+            console.log(
+              `    ${chalk3.cyan.underline(`${PLAYGROUND_BASE}/${a.sessionId}`)}`
+            );
+          }
+          console.log();
+        }
+        if (result.truncated) {
+          console.log(
+            chalk3.yellow("  The list was capped \u2014 some artifacts are not shown.")
+          );
+          console.log();
+        }
+      }
+    } else {
+      outputResult(mode, {
+        success: true,
+        workspaceId: result.workspaceId,
+        artifacts,
+        truncated: result.truncated ?? false
+      });
+    }
+  } catch (err) {
+    if (err instanceof CliError) {
+      if (mode === "pretty") {
+        console.error(err.message);
+      } else {
+        outputError(mode, { code: err.code, message: err.message });
+      }
+      process.exit(err.exitCode);
+    }
+    throw err;
+  }
+});
+function formatUpdatedAt(iso) {
+  const then = new Date(iso).getTime();
+  if (Number.isNaN(then)) return iso;
+  const seconds = Math.max(0, Math.round((Date.now() - then) / 1e3));
+  const relative2 = seconds < 60 ? "just now" : seconds < 3600 ? `${Math.floor(seconds / 60)}m ago` : seconds < 86400 ? `${Math.floor(seconds / 3600)}h ago` : `${Math.floor(seconds / 86400)}d ago`;
+  return `${relative2} (${iso})`;
+}
+
+// src/commands/publish.ts
+import { Command as Command3 } from "commander";
+var publishCommand = new Command3("publish").description("Deploy playground to live URL or npm package (1-3 min)").argument("<sessionId>", "Session ID from create command").option("--mode <mode>", "webapp | designSystem", "webapp").option("--package-name <name>", "NPM package name (designSystem mode)").option("--package-version <version>", "NPM package version (designSystem mode)").option("--json", "Output as JSON").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (sessionId, opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   const progress = new ProgressReporter(mode, opts.verbose);
@@ -836,7 +931,7 @@ var publishCommand = new Command2("publish").description("Deploy playground to l
 });
 
 // src/commands/codegen.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/utils/files.ts
 import fs4 from "fs";
@@ -864,7 +959,7 @@ function writeFilesToDisk(files, outputDir) {
 }
 
 // src/commands/codegen.ts
-var codegenCommand = new Command3("codegen").description("Convert Figma design to code files (no playground)").requiredOption("--file-key <key>", "Figma file key or URL").option("--nodes <nodes>", "Figma node IDs, comma-separated").option("--figma-token <token>", "Figma personal access token (or set FIGMA_TOKEN env var)").option("-o, --output <dir>", "Output directory", "./generated").option("--framework <fw>", "react | html", "react").option("--styling <style>", "tailwind | plain_css", "tailwind").option("--language <lang>", "typescript | javascript").option("--ui-library <lib>", "mui | antd | shadcn | clean_react").option("--json", "Output as JSON").option("--timeout <ms>", "Timeout in milliseconds", "600000").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (opts) => {
+var codegenCommand = new Command4("codegen").description("Convert Figma design to code files (no playground)").requiredOption("--file-key <key>", "Figma file key or URL").option("--nodes <nodes>", "Figma node IDs, comma-separated").option("--figma-token <token>", "Figma personal access token (or set FIGMA_TOKEN env var)").option("-o, --output <dir>", "Output directory", "./generated").option("--framework <fw>", "react | html", "react").option("--styling <style>", "tailwind | plain_css", "tailwind").option("--language <lang>", "typescript | javascript").option("--ui-library <lib>", "mui | antd | shadcn | clean_react").option("--json", "Output as JSON").option("--timeout <ms>", "Timeout in milliseconds", "600000").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   const progress = new ProgressReporter(mode, opts.verbose);
@@ -936,26 +1031,8 @@ var codegenCommand = new Command3("codegen").description("Convert Figma design t
 });
 
 // src/commands/getGitToken.ts
-import { Command as Command4 } from "commander";
-import chalk3 from "chalk";
-
-// src/utils/playgroundUrl.ts
-function parsePlaygroundUrl(input) {
-  if (!input.includes("/")) {
-    return input;
-  }
-  try {
-    const url = new URL(input);
-    const parts = url.pathname.split("/").filter(Boolean);
-    const chatIndex = parts.indexOf("chat");
-    if (chatIndex !== -1 && chatIndex + 1 < parts.length) {
-      return parts[chatIndex + 1];
-    }
-    return parts[parts.length - 1];
-  } catch {
-    return input;
-  }
-}
+import { Command as Command5 } from "commander";
+import chalk4 from "chalk";
 
 // src/utils/gitToken.ts
 function preview(payload) {
@@ -989,7 +1066,7 @@ function parseGitTokenResponse(payload) {
 }
 
 // src/commands/getGitToken.ts
-var getGitTokenCommand = new Command4("get-git-token").description("Mint a short-lived git remote URL for a playground (clone/push with git)").argument("<playgroundUrl>", "Playground URL or session ID").option("--json", "Output as JSON").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (playgroundUrl, opts) => {
+var getGitTokenCommand = new Command5("get-git-token").description("Mint a short-lived git remote URL for a playground (clone/push with git)").argument("<playgroundUrl>", "Playground URL or session ID").option("--json", "Output as JSON").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (playgroundUrl, opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   const progress = new ProgressReporter(mode, opts.verbose);
@@ -1006,7 +1083,7 @@ var getGitTokenCommand = new Command4("get-git-token").description("Mint a short
     progress.succeed(`Git access granted (${grant.access === "rw" ? "read-write" : "read-only"})`);
     if (mode === "pretty") {
       console.log();
-      console.log(`  ${chalk3.cyan(`git clone ${grant.gitRemoteUrl}`)}`);
+      console.log(`  ${chalk4.cyan(`git clone ${grant.gitRemoteUrl}`)}`);
       console.log();
       if (grant.access === "rw") {
         console.log("  Commit and push to update the live playground.");
@@ -1016,7 +1093,7 @@ var getGitTokenCommand = new Command4("get-git-token").description("Mint a short
       if (grant.expiresAt) {
         console.log(
           `  The URL embeds a token that expires at ${grant.expiresAt} and cannot be renewed;
-  re-run this command and ${chalk3.cyan("git remote set-url origin <new url>")} to keep pushing.`
+  re-run this command and ${chalk4.cyan("git remote set-url origin <new url>")} to keep pushing.`
         );
       }
       console.log("  Treat the URL as a secret \u2014 it grants access to this playground.");
@@ -1045,16 +1122,16 @@ var getGitTokenCommand = new Command4("get-git-token").description("Mint a short
 });
 
 // src/commands/mcpConfig.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/commands/login.ts
-import { Command as Command5 } from "commander";
-import chalk4 from "chalk";
+import { Command as Command6 } from "commander";
+import chalk5 from "chalk";
 import open from "open";
 
 // src/auth/device.ts
 var DEVICE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
-var DEFAULT_CLIENT_NAME = "Anima CLI";
+var DEFAULT_CLIENT_NAME = "AgentGrid CLI";
 var defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function decodeJwtPayload(token) {
   try {
@@ -1219,7 +1296,7 @@ async function loginWithInvite(options) {
 }
 
 // src/commands/login.ts
-var loginCommand = new Command5("login").description("Log in via the device flow, or redeem a pre-approved invite with --invite").option("--invite <url-or-code>", "Redeem an invite link (\u2026/invite/<code>.md) or bare code \u2014 no approval step").option("--client-name <name>", "How this CLI appears on the consent screen", "Anima CLI").option("--no-open", "Do not try to open the verification page in a browser").option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").option(
+var loginCommand = new Command6("login").description("Log in via the device flow, or redeem a pre-approved invite with --invite").option("--invite <url-or-code>", "Redeem an invite link (\u2026/invite/<code>.md) or bare code \u2014 no approval step").option("--client-name <name>", "How this CLI appears on the consent screen", "AgentGrid CLI").option("--no-open", "Do not try to open the verification page in a browser").option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").option(
   "--print-mcp-config",
   "After login, also print an MCP server config (includes the token) to paste into an MCP-capable agent"
 ).action(async (opts) => {
@@ -1282,9 +1359,9 @@ var loginCommand = new Command5("login").description("Log in via the device flow
           console.log();
           printInfo("To connect, open the verification page and enter this code:");
           console.log();
-          console.log(`    ${chalk4.cyan.underline(info.verificationUri)}`);
+          console.log(`    ${chalk5.cyan.underline(info.verificationUri)}`);
           console.log();
-          console.log(`    ${chalk4.bold.white(info.userCode)}`);
+          console.log(`    ${chalk5.bold.white(info.userCode)}`);
           console.log();
           printInfo(`Waiting for approval\u2026 (code expires in ${Math.round(info.expiresInSeconds / 60)} minutes)`);
         } else {
@@ -1354,7 +1431,7 @@ function buildMcpConfig(apiUrl, token) {
 }
 
 // src/commands/mcpConfig.ts
-var mcpConfigCommand = new Command6("mcp-config").description("Print an MCP server config from your stored credentials (run `login` first)").option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").action(async (opts) => {
+var mcpConfigCommand = new Command7("mcp-config").description("Print an MCP server config from your stored credentials (run `login` first)").option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").action(async (opts) => {
   const mode = detectOutputMode(opts);
   try {
     const auth = resolveAuth();
@@ -1391,10 +1468,10 @@ var mcpConfigCommand = new Command6("mcp-config").description("Print an MCP serv
 });
 
 // src/commands/auth.ts
-import { Command as Command7 } from "commander";
-import chalk5 from "chalk";
-var DEFAULT_API_URL2 = "https://public-api.animaapp.com";
-var authCommand = new Command7("auth").description("Manage authentication").option("--token <token>", "Store Anima API token").option("--figma-token <token>", "Store Figma personal access token").option("--team-id <teamId>", "Team ID to associate with token").option("--status", "Show current auth status").option("--logout", "Clear stored credentials (alias for `anima logout`)").option("--json", "Output as JSON").option("--api-url <url>", "API base URL", DEFAULT_API_URL2).action(async (opts) => {
+import { Command as Command8 } from "commander";
+import chalk6 from "chalk";
+var DEFAULT_API_URL2 = "https://api.agentgrid.io";
+var authCommand = new Command8("auth").description("Manage authentication").option("--token <token>", "Store AgentGrid API token").option("--figma-token <token>", "Store Figma personal access token").option("--team-id <teamId>", "Team ID to associate with token").option("--status", "Show current auth status").option("--logout", "Clear stored credentials (alias for `anima logout`)").option("--json", "Output as JSON").option("--api-url <url>", "API base URL", DEFAULT_API_URL2).action(async (opts) => {
   const mode = detectOutputMode(opts);
   try {
     if (opts.token || opts.figmaToken) {
@@ -1410,7 +1487,7 @@ var authCommand = new Command7("auth").description("Manage authentication").opti
       if (mode === "pretty") {
         printSuccess("Credentials saved to " + getCredentialsPath());
         if (opts.token) {
-          printKeyValue("Anima token", "saved");
+          printKeyValue("AgentGrid token", "saved");
           if (toSave.teamId) printKeyValue("Team ID", toSave.teamId);
         }
         if (opts.figmaToken) {
@@ -1449,7 +1526,7 @@ var authCommand = new Command7("auth").description("Manage authentication").opti
         if (mode === "pretty") {
           printSuccess("Token configured");
           printKeyValue("Source", sourceName);
-          printKeyValue("Anima token", auth.token.slice(0, 12) + "..." + auth.token.slice(-4));
+          printKeyValue("AgentGrid token", auth.token.slice(0, 12) + "..." + auth.token.slice(-4));
           printKeyValue("Token type", auth.tokenType === "agent" ? "agent (scoped, revocable)" : "personal/API");
           if (creds?.tokenType === "agent" && creds.expiresAt) printKeyValue("Expires", creds.expiresAt);
           if (auth.teamId) printKeyValue("Team ID", auth.teamId);
@@ -1481,12 +1558,12 @@ var authCommand = new Command7("auth").description("Manage authentication").opti
     if (mode === "pretty") {
       console.log();
       printInfo("Auth commands:");
-      console.log(`  ${chalk5.cyan("anima login")}                    Log in (device flow \u2014 approve on any browser)`);
-      console.log(`  ${chalk5.cyan("anima logout")}                   Clear all credentials`);
-      console.log(`  ${chalk5.cyan("anima auth --status")}            Check auth status`);
-      console.log(`  ${chalk5.cyan("anima auth --figma-token <T>")}   Save Figma token (needed for codegen/f2c)`);
+      console.log(`  ${chalk6.cyan("anima login")}                    Log in (device flow \u2014 approve on any browser)`);
+      console.log(`  ${chalk6.cyan("anima logout")}                   Clear all credentials`);
+      console.log(`  ${chalk6.cyan("anima auth --status")}            Check auth status`);
+      console.log(`  ${chalk6.cyan("anima auth --figma-token <T>")}   Save Figma token (needed for codegen/f2c)`);
       console.log();
-      console.log(`  Figma token: ${chalk5.cyan.underline("https://www.figma.com")} > Settings > Personal access tokens`);
+      console.log(`  Figma token: ${chalk6.cyan.underline("https://www.figma.com")} > Settings > Personal access tokens`);
       console.log();
     } else {
       outputResult(mode, {
@@ -1508,8 +1585,8 @@ var authCommand = new Command7("auth").description("Manage authentication").opti
 });
 
 // src/commands/logout.ts
-import { Command as Command8 } from "commander";
-var logoutCommand = new Command8("logout").description("Clear all stored credentials (Anima + Figma tokens) from this machine").option("--json", "Output as JSON").action((opts) => {
+import { Command as Command9 } from "commander";
+var logoutCommand = new Command9("logout").description("Clear all stored credentials (AgentGrid + Figma tokens) from this machine").option("--json", "Output as JSON").action((opts) => {
   const mode = detectOutputMode(opts);
   const hadCredentials = clearStorage();
   deleteConfig();
@@ -1524,9 +1601,91 @@ var logoutCommand = new Command8("logout").description("Clear all stored credent
   }
 });
 
+// src/commands/unpublish.ts
+import { Command as Command10 } from "commander";
+var unpublishCommand = new Command10("unpublish").description("Take a published playground offline (clears its live URL; code and playground stay intact)").argument("<sessionId>", "Session ID of the published playground").option("--json", "Output as JSON").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (sessionId, opts) => {
+  const mode = detectOutputMode(opts);
+  initLogger(opts.logFile);
+  const progress = new ProgressReporter(mode, opts.verbose);
+  try {
+    const auth = resolveAuth();
+    progress.start("Unpublishing...");
+    const result = await withMcp(
+      { apiBaseUrl: resolveApiUrl(opts.apiUrl), token: auth.token, teamId: auth.teamId },
+      (client) => client.callTool("playground-unpublish", { sessionId })
+    );
+    if (!result.success) {
+      throw apiError(result.reason || result.error || "Unpublish failed", result);
+    }
+    progress.succeed("Unpublished");
+    if (mode === "pretty") {
+      printSuccess(result.message || `Playground ${sessionId} is no longer publicly reachable.`);
+    } else {
+      outputResult(mode, { success: true, sessionId, ...result.message ? { message: result.message } : {} });
+    }
+  } catch (err) {
+    progress.fail("Failed");
+    if (err instanceof CliError) {
+      if (mode === "pretty") {
+        printError(err.message);
+      } else {
+        outputError(mode, { code: err.code, message: err.message });
+      }
+      process.exit(err.exitCode);
+    }
+    throw err;
+  }
+});
+
+// src/commands/update.ts
+import { Command as Command11 } from "commander";
+var updateCommand = new Command11("update").description("Update a playground's metadata: display name and/or visibility (never touches code)").argument("<sessionId>", "Session ID of the playground").option("--name <name>", "New display name").option("--privacy <privacy>", "public (anyone with the link) | private (team only)").option("--json", "Output as JSON").option("--verbose", "Show progress on stderr").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").option("--log-file <path>", "Append a JSON debug log of each step to this file").action(async (sessionId, opts) => {
+  const mode = detectOutputMode(opts);
+  initLogger(opts.logFile);
+  const progress = new ProgressReporter(mode, opts.verbose);
+  try {
+    if (!opts.name && !opts.privacy) {
+      throw validationError("Nothing to update \u2014 pass --name and/or --privacy");
+    }
+    if (opts.privacy && !["public", "private"].includes(opts.privacy)) {
+      throw validationError(`Invalid privacy "${opts.privacy}". Must be public or private.`);
+    }
+    const auth = resolveAuth();
+    progress.start("Updating...");
+    const result = await withMcp(
+      { apiBaseUrl: resolveApiUrl(opts.apiUrl), token: auth.token, teamId: auth.teamId },
+      (client) => client.callTool("playground-metadata-update", {
+        sessionId,
+        ...opts.name ? { name: opts.name } : {},
+        ...opts.privacy ? { privacy: opts.privacy } : {}
+      })
+    );
+    if (!result.success) {
+      throw apiError(result.reason || result.error || "Update failed", result);
+    }
+    progress.succeed("Updated");
+    if (mode === "pretty") {
+      printSuccess(result.message || `Playground ${sessionId} updated.`);
+    } else {
+      outputResult(mode, { success: true, sessionId, ...result.message ? { message: result.message } : {} });
+    }
+  } catch (err) {
+    progress.fail("Failed");
+    if (err instanceof CliError) {
+      if (mode === "pretty") {
+        printError(err.message);
+      } else {
+        outputError(mode, { code: err.code, message: err.message });
+      }
+      process.exit(err.exitCode);
+    }
+    throw err;
+  }
+});
+
 // src/commands/config.ts
-import { Command as Command9 } from "commander";
-var configCommand = new Command9("config").description(
+import { Command as Command12 } from "commander";
+var configCommand = new Command12("config").description(
   `Store CLI preferences (keys: ${configKeys().join(", ")})`
 );
 configCommand.command("set <key> <value>").description("Set a config value").option("--json", "Output as JSON").action((key, value, opts) => {
@@ -1592,48 +1751,64 @@ function assertUrl(value) {
 }
 
 // src/index.ts
-var program = new Command10().name("anima").description(
-  `Anima CLI - Generate production-ready apps from prompts, URLs, or Figma designs.
+var program = new Command13().name("anima").description(
+  `AgentGrid CLI \u2014 host, edit, and publish your work on AgentGrid. Every playground is a
+real git repository; each command runs an AgentGrid tool for you.
+
+THE MAIN FLOW (build something and put it on AgentGrid):
+  1. npx @animaapp/cli login                                   # once; a human approves
+  2. npx @animaapp/cli create -t import --from ./my-project    # your code \u2192 a live playground
+     (or: create -t empty --framework html \u2014 an empty repo you push to)
+  3. The response includes a rw gitRemoteUrl \u2014 git clone, edit, commit, push:
+     every push updates the live playground.
+  4. Share the playgroundUrl with your human. That IS sharing \u2014 the playground
+     is visible at its URL. Do NOT run publish unless the human explicitly
+     asked for a public site; offer it as a follow-up question instead.
 
 AUTHENTICATION:
-  Run: npx @animaapp/cli login
-  Approve in a browser on any device \u2014 the CLI receives a scoped agent token
-  (stored in ~/.config/anima/). CI/automation can set ANIMA_API_TOKEN instead.
+  npx @animaapp/cli login            # device flow \u2014 a human approves on any device
+  npx @animaapp/cli login --invite <url>   # redeem a pre-approved invite link (no approval step)
+  Credentials live in ~/.config/anima/; logout removes everything.
 
 TIMING (important for AI agents):
-  create        \u2192 3-7 minutes (keep the default 600000ms timeout)
-  publish       \u2192 1-3 minutes
-  codegen       \u2192 2-5 minutes
-  get-git-token \u2192 seconds
-  The --timeout default is 600000ms (10 min). Do NOT reduce it.
+  create -t empty|import \u2192 seconds
+  create -t p2c|l2c|f2c  \u2192 3-7 minutes AI generation (keep the default 600000ms timeout)
+  publish/unpublish      \u2192 1-3 minutes
+  get-git-token / update \u2192 seconds
 
 COMMANDS:
-  login          Log in via the device flow (no browser needed on this machine)
-  logout         Clear all stored credentials from this machine
+  login          Connect (device flow, or --invite to redeem an invite link)
+  logout         Full local reset \u2014 clears credentials and CLI config
+  list           List your team's artifacts (most-recently-updated first) to resume work
+  create         Make a playground: import your code, empty repo, or AI-generated (p2c/l2c/f2c)
+  get-git-token  Fresh git access to an existing playground (or after token expiry)
+  update         Rename a playground or set visibility public/private (metadata only)
+  publish        Deploy to a public live URL \u2014 ONLY when the human asked for it
+  unpublish      Take a published playground offline (inverse of publish)
   mcp-config     Print an MCP server config from stored credentials (no new login)
-  create         Create app from prompt, URL, or Figma design
-  publish        Deploy playground to live URL or npm package
-  codegen        Convert Figma design to code files (no playground)
-  get-git-token  Mint a git remote URL for a playground; clone/edit/push with git
+  codegen        Convert Figma design to local code files (no playground)
   config         Store CLI preferences (e.g. a default API URL)
   auth           Inspect or manage credentials (status / figma token)
 
-EXAMPLES:
-  npx @animaapp/cli login
-  npx @animaapp/cli create -t p2c -p "SaaS dashboard with sidebar and analytics"
-  npx @animaapp/cli create -t l2c -u https://stripe.com
-  npx @animaapp/cli create -t f2c --file-key abc --nodes 42:15
-  npx @animaapp/cli publish abc123xyz
-  npx @animaapp/cli codegen --file-key abc --nodes 42:15 -o ./components
-  npx @animaapp/cli get-git-token https://dev.animaapp.com/chat/abc123xyz
+EXAMPLES (headless flow):
+  npx @animaapp/cli login --invite https://api.agentgrid.io/invite/<code>.md
+  npx @animaapp/cli create -t import --from ./my-project
+  npx @animaapp/cli create -t empty --framework react --name "My app"
+  npx @animaapp/cli get-git-token <sessionId>
+  npx @animaapp/cli update <sessionId> --privacy public
+  npx @animaapp/cli publish <sessionId>        # only on explicit request
+  npx @animaapp/cli unpublish <sessionId>
 
 OUTPUT: JSON to stdout when piped (for AI tools), pretty text in terminals.
   Progress is streamed to stderr via --verbose when in JSON mode.`
 ).version(version, "-v, --version");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
+program.addCommand(listCommand);
 program.addCommand(createCommand);
 program.addCommand(publishCommand);
+program.addCommand(unpublishCommand);
+program.addCommand(updateCommand);
 program.addCommand(codegenCommand);
 program.addCommand(getGitTokenCommand);
 program.addCommand(mcpConfigCommand);