@animaapp/cli 0.8.0 → 0.9.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command21 } from "commander";
+import { Command as Command23 } from "commander";
 
 // src/commands/create.ts
 import { Command } from "commander";
@@ -176,7 +176,19 @@ function validationError(message, detail) {
   );
 }
 function apiError(message, detail) {
-  return new CliError("API_ERROR", message, EXIT_CODES.API_ERROR, detail);
+  const text = message.replace(/^Error: /, "");
+  return new CliError("API_ERROR", withWorkspaceHint(text), EXIT_CODES.API_ERROR, detail);
+}
+function withWorkspaceHint(message) {
+  if (/\bworkspaceId\b/.test(message)) {
+    return `${message}
+Pass it with --workspace <id>; \`anima workspaces\` lists the ids.`;
+  }
+  if (message === "Workspace not found") {
+    return `${message}
+\`anima workspaces\` lists the workspaces you can reach, with their ids.`;
+  }
+  return message;
 }
 function timeoutError() {
   return new CliError(
@@ -423,9 +435,16 @@ import { CallToolResultSchema, ErrorCode } from "@modelcontextprotocol/sdk/types
 import { createRequire } from "module";
 var { version } = createRequire(import.meta.url)("../package.json");
 
+// src/clientIdentity.ts
+var ANIMA_CLIENT_IDENTITY = {
+  type: "cli",
+  name: "anima-cli",
+  version
+};
+
 // src/api/mcp.ts
 var MCP_PATH = "/v1/mcp";
-var CLIENT_INFO = { name: "anima-cli", version };
+var CLIENT_INFO = { name: ANIMA_CLIENT_IDENTITY.name, version: ANIMA_CLIENT_IDENTITY.version };
 var DEFAULT_TIMEOUT_MS = 6e5;
 var AnimaMcpClient = class {
   #client;
@@ -433,7 +452,10 @@ var AnimaMcpClient = class {
   #url;
   constructor(config) {
     const headers = {
-      Authorization: `Bearer ${config.token}`
+      Authorization: `Bearer ${config.token}`,
+      "X-Anima-Client-Type": ANIMA_CLIENT_IDENTITY.type,
+      "X-Anima-Client-Name": ANIMA_CLIENT_IDENTITY.name,
+      "X-Anima-Client-Version": ANIMA_CLIENT_IDENTITY.version
     };
     if (config.teamId) headers["X-Team-Id"] = config.teamId;
     if (config.figmaToken) headers["X-Figma-Token"] = config.figmaToken;
@@ -475,6 +497,11 @@ var AnimaMcpClient = class {
       if (err?.code === ErrorCode.RequestTimeout) {
         throw timeoutError();
       }
+      if (err?.code === ErrorCode.InvalidParams && /\bnot found\b/.test(err.message)) {
+        throw apiError(
+          `${name} is not available to this credential. An agent is offered it only once a human has granted it the access it needs in a workspace of this team (read to list, write to create).`
+        );
+      }
       throw err;
     }
     logEvent("mcp_tool_result", { tool: name, isError: result.isError ?? false });
@@ -827,6 +854,7 @@ async function createAnonymousArtifact(request, fetchFn = fetch) {
   const url = `${request.apiUrl.replace(/\/$/, "")}/v1/generationSessions`;
   const body = {
     type: "import",
+    clientType: ANIMA_CLIENT_IDENTITY.type,
     ...request.files ? { files: request.files } : {},
     ...request.zipUploadId ? { zipUploadId: request.zipUploadId } : {},
     ...request.framework ? { framework: request.framework } : {},
@@ -867,6 +895,14 @@ async function getAnonymousZipUploadUrl(apiUrl, fetchFn = fetch) {
   return { zipUploadId: payload.zipUploadId, uploadUrl: payload.uploadUrl };
 }
 
+// src/utils/workspaceFlag.ts
+function workspaceFlag(value) {
+  if (value !== void 0 && value.trim() === "") {
+    throw validationError("--workspace needs a workspace id; `anima workspaces` lists them");
+  }
+  return value;
+}
+
 // src/commands/create.ts
 var createCommand = new Command("create").summary("Create an artifact: your code, an empty repo, or AI generation").description(
   "Create an artifact 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)."
@@ -879,7 +915,10 @@ var createCommand = new Command("create").summary("Create an artifact: your code
 ).option("--styling <style>", "tailwind | css | plain_css | css_modules | inline_styles", "tailwind").option("--language <lang>", "typescript | javascript").option("--ui-library <lib>", "mui | antd | shadcn | clean_react").option("--guidelines <text>", "Additional constraints (p2c only)").option(
   "--artifact-type <kind>",
   "app | markdown \u2014 what the artifact IS. app (default) needs an index.html; markdown needs .md files"
-).option("--name <name>", "Project name (empty/import only)").option("--from <path>", "Folder or .zip with your project (import only) \u2014 becomes the first commit").option(
+).option("--name <name>", "Project name (empty/import only)").option(
+  "-w, --workspace <id>",
+  "The workspace to create it in (id from `anima workspaces`). Optional when you can create in only one workspace; otherwise required, since there is no default"
+).option("--from <path>", "Folder or .zip with your project (import only) \u2014 becomes the first commit").option(
   "--anonymous",
   "Create without an account (import only). Returns a claim link to send a human, and a handoff token to log in with once they claim it"
 ).option(
@@ -946,7 +985,7 @@ ${grant.nextSteps}` : message, grant);
       return { created, status: status2 };
     }).then(({ created, status: status2 }) => ({ result: created, settled: status2 }));
     if (!result.success || !result.sessionId) {
-      const message = result.reason || result.error || "Generation failed";
+      const message = result.message || result.reason || result.error || "Generation failed";
       throw apiError(result.nextSteps ? `${message}
 ${result.nextSteps}` : message, result);
     }
@@ -1152,6 +1191,12 @@ Log in first for the other types: anima login`
   if (type !== "import" && opts.from) {
     throw validationError("--from is only valid with -t import");
   }
+  workspaceFlag(opts.workspace);
+  if (opts.workspace !== void 0 && opts.anonymous) {
+    throw validationError(
+      "--workspace does not apply to --anonymous creates \u2014 they belong to no team until a human claims them"
+    );
+  }
 }
 function resolveFigmaToken(opts, stored) {
   const figmaToken = opts.figmaToken || process.env.FIGMA_TOKEN || stored;
@@ -1170,7 +1215,8 @@ function buildCreateArgs(type, opts) {
       // import is what made markdown artifacts render as empty apps.
       ...opts.framework && opts.artifactType !== "markdown" ? { framework: opts.framework } : {},
       ...opts.artifactType ? { artifactType: opts.artifactType } : {},
-      ...opts.name ? { name: opts.name } : {}
+      ...opts.name ? { name: opts.name } : {},
+      ...opts.workspace !== void 0 ? { workspaceId: opts.workspace } : {}
     };
   }
   const framework = opts.framework ?? "html";
@@ -1185,6 +1231,7 @@ function buildCreateArgs(type, opts) {
   };
   if (language) args.language = language;
   if (opts.uiLibrary) args.uiLibrary = opts.uiLibrary;
+  if (opts.workspace !== void 0) args.workspaceId = opts.workspace;
   switch (type) {
     case "p2c":
       args.prompt = opts.prompt;
@@ -1209,22 +1256,107 @@ function buildCreateArgs(type, opts) {
   return args;
 }
 
-// src/commands/list.ts
+// src/commands/createKnowledge.ts
 import { Command as Command2 } from "commander";
+
+// src/commands/runner.ts
+async function withCommandErrors(mode, fn) {
+  try {
+    await fn();
+  } catch (err) {
+    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/createKnowledge.ts
+function buildCreateKnowledgeArgs(name, workspaceId) {
+  if (name !== void 0 && name.length > 120) {
+    throw validationError("--name must be at most 120 characters");
+  }
+  return {
+    ...name === void 0 ? {} : { name },
+    ...workspaceFlag(workspaceId) === void 0 ? {} : { workspaceId }
+  };
+}
+function makeCreateKnowledgeCommand() {
+  return new Command2("create-knowledge").summary("Create a knowledge artifact from Anima's template").description(
+    "Create a ready knowledge artifact from Anima's server-provided template. The template supplies the files and framework; only an optional display name is accepted."
+  ).option("--name <name>", 'Display name (defaults to "Untitled project"; max 120 characters)').option(
+    "-w, --workspace <id>",
+    "The workspace to create it in (id from `anima workspaces`). Optional when you can create in only one workspace; otherwise required, since there is no default"
+  ).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 (opts) => {
+    const mode = detectOutputMode(opts);
+    initLogger(opts.logFile);
+    const progress = new ProgressReporter(mode, opts.verbose);
+    await withCommandErrors(mode, async () => {
+      try {
+        await run();
+      } catch (err) {
+        progress.fail("Failed");
+        throw err;
+      }
+    });
+    async function run() {
+      const args = buildCreateKnowledgeArgs(opts.name, opts.workspace);
+      const auth = await resolveAuth(opts.apiUrl);
+      progress.start("Creating knowledge artifact from template...");
+      const result = await withMcp(
+        { apiBaseUrl: resolveApiUrl(opts.apiUrl), token: auth.token, teamId: auth.teamId },
+        (client) => client.callTool("artifact-create_knowledge", args)
+      );
+      if (!result.success || !result.sessionId) {
+        throw apiError(result.message || result.reason || result.error || "Knowledge artifact creation failed", result);
+      }
+      progress.succeed("Knowledge artifact created");
+      if (mode === "pretty") {
+        printSessionResult({
+          sessionId: result.sessionId,
+          artifactUrl: result.artifactUrl,
+          playgroundUrl: result.playgroundUrl
+        });
+        if (result.fileCount !== void 0) {
+          printKeyValue("Template files", String(result.fileCount));
+        }
+        console.log();
+      } else {
+        outputResult(mode, result);
+      }
+    }
+  });
+}
+var createKnowledgeCommand = makeCreateKnowledgeCommand();
+
+// src/commands/list.ts
+import { Command as Command3 } from "commander";
 import chalk3 from "chalk";
-var listCommand = new Command2("list").summary("List your team's artifacts, most-recently-updated first").aliases(["ls", "artifacts"]).description(
-  "List your team's artifacts (most-recently-updated first) so you can resume existing work."
+var listCommand = new Command3("list").summary("List the artifacts you can read, most-recently-updated first").aliases(["ls", "artifacts"]).description(
+  "List the artifacts you can read, across every workspace you can reach or in one (most-recently-updated first), so you can resume existing work."
+).option(
+  "-w, --workspace <id>",
+  "Only this workspace (id from `anima workspaces`); omit to span every workspace you can read"
 ).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 = await resolveAuth(opts.apiUrl);
+    const workspaceId = workspaceFlag(opts.workspace);
     const result = await withMcp(
       { apiBaseUrl: resolveApiUrl(opts.apiUrl), token: auth.token, teamId: auth.teamId },
-      (client) => client.callTool("workspace-list_artifacts", {})
+      (client) => client.callTool(
+        "workspace-list_artifacts",
+        workspaceId !== void 0 ? { workspaceId } : {}
+      )
     );
     if (!result.success) {
-      const message = result.reason || result.error || "Could not list artifacts";
+      const message = result.message || result.reason || result.error || "Could not list artifacts";
       throw apiError(message, result);
     }
     const artifacts = result.artifacts ?? [];
@@ -1233,20 +1365,19 @@ var listCommand = new Command2("list").summary("List your team's artifacts, most
       if (artifacts.length === 0) {
         console.log();
         console.log(
-          "  No artifacts yet \u2014 create one with `create -t empty` or `create -t import`."
+          workspaceId !== void 0 ? "  Nothing you can read in that workspace." : "  No artifacts you can read \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("session:")} ${a.sessionId}`);
+          if (a.workspaceName) {
+            console.log(`    ${chalk3.gray("workspace:")} ${a.workspaceName}`);
           }
           console.log(`    ${chalk3.gray("updated:")} ${formatUpdatedAt(a.updatedAt)}`);
-          if (a.sessionId) {
-            console.log(`    ${chalk3.cyan.underline(artifactUrlFor(a.sessionId))}`);
-          }
+          console.log(`    ${chalk3.cyan.underline(artifactUrlFor(a.sessionId))}`);
           console.log();
         }
         if (result.truncated) {
@@ -1259,13 +1390,9 @@ var listCommand = new Command2("list").summary("List your team's artifacts, most
     } else {
       outputResult(mode, {
         success: true,
-        workspaceId: result.workspaceId,
         // The listing tool returns no URL; deriving it here saves every caller
         // the same string concatenation, and keeps one definition of the link.
-        artifacts: artifacts.map((a) => ({
-          ...a,
-          ...a.sessionId ? { artifactUrl: artifactUrlFor(a.sessionId) } : {}
-        })),
+        artifacts: artifacts.map((a) => ({ ...a, artifactUrl: artifactUrlFor(a.sessionId) })),
         truncated: result.truncated ?? false
       });
     }
@@ -1289,10 +1416,65 @@ function formatUpdatedAt(iso) {
   return `${relative2} (${iso})`;
 }
 
-// src/commands/status.ts
-import { Command as Command3 } from "commander";
+// src/commands/workspaces.ts
+import { Command as Command4 } from "commander";
 import chalk4 from "chalk";
-var statusCommand = new Command3("status").summary("Check whether an artifact finished generating").description(
+var workspacesCommand = new Command4("workspaces").summary("List the workspaces you can reach, and what you may do in each").aliases(["ws"]).description(
+  "List the workspaces you can read in your team, with the capabilities you hold in each. Use a workspace id with `list --workspace` or `create --workspace`."
+).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 = await resolveAuth(opts.apiUrl);
+    const result = await withMcp(
+      { apiBaseUrl: resolveApiUrl(opts.apiUrl), token: auth.token, teamId: auth.teamId },
+      (client) => client.callTool("workspace-list_workspaces", {})
+    );
+    if (!result.success) {
+      const message = result.message || result.reason || result.error || "Could not list workspaces";
+      throw apiError(message, result);
+    }
+    const workspaces = result.workspaces ?? [];
+    logEvent("workspaces_listed", { count: workspaces.length });
+    if (mode === "pretty") {
+      console.log();
+      if (workspaces.length === 0) {
+        console.log("  You cannot reach any workspace in this team.");
+        console.log(
+          chalk4.gray("  Someone who manages the team can grant you access to one.")
+        );
+        console.log();
+      } else {
+        for (const workspace of workspaces) {
+          const label = workspace.isGeneral && workspace.name !== "General" ? chalk4.gray(" (General)") : "";
+          console.log(`  ${chalk4.bold(workspace.name)}${label}`);
+          console.log(`    ${chalk4.gray("id:")} ${workspace.workspaceId}`);
+          console.log(
+            `    ${chalk4.gray("you can:")} ${workspace.capabilities.join(", ") || chalk4.gray("nothing")}`
+          );
+          console.log();
+        }
+      }
+    } else {
+      outputResult(mode, { success: true, workspaces });
+    }
+  } 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;
+  }
+});
+
+// src/commands/status.ts
+import { Command as Command5 } from "commander";
+import chalk5 from "chalk";
+var statusCommand = new Command5("status").summary("Check whether an artifact finished generating").description(
   "Check whether an artifact finished generating. --wait blocks until it is ready or failed."
 ).argument("<artifactUrl>", "Artifact URL or session ID").option("--wait", "Block until generation finishes instead of returning a snapshot").option("--json", "Output as JSON").option("--timeout <ms>", "How long --wait may block", "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 (artifactUrl, opts) => {
   const mode = detectOutputMode(opts);
@@ -1348,10 +1530,10 @@ function printArtifactStatus(sessionId, result) {
     printKeyValue("Progress", `${result.progress}%`);
   }
   if (result.artifactUrl) {
-    printKeyValue("Your artifact", chalk4.cyan.underline(result.artifactUrl));
+    printKeyValue("Your artifact", chalk5.cyan.underline(result.artifactUrl));
   }
   if (result.playgroundUrl) {
-    printKeyValue("Edit in Playground", chalk4.cyan.underline(result.playgroundUrl));
+    printKeyValue("Edit in Playground", chalk5.cyan.underline(result.playgroundUrl));
   }
   if (result.nextStep) {
     console.log();
@@ -1361,8 +1543,8 @@ function printArtifactStatus(sessionId, result) {
 }
 
 // src/commands/publish.ts
-import { Command as Command4 } from "commander";
-var publishCommand = new Command4("publish").summary("Deploy to a public live URL (only when asked)").description("Deploy an artifact's app to a live public URL (1-3 min)").argument("<sessionId>", "Session ID from create command").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 Command6 } from "commander";
+var publishCommand = new Command6("publish").summary("Deploy to a public live URL (only when asked)").description("Deploy an artifact's app to a live public URL (1-3 min)").argument("<sessionId>", "Session ID from create command").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);
@@ -1408,7 +1590,7 @@ var publishCommand = new Command4("publish").summary("Deploy to a public live UR
 });
 
 // src/commands/codegen.ts
-import { Command as Command5 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/utils/files.ts
 import fs4 from "fs";
@@ -1436,7 +1618,7 @@ function writeFilesToDisk(files, outputDir) {
 }
 
 // src/commands/codegen.ts
-var codegenCommand = new Command5("codegen").summary("Convert a Figma design to local code files").description("Convert Figma design to code files (no artifact)").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 Command7("codegen").summary("Convert a Figma design to local code files").description("Convert Figma design to code files (no artifact)").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);
@@ -1508,8 +1690,8 @@ var codegenCommand = new Command5("codegen").summary("Convert a Figma design to
 });
 
 // src/commands/getGitToken.ts
-import { Command as Command6 } from "commander";
-import chalk5 from "chalk";
+import { Command as Command8 } from "commander";
+import chalk6 from "chalk";
 
 // src/utils/gitToken.ts
 function preview(payload) {
@@ -1555,7 +1737,7 @@ function gitConfigCommands(commitAuthor) {
 }
 
 // src/commands/getGitToken.ts
-var getGitTokenCommand = new Command6("get-git-token").summary("Mint git access to an artifact's repository").description("Mint a short-lived git remote URL for an artifact (clone/push with git)").argument("<artifactUrl>", "Artifact 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 (artifactUrl, opts) => {
+var getGitTokenCommand = new Command8("get-git-token").summary("Mint git access to an artifact's repository").description("Mint a short-lived git remote URL for an artifact (clone/push with git)").argument("<artifactUrl>", "Artifact 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 (artifactUrl, opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   const progress = new ProgressReporter(mode, opts.verbose);
@@ -1572,12 +1754,12 @@ var getGitTokenCommand = new Command6("get-git-token").summary("Mint git access
     progress.succeed(`Git access granted (${grant.access === "rw" ? "read-write" : "read-only"})`);
     if (mode === "pretty") {
       console.log();
-      console.log(`  ${chalk5.cyan(`git clone ${grant.gitRemoteUrl}`)}`);
+      console.log(`  ${chalk6.cyan(`git clone ${grant.gitRemoteUrl}`)}`);
       console.log();
       if (grant.access === "rw") {
         if (grant.commitAuthor) {
           console.log("  In the clone, set who your commits are from:");
-          console.log(`    ${chalk5.cyan(gitConfigCommands(grant.commitAuthor))}`);
+          console.log(`    ${chalk6.cyan(gitConfigCommands(grant.commitAuthor))}`);
           console.log();
         }
         console.log("  Commit and push to update the live artifact.");
@@ -1587,7 +1769,7 @@ var getGitTokenCommand = new Command6("get-git-token").summary("Mint git access
       if (grant.expiresAt) {
         console.log(
           `  The URL embeds a token that expires at ${grant.expiresAt} and cannot be renewed;
-  re-run this command and ${chalk5.cyan("git remote set-url origin <new url>")} to keep pushing.`
+  re-run this command and ${chalk6.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 artifact.");
@@ -1620,11 +1802,11 @@ var getGitTokenCommand = new Command6("get-git-token").summary("Mint git access
 });
 
 // src/commands/mcpConfig.ts
-import { Command as Command8 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/commands/login.ts
-import { Command as Command7 } from "commander";
-import chalk6 from "chalk";
+import { Command as Command9 } from "commander";
+import chalk7 from "chalk";
 import open from "open";
 
 // src/auth/device.ts
@@ -1814,7 +1996,7 @@ function resolveDeadline(claimableUntil, now) {
 }
 
 // src/commands/login.ts
-var loginCommand = new Command7("login").summary("Connect this machine as a scoped agent identity").description("Log in via the device flow, redeem an invite with --invite, or finish an anonymous create with --handoff").option("--invite <url-or-code>", "Redeem an invite link (\u2026/invite/<code>.md) or bare code \u2014 no approval step").option(
+var loginCommand = new Command9("login").summary("Connect this machine as a scoped agent identity").description("Log in via the device flow, redeem an invite with --invite, or finish an anonymous create with --handoff").option("--invite <url-or-code>", "Redeem an invite link (\u2026/invite/<code>.md) or bare code \u2014 no approval step").option(
   "--handoff [token]",
   "Log in with the handoff token from an anonymous create. Waits until a human claims the artifact. Defaults to your last one"
 ).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(
@@ -1884,9 +2066,9 @@ var loginCommand = new Command7("login").summary("Connect this machine as a scop
           console.log();
           printInfo("To connect, open the verification page and enter this code:");
           console.log();
-          console.log(`    ${chalk6.cyan.underline(info.verificationUri)}`);
+          console.log(`    ${chalk7.cyan.underline(info.verificationUri)}`);
           console.log();
-          console.log(`    ${chalk6.bold.white(info.userCode)}`);
+          console.log(`    ${chalk7.bold.white(info.userCode)}`);
           console.log();
           printInfo(`Waiting for approval\u2026 (code expires in ${Math.round(info.expiresInSeconds / 60)} minutes)`);
         } else {
@@ -1963,7 +2145,7 @@ async function runHandoffLogin(opts, mode) {
       printInfo("Waiting for a human to claim the artifact:");
       if (pending.artifactUrl) {
         console.log();
-        console.log(`    ${chalk6.cyan.underline(pending.artifactUrl)}`);
+        console.log(`    ${chalk7.cyan.underline(pending.artifactUrl)}`);
       }
       console.log();
       printInfo(
@@ -2038,7 +2220,7 @@ function buildMcpConfig(apiUrl) {
 }
 
 // src/commands/mcpConfig.ts
-var mcpConfigCommand = new Command8("mcp-config").summary("Print an MCP server config for your MCP client").description("Print an MCP server config for your MCP client").option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").action(async (opts) => {
+var mcpConfigCommand = new Command10("mcp-config").summary("Print an MCP server config for your MCP client").description("Print an MCP server config for your MCP client").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 mcpConfig = buildMcpConfig(resolveApiUrl(opts.apiUrl));
@@ -2065,8 +2247,8 @@ var mcpConfigCommand = new Command8("mcp-config").summary("Print an MCP server c
 });
 
 // src/commands/auth.ts
-import { Command as Command9 } from "commander";
-import chalk7 from "chalk";
+import { Command as Command11 } from "commander";
+import chalk8 from "chalk";
 var DEFAULT_API_URL2 = "https://api.agentgrid.io";
 function describePendingHandoff(pending, state) {
   return {
@@ -2084,10 +2266,10 @@ function printPendingHandoff(pending, state) {
     return;
   }
   printInfo(`Anonymous artifact ${pending.sessionId} is awaiting a claim (until ${pending.claimableUntil}):`);
-  console.log(`    ${chalk7.cyan.underline(pending.artifactUrl)}`);
-  console.log(`  Run ${chalk7.cyan("anima login --handoff")} to wait for it.`);
+  console.log(`    ${chalk8.cyan.underline(pending.artifactUrl)}`);
+  console.log(`  Run ${chalk8.cyan("anima login --handoff")} to wait for it.`);
 }
-var authCommand = new Command9("auth").summary("Inspect or manage stored credentials").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) => {
+var authCommand = new Command11("auth").summary("Inspect or manage stored credentials").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) {
@@ -2187,13 +2369,13 @@ var authCommand = new Command9("auth").summary("Inspect or manage stored credent
     if (mode === "pretty") {
       console.log();
       printInfo("Auth commands:");
-      console.log(`  ${chalk7.cyan("anima login")}                    Log in (device flow \u2014 approve on any browser)`);
-      console.log(`  ${chalk7.cyan("anima login --handoff")}          Wait for a human to claim your anonymous artifact`);
-      console.log(`  ${chalk7.cyan("anima logout")}                   Clear all credentials`);
-      console.log(`  ${chalk7.cyan("anima auth --status")}            Check auth status`);
-      console.log(`  ${chalk7.cyan("anima auth --figma-token <T>")}   Save Figma token (needed for codegen/f2c)`);
+      console.log(`  ${chalk8.cyan("anima login")}                    Log in (device flow \u2014 approve on any browser)`);
+      console.log(`  ${chalk8.cyan("anima login --handoff")}          Wait for a human to claim your anonymous artifact`);
+      console.log(`  ${chalk8.cyan("anima logout")}                   Clear all credentials`);
+      console.log(`  ${chalk8.cyan("anima auth --status")}            Check auth status`);
+      console.log(`  ${chalk8.cyan("anima auth --figma-token <T>")}   Save Figma token (needed for codegen/f2c)`);
       console.log();
-      console.log(`  Figma token: ${chalk7.cyan.underline("https://www.figma.com")} > Settings > Personal access tokens`);
+      console.log(`  Figma token: ${chalk8.cyan.underline("https://www.figma.com")} > Settings > Personal access tokens`);
       console.log();
     } else {
       outputResult(mode, {
@@ -2215,8 +2397,8 @@ var authCommand = new Command9("auth").summary("Inspect or manage stored credent
 });
 
 // src/commands/logout.ts
-import { Command as Command10 } from "commander";
-var logoutCommand = new Command10("logout").summary("Disconnect: revoke and clear every stored credential").description("Clear all stored credentials (AgentGrid + Figma tokens) from this machine").option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").action(async (opts) => {
+import { Command as Command12 } from "commander";
+var logoutCommand = new Command12("logout").summary("Disconnect: revoke and clear every stored credential").description("Clear all stored credentials (AgentGrid + Figma tokens) from this machine").option("--json", "Output as JSON").option("--api-url <url>", "API base URL (overrides config / ANIMA_API_URL)").action(async (opts) => {
   const mode = detectOutputMode(opts);
   const revoked = await revokeStoredRefreshToken(resolveApiUrl(opts.apiUrl));
   const hadCredentials = clearStorage();
@@ -2234,8 +2416,8 @@ var logoutCommand = new Command10("logout").summary("Disconnect: revoke and clea
 });
 
 // src/commands/unpublish.ts
-import { Command as Command11 } from "commander";
-var unpublishCommand = new Command11("unpublish").summary("Take a published artifact offline").description("Take a published artifact offline (clears its live URL; code and artifact stay intact)").argument("<sessionId>", "Session ID of the published artifact").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 Command13 } from "commander";
+var unpublishCommand = new Command13("unpublish").summary("Take a published artifact offline").description("Take a published artifact offline (clears its live URL; code and artifact stay intact)").argument("<sessionId>", "Session ID of the published artifact").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);
@@ -2270,8 +2452,8 @@ var unpublishCommand = new Command11("unpublish").summary("Take a published arti
 });
 
 // src/commands/update.ts
-import { Command as Command12 } from "commander";
-var updateCommand = new Command12("update").summary("Rename an artifact or change its visibility").description("Update an artifact's metadata: display name and/or visibility (never touches code)").argument("<sessionId>", "Session ID of the artifact").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 Command14 } from "commander";
+var updateCommand = new Command14("update").summary("Rename an artifact or change its visibility").description("Update an artifact's metadata: display name and/or visibility (never touches code)").argument("<sessionId>", "Session ID of the artifact").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);
@@ -2316,8 +2498,8 @@ var updateCommand = new Command12("update").summary("Rename an artifact or chang
 });
 
 // src/commands/config.ts
-import { Command as Command13 } from "commander";
-var configCommand = new Command13("config").summary("Store CLI preferences (e.g. a default API URL)").description(
+import { Command as Command15 } from "commander";
+var configCommand = new Command15("config").summary("Store CLI preferences (e.g. a default API URL)").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) => {
@@ -2383,9 +2565,9 @@ function assertUrl(value) {
 }
 
 // src/commands/duplicate.ts
-import { Command as Command14 } from "commander";
-import chalk8 from "chalk";
-function buildDuplicateArgs(artifactUrl, name) {
+import { Command as Command16 } from "commander";
+import chalk9 from "chalk";
+function buildDuplicateArgs(artifactUrl, name, workspaceId) {
   const sessionId = parseArtifactUrl(artifactUrl);
   if (!sessionId) {
     throw validationError("A source artifact URL or session ID is required");
@@ -2393,17 +2575,24 @@ function buildDuplicateArgs(artifactUrl, name) {
   if (name !== void 0 && (name.length === 0 || name.length > 120)) {
     throw validationError("--name must be between 1 and 120 characters");
   }
-  return { sessionId, ...name !== void 0 ? { name } : {} };
+  return {
+    sessionId,
+    ...name !== void 0 ? { name } : {},
+    ...workspaceFlag(workspaceId) !== void 0 ? { workspaceId } : {}
+  };
 }
 function createDuplicateCommand() {
-  return new Command14("duplicate").summary("Copy an artifact into a new, independent one").description(
+  return new Command16("duplicate").summary("Copy an artifact into a new, independent one").description(
     "Duplicate an artifact into a new, independent artifact. Copies code, assets, and supported database content; chat and custom domains are not copied. Duplication is non-idempotent: if a request times out or its response is lost, list recent artifacts before retrying because the first request may already have created the copy."
-  ).argument("<artifactUrl>", "Source artifact URL or session ID").option("--name <name>", "Display name for the duplicate (defaults to '<source name> (Copy)')").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 (artifactUrl, opts) => {
+  ).argument("<artifactUrl>", "Source artifact URL or session ID").option("--name <name>", "Display name for the duplicate (defaults to '<source name> (Copy)')").option(
+    "-w, --workspace <id>",
+    "The workspace to put the copy in (id from `anima workspaces`). Optional when you can create in only one workspace; otherwise required, since there is no default"
+  ).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 (artifactUrl, opts) => {
     const mode = detectOutputMode(opts);
     initLogger(opts.logFile);
     const progress = new ProgressReporter(mode, opts.verbose);
     try {
-      const args = buildDuplicateArgs(artifactUrl, opts.name);
+      const args = buildDuplicateArgs(artifactUrl, opts.name, opts.workspace);
       const auth = await resolveAuth(opts.apiUrl);
       progress.start("Duplicating artifact...");
       const result = await withMcp(
@@ -2411,7 +2600,7 @@ function createDuplicateCommand() {
         (client) => client.callTool("artifact-duplicate", args)
       );
       if (!result.success) {
-        throw apiError(result.reason || result.error || "Artifact duplication failed", result);
+        throw apiError(result.message || result.reason || result.error || "Artifact duplication failed", result);
       }
       progress.succeed("Artifact duplicated");
       if (mode === "pretty") {
@@ -2420,12 +2609,12 @@ function createDuplicateCommand() {
         printKeyValue("Name", result.name);
         printKeyValue("Session ID", result.sessionId);
         printKeyValue("Source session", result.sourceSessionId);
-        printKeyValue("Artifact", chalk8.cyan.underline(result.artifactUrl));
+        printKeyValue("Artifact", chalk9.cyan.underline(result.artifactUrl));
         if (result.playgroundUrl) {
-          printKeyValue("Edit in Playground", chalk8.cyan.underline(result.playgroundUrl));
+          printKeyValue("Edit in Playground", chalk9.cyan.underline(result.playgroundUrl));
         }
         if (result.previewUrl) {
-          printKeyValue("Preview", chalk8.cyan.underline(result.previewUrl));
+          printKeyValue("Preview", chalk9.cyan.underline(result.previewUrl));
         }
         printKeyValue("Next steps", result.nextSteps);
         console.log();
@@ -2449,8 +2638,8 @@ function createDuplicateCommand() {
 var duplicateCommand = createDuplicateCommand();
 
 // src/commands/explore.ts
-import { Command as Command15 } from "commander";
-import chalk9 from "chalk";
+import { Command as Command17 } from "commander";
+import chalk10 from "chalk";
 
 // src/api/tool.ts
 async function runTool(toolName, args, options = {}) {
@@ -2476,25 +2665,8 @@ function describeFailure(result) {
 ${nextSteps}` : base;
 }
 
-// src/commands/runner.ts
-async function withCommandErrors(mode, fn) {
-  try {
-    await fn();
-  } catch (err) {
-    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/explore.ts
-var exploreCommand = new Command15("explore").summary("Read an artifact's files: list, search, read, history").description(
+var exploreCommand = new Command17("explore").summary("Read an artifact's files: list, search, read, history").description(
   "Inspect an artifact's files without git: list them (--tree), search them (--search), read them (--read), or show commits (--history)."
 ).argument("<artifactUrl>", "Artifact URL or session ID").option("--tree", "List file paths").option("--search <query>", "Find text inside files \u2014 start here when you don't know the file").option("--read <paths...>", "Return the contents of these files").option("--history", "List commits, newest first").option("--path <prefix>", "tree/search: a literal directory prefix (not a glob)").option("--range <start,end>", "read: line window, 1-based inclusive, for a single file").option("--revision <rev>", "Look at the artifact as it was at this commit").option("--regex", "search: treat the query as a JavaScript regular expression").option("--case-sensitive", "search: match case exactly").option("--include-excluded", "tree/search: also look inside node_modules, dist and build").option("--limit <n>", "tree/search/history: maximum rows to return").option("--cursor <cursor>", "history: continue after a previous response's nextCursor").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 (artifactUrl, opts) => {
   const mode = detectOutputMode(opts);
@@ -2567,42 +2739,42 @@ function printExplore(action, result) {
   if (action === "tree") {
     for (const file of result.files ?? []) {
       const kind = result.unwritable?.[file];
-      console.log(`  ${file}${kind ? chalk9.gray(` (${kind} \u2014 git only)`) : ""}`);
+      console.log(`  ${file}${kind ? chalk10.gray(` (${kind} \u2014 git only)`) : ""}`);
     }
     if (result.matchedFiles !== void 0) {
       console.log();
-      console.log(chalk9.gray(`  ${(result.files ?? []).length} of ${result.matchedFiles} shown`));
+      console.log(chalk10.gray(`  ${(result.files ?? []).length} of ${result.matchedFiles} shown`));
     }
   } else if (action === "search") {
     for (const match of result.matches ?? []) {
-      console.log(`  ${chalk9.cyan(match.path)}:${match.line}  ${match.lineText.trim()}`);
+      console.log(`  ${chalk10.cyan(match.path)}:${match.line}  ${match.lineText.trim()}`);
     }
     if (!result.matches?.length) {
       console.log("  No matches.");
       const skipped = result.notSearched;
       if (skipped?.excluded) {
         console.log(
-          chalk9.yellow(
+          chalk10.yellow(
             `  ${skipped.excluded} files were skipped (node_modules, dist, build) \u2014 retry with --include-excluded.`
           )
         );
       }
       if (skipped?.assets) {
-        console.log(chalk9.gray(`  ${skipped.assets} binary files cannot match a text query.`));
+        console.log(chalk10.gray(`  ${skipped.assets} binary files cannot match a text query.`));
       }
     }
   } else if (action === "read") {
     for (const file of result.files ?? []) {
-      console.log(chalk9.bold(`  ${file.path}`));
+      console.log(chalk10.bold(`  ${file.path}`));
       if (file.asset) {
-        console.log(chalk9.gray(`    binary \u2014 ${file.size ?? "?"} bytes, ${file.mime ?? "unknown type"}`));
+        console.log(chalk10.gray(`    binary \u2014 ${file.size ?? "?"} bytes, ${file.mime ?? "unknown type"}`));
       } else if (file.deferred) {
-        console.log(chalk9.yellow("    not returned: the response ran out of budget \u2014 read it on its own"));
+        console.log(chalk10.yellow("    not returned: the response ran out of budget \u2014 read it on its own"));
       } else {
         console.log(file.content ?? "");
         if (file.truncated) {
           console.log(
-            chalk9.yellow(
+            chalk10.yellow(
               `    lines ${file.startLine}-${file.endLine} of ${file.totalLines} \u2014 read the rest with --range`
             )
           );
@@ -2612,33 +2784,33 @@ function printExplore(action, result) {
     }
     for (const missing of result.missingPaths ?? []) {
       const near = result.suggestions?.[missing];
-      console.log(chalk9.yellow(`  Not found: ${missing}${near?.length ? ` \u2014 did you mean ${near.join(", ")}?` : ""}`));
+      console.log(chalk10.yellow(`  Not found: ${missing}${near?.length ? ` \u2014 did you mean ${near.join(", ")}?` : ""}`));
     }
   } else {
     const commits = result.commit ? [result.commit] : result.commits ?? [];
     for (const commit of commits) {
-      console.log(`  ${chalk9.yellow(commit.revision.slice(0, 10))}  ${commit.message.split("\n")[0]}`);
-      console.log(chalk9.gray(`    ${commit.author} \u2014 ${commit.date}`));
+      console.log(`  ${chalk10.yellow(commit.revision.slice(0, 10))}  ${commit.message.split("\n")[0]}`);
+      console.log(chalk10.gray(`    ${commit.author} \u2014 ${commit.date}`));
     }
     for (const changed of result.commit?.changedFiles ?? []) {
-      console.log(chalk9.gray(`      ${changed.change.padEnd(8)} ${changed.path}`));
+      console.log(chalk10.gray(`      ${changed.change.padEnd(8)} ${changed.path}`));
     }
   }
   if (result.truncated) {
-    console.log(chalk9.yellow("  The list was capped \u2014 raise --limit to see more."));
+    console.log(chalk10.yellow("  The list was capped \u2014 raise --limit to see more."));
   }
   if (result.revision) {
     console.log();
-    console.log(chalk9.gray(`  revision: ${result.revision}  (pass to \`anima edit --base-revision\`)`));
+    console.log(chalk10.gray(`  revision: ${result.revision}  (pass to \`anima edit --base-revision\`)`));
   }
   console.log();
 }
 
 // src/commands/edit.ts
-import { Command as Command16 } from "commander";
+import { Command as Command18 } from "commander";
 import fs5 from "fs";
-import chalk10 from "chalk";
-var editCommand = new Command16("edit").summary("Change an artifact's files and commit them").description(
+import chalk11 from "chalk";
+var editCommand = new Command18("edit").summary("Change an artifact's files and commit them").description(
   "Change an artifact's files and commit them, without git. All changes land as one commit."
 ).argument("<artifactUrl>", "Artifact URL or session ID").requiredOption("-m, --message <message>", "Commit message").option(
   "--base-revision <rev>",
@@ -2660,7 +2832,7 @@ var editCommand = new Command16("edit").summary("Change an artifact's files and
       printSuccess("Committed.");
       for (const changed of result.changedFiles ?? []) {
         const detail = changed.op === "move" ? `${changed.fromPath} \u2192 ${changed.path}` : changed.replacements !== void 0 ? `${changed.path} (${changed.replacements} replaced)` : changed.path;
-        console.log(`  ${chalk10.gray(changed.op.padEnd(12))} ${detail}`);
+        console.log(`  ${chalk11.gray(changed.op.padEnd(12))} ${detail}`);
       }
       console.log();
       printKeyValue("Revision", result.revision ?? "unknown");
@@ -2758,11 +2930,11 @@ function readFile(path7) {
 }
 
 // src/commands/uploadAsset.ts
-import { Command as Command17 } from "commander";
+import { Command as Command19 } from "commander";
 import fs6 from "fs";
 import path5 from "path";
-import chalk11 from "chalk";
-var uploadAssetCommand = new Command17("upload-asset").summary("Add an image, font or media file over 256 KB").description(
+import chalk12 from "chalk";
+var uploadAssetCommand = new Command19("upload-asset").summary("Add an image, font or media file over 256 KB").description(
   "Add a large image, font or media file (over 256 KB) to an artifact: stage it, upload it, and commit it at --path."
 ).argument("<artifactUrl>", "Artifact URL or session ID").argument("<file>", "Local file to upload").option(
   "--path <path>",
@@ -2799,7 +2971,7 @@ var uploadAssetCommand = new Command17("upload-asset").summary("Add an image, fo
         console.log();
         console.log("  Commit it where it belongs with:");
         console.log(
-          `    ${chalk11.cyan(
+          `    ${chalk12.cyan(
             `anima edit ${sessionId} -m "Add asset" --changes '[{"op":"write","path":"public/${path5.basename(file)}","assetUploadId":"${grant.assetUploadId}"}]'`
           )}`
         );
@@ -2876,8 +3048,8 @@ function readAsset(file) {
 }
 
 // src/commands/delete.ts
-import { Command as Command18 } from "commander";
-var deleteCommand = new Command18("delete").summary("Delete an artifact (reversible: hidden, not erased)").description("Soft-delete an artifact only when explicitly requested (unpublish it first; content is retained)").argument("<artifactUrl>", "Artifact URL or session ID to soft-delete").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 (artifactUrl, opts) => {
+import { Command as Command20 } from "commander";
+var deleteCommand = new Command20("delete").summary("Delete an artifact (reversible: hidden, not erased)").description("Soft-delete an artifact only when explicitly requested (unpublish it first; content is retained)").argument("<artifactUrl>", "Artifact URL or session ID to soft-delete").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 (artifactUrl, opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   const progress = new ProgressReporter(mode, opts.verbose);
@@ -2918,9 +3090,9 @@ var deleteCommand = new Command18("delete").summary("Delete an artifact (reversi
 });
 
 // src/commands/review.ts
-import { Command as Command19 } from "commander";
-import chalk12 from "chalk";
-var listSubcommand = new Command19("list").summary("Read the comments addressed to you").description("Read the review comments addressed to you, newest artifact activity first").argument("[artifactUrl]", "Limit to one artifact; omit for every review addressed to you").option("--limit <n>", "Maximum reviews to return (1-50, default 20)").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 (artifactUrl, opts) => {
+import { Command as Command21 } from "commander";
+import chalk13 from "chalk";
+var listSubcommand = new Command21("list").summary("Read the comments addressed to you").description("Read the review comments addressed to you, newest artifact activity first").argument("[artifactUrl]", "Limit to one artifact; omit for every review addressed to you").option("--limit <n>", "Maximum reviews to return (1-50, default 20)").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 (artifactUrl, opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   await withCommandErrors(mode, async () => {
@@ -2935,7 +3107,7 @@ var listSubcommand = new Command19("list").summary("Read the comments addressed
     }
   });
 });
-var resolveSubcommand = new Command19("resolve").summary("Close one comment without a commit").description("Close one comment without a commit \u2014 for a question answered, or a change you decided against").argument("<commentId>", "Comment to close, from `anima review list`").option("--note <text>", "What to tell the reviewer as the closing message").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 (commentId, opts) => {
+var resolveSubcommand = new Command21("resolve").summary("Close one comment without a commit").description("Close one comment without a commit \u2014 for a question answered, or a change you decided against").argument("<commentId>", "Comment to close, from `anima review list`").option("--note <text>", "What to tell the reviewer as the closing message").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 (commentId, opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   await withCommandErrors(mode, async () => {
@@ -2954,7 +3126,7 @@ var resolveSubcommand = new Command19("resolve").summary("Close one comment with
     }
   });
 });
-var replySubcommand = new Command19("reply").summary("Answer one comment, leaving it open").description("Say something back on one comment and LEAVE IT OPEN \u2014 to ask, report, or say you are blocked").argument("<commentId>", "Comment to reply to, from `anima review list`").requiredOption("-m, --message <message>", "What to say to the reviewer").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 (commentId, opts) => {
+var replySubcommand = new Command21("reply").summary("Answer one comment, leaving it open").description("Say something back on one comment and LEAVE IT OPEN \u2014 to ask, report, or say you are blocked").argument("<commentId>", "Comment to reply to, from `anima review list`").requiredOption("-m, --message <message>", "What to say to the reviewer").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 (commentId, opts) => {
   const mode = detectOutputMode(opts);
   initLogger(opts.logFile);
   await withCommandErrors(mode, async () => {
@@ -2973,7 +3145,7 @@ var replySubcommand = new Command19("reply").summary("Answer one comment, leavin
     }
   });
 });
-var reviewCommand = new Command19("review").summary("Read and answer the comments humans addressed to you").description("Read and answer the review comments humans addressed to you (list / resolve / reply)").addCommand(listSubcommand).addCommand(resolveSubcommand).addCommand(replySubcommand);
+var reviewCommand = new Command21("review").summary("Read and answer the comments humans addressed to you").description("Read and answer the review comments humans addressed to you (list / resolve / reply)").addCommand(listSubcommand).addCommand(resolveSubcommand).addCommand(replySubcommand);
 function parseLimit2(value) {
   const limit = Number(value);
   if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
@@ -2990,29 +3162,29 @@ function printReviews(result) {
     return;
   }
   for (const review of reviews) {
-    console.log(`  ${chalk12.bold(`Review ${review.reviewId}`)} ${chalk12.gray(`by ${review.author.name}`)}`);
-    console.log(`    ${chalk12.cyan.underline(review.artifactUrl)}`);
+    console.log(`  ${chalk13.bold(`Review ${review.reviewId}`)} ${chalk13.gray(`by ${review.author.name}`)}`);
+    console.log(`    ${chalk13.cyan.underline(review.artifactUrl)}`);
     if (!review.isLatest) {
       console.log(
-        chalk12.yellow("    The artifact moved since this was written \u2014 check the comments still apply.")
+        chalk13.yellow("    The artifact moved since this was written \u2014 check the comments still apply.")
       );
     }
     console.log();
     for (const comment of review.comments) {
       const marks = [
-        comment.status !== "open" ? chalk12.gray(comment.status) : null,
-        comment.unassigned ? chalk12.yellow("unassigned") : null
+        comment.status !== "open" ? chalk13.gray(comment.status) : null,
+        comment.unassigned ? chalk13.yellow("unassigned") : null
       ].filter(Boolean).join(" ");
-      console.log(`    ${chalk12.bold(`#${comment.index}`)} ${comment.body}${marks ? ` ${marks}` : ""}`);
-      console.log(chalk12.gray(`       ${comment.commentId}${describeAnchor(comment)}`));
+      console.log(`    ${chalk13.bold(`#${comment.index}`)} ${comment.body}${marks ? ` ${marks}` : ""}`);
+      console.log(chalk13.gray(`       ${comment.commentId}${describeAnchor(comment)}`));
       for (const reply of comment.replies ?? []) {
-        console.log(chalk12.gray(`       \u21B3 ${reply.author.name}: ${reply.body}`));
+        console.log(chalk13.gray(`       \u21B3 ${reply.author.name}: ${reply.body}`));
       }
       console.log();
     }
     printKeyValue("To close these in a commit", "");
     for (const line of review.resolveTrailer.split("\n")) {
-      console.log(`      ${chalk12.gray(line)}`);
+      console.log(`      ${chalk13.gray(line)}`);
     }
     console.log();
   }
@@ -3033,13 +3205,13 @@ function describeAnchor(comment) {
 }
 
 // src/commands/skill.ts
-import { Command as Command20 } from "commander";
+import { Command as Command22 } from "commander";
 import fs7 from "fs";
 import path6 from "path";
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 var GUIDE_PATH = "/guide.md";
 function createSkillCommand() {
-  return new Command20("skill").summary("Install the AgentGrid guide as a skill your agent can read").description(
+  return new Command22("skill").summary("Install the AgentGrid guide as a skill your agent can read").description(
     "Fetch the AgentGrid agent guide and write it as a SKILL.md your runtime can load, or print it to stdout. The guide comes from the API, so it stays current; the command reference is generated from this CLI's own commands."
   ).argument(
     "[path]",
@@ -3066,8 +3238,8 @@ ${body}
       logEvent("skill_installed", { path: target, bytes: document.length });
       if (mode === "pretty") {
         console.log();
-        printSuccess(`Skill written to ${chalk13.cyan(target)}`);
-        console.log(`  ${chalk13.gray(`${document.length} bytes, from ${apiUrl}${GUIDE_PATH}`)}`);
+        printSuccess(`Skill written to ${chalk14.cyan(target)}`);
+        console.log(`  ${chalk14.gray(`${document.length} bytes, from ${apiUrl}${GUIDE_PATH}`)}`);
         console.log();
       } else {
         outputResult(mode, {
@@ -3196,7 +3368,7 @@ function writeDocument(target, document) {
 }
 
 // src/index.ts
-var program = new Command21().name("anima").description(
+var program = new Command23().name("anima").description(
   `AgentGrid CLI \u2014 create, change, publish and share artifacts on AgentGrid.
 An artifact is a real git repository, and every command below runs one
 AgentGrid MCP tool for you. The command list is at the bottom; run
@@ -3206,6 +3378,7 @@ THE MAIN FLOW (build something and put it on AgentGrid):
   1. anima login                                   # once; a human approves
   2. anima create -t import --from ./my-project    # your code \u2192 a live app
      (or: create -t empty --framework html \u2014 an empty repo you push to)
+     (can create in several workspaces? add --workspace <id>; see "workspaces")
   3. Change it. Two doors, same git repository:
      - no clone: "explore" to read the files, "edit" to commit them. Needs no
        shell, no git binary and no network of its own \u2014 prefer it.
@@ -3249,8 +3422,10 @@ OUTPUT: pretty text in a terminal; a single JSON object on stdout when piped
 ).version(version, "-v, --version");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
+program.addCommand(workspacesCommand);
 program.addCommand(listCommand);
 program.addCommand(createCommand);
+program.addCommand(createKnowledgeCommand);
 program.addCommand(statusCommand);
 program.addCommand(exploreCommand);
 program.addCommand(editCommand);