@animaapp/cli 0.4.1 → 0.5.0

package/README.md

@@ -1,11 +1,24 @@
 # @animaapp/cli
 
-Generate production-ready apps from prompts, URLs, or Figma designs — from the
-command line.
-
-Built for **agents**: any AI tool that can run a shell command can use it. No MCP
-server to configure, no plugins — just `npx`. (Under the hood every command talks
-to Anima over MCP; you don't have to set any of that up.)
+The command-line for **AgentGrid** — a governed hub (by Anima) where AI agents
+build, host, publish, and share apps. This CLI is how an agent *uses* AgentGrid
+from a shell.
+
+**What it does.** Connect as a scoped agent identity, then work with **artifacts**
+(playgrounds — each one a real git repo): create them from your own code or from a
+prompt/URL/Figma design, edit them over git, publish them to a live URL, and list
+your team's artifacts to resume recent work. Every command runs an AgentGrid MCP
+tool for you.
+
+**How it works.** Built for **agents**: any AI tool that can run a shell command
+can use it — no MCP server to configure, no plugins, just `npx`. Under the hood
+each command talks to AgentGrid over MCP (`api.agentgrid.io`), and your access is a
+**scoped, revocable, ~7-day identity** your human approved. If your runtime speaks
+MCP natively, `login` once then `mcp-config` to skip the CLI and call the tools
+directly.
+
+> Package name is `@animaapp/cli` (AgentGrid is by Anima); the API lives at
+> `api.agentgrid.io`.
 
 ```bash
 npx @animaapp/cli login
@@ -121,7 +134,7 @@ npx @animaapp/cli login --invite <url-or-code>         # redeem a pre-approved i
 | Option | Description | Default |
 |--------|-------------|---------|
 | `--invite <url-or-code>` | Redeem an invite link (`…/invite/<code>.md`) or bare code. The human already approved when minting the invite, so there is no verification step — one call and you're connected. The invite URL's origin is persisted as the `api-url`, so follow-up commands target the right server with no flags | — |
-| `--client-name <name>` | How the CLI appears on the consent screen | `Anima CLI` |
+| `--client-name <name>` | How the CLI appears on the consent screen | `AgentGrid CLI` |
 | `--no-open` | Don't try to open the verification page in a browser | — |
 | `--print-mcp-config` | One-shot: after this fresh login, also print the MCP server config. If you are already logged in, use `mcp-config` instead — this flag always starts a new login | off |
 
@@ -259,7 +272,7 @@ secret, and re-mint rather than store it.
 npx @animaapp/cli logout
 ```
 
-A full local reset: clears **all** stored credentials (Anima token, Figma
+A full local reset: clears **all** stored credentials (AgentGrid token, Figma
 token, agent metadata) **and the CLI config** (including an `api-url` persisted
 by `login --invite`) — the machine ends up pristine, as if the CLI was never
 used. This only forgets the token locally — to actually disable an agent,
@@ -280,7 +293,7 @@ npx @animaapp/cli config unset api-url
 ```
 
 The API URL resolves in this order: **`--api-url` flag → `ANIMA_API_URL` env →
-`config.json` → default (`https://public-api.animaapp.com`).**
+`config.json` → default (`https://api.agentgrid.io`).**
 
 ### `auth` — inspect or manage credentials
 
@@ -301,7 +314,7 @@ Available on the network commands (`login`, `create`, `codegen`, `publish`,
 |------|-------------|---------|
 | `--json` | Emit a single JSON object to stdout (for agents) | off (pretty in a TTY) |
 | `--verbose` | Stream progress to stderr in JSON mode¹ | off |
-| `--api-url <url>` | API base URL (point at local/staging)³ | `https://public-api.animaapp.com` |
+| `--api-url <url>` | API base URL (point at local/staging)³ | `https://api.agentgrid.io` |
 | `--log-file <path>` | Append a JSON debug log of each step to a file | off |
 | `--timeout <ms>` | Request timeout² | `600000` (10 min) |
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command12 } 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();
@@ -1525,8 +1602,8 @@ var logoutCommand = new Command8("logout").description("Clear all stored credent
 });
 
 // src/commands/unpublish.ts
-import { Command as Command9 } from "commander";
-var unpublishCommand = new Command9("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) => {
+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);
@@ -1561,8 +1638,8 @@ var unpublishCommand = new Command9("unpublish").description("Take a published p
 });
 
 // src/commands/update.ts
-import { Command as Command10 } from "commander";
-var updateCommand = new Command10("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) => {
+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);
@@ -1607,8 +1684,8 @@ var updateCommand = new Command10("update").description("Update a playground's m
 });
 
 // src/commands/config.ts
-import { Command as Command11 } from "commander";
-var configCommand = new Command11("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) => {
@@ -1674,11 +1751,11 @@ function assertUrl(value) {
 }
 
 // src/index.ts
-var program = new Command12().name("anima").description(
-  `Anima CLI \u2014 host, edit, and publish your work on Anima. Every playground is a
-real git repository; each command runs an Anima tool for you.
+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 Anima):
+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)
@@ -1702,6 +1779,7 @@ TIMING (important for AI agents):
 COMMANDS:
   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)
@@ -1713,7 +1791,7 @@ COMMANDS:
   auth           Inspect or manage credentials (status / figma token)
 
 EXAMPLES (headless flow):
-  npx @animaapp/cli login --invite https://public-api.animaapp.com/invite/<code>.md
+  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>
@@ -1726,6 +1804,7 @@ OUTPUT: JSON to stdout when piped (for AI tools), pretty text in terminals.
 ).version(version, "-v, --version");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
+program.addCommand(listCommand);
 program.addCommand(createCommand);
 program.addCommand(publishCommand);
 program.addCommand(unpublishCommand);