@animaapp/cli 0.8.0 → 0.10.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 Command24 } 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();
@@ -2448,9 +2637,68 @@ function createDuplicateCommand() {
 }
 var duplicateCommand = createDuplicateCommand();
 
+// src/commands/move.ts
+import { Command as Command17 } from "commander";
+import chalk10 from "chalk";
+function buildMoveArgs(artifactUrl, workspaceId) {
+  const sessionId = parseArtifactUrl(artifactUrl);
+  if (!sessionId) {
+    throw validationError("An artifact URL or session ID is required");
+  }
+  const destination = workspaceFlag(workspaceId);
+  if (destination === void 0) {
+    throw validationError("--workspace is required; `anima workspaces` lists the ids you can use");
+  }
+  return { sessionId, workspaceId: destination };
+}
+function createMoveCommand() {
+  return new Command17("move").summary("File an artifact under a different workspace").description(
+    "Move an artifact into another workspace of the same team. The artifact stays as it is: same git repository, session ID, URL, history and live deployment, so there is no new link to send. What changes is who can reach it, since a private artifact is reached through the workspace it is filed in: a move hands it to the people who reach the destination and takes it from the rest, including whoever you already sent the link to. Needs write on the artifact and write in the destination. Moving an artifact where it already is leaves everything as it was."
+  ).argument("<artifactUrl>", "Artifact URL or session ID to move").option("-w, --workspace <id>", "The workspace to move it into (id from `anima workspaces`)").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 = buildMoveArgs(artifactUrl, opts.workspace);
+      const auth = await resolveAuth(opts.apiUrl);
+      progress.start("Moving artifact...");
+      const result = await withMcp(
+        { apiBaseUrl: resolveApiUrl(opts.apiUrl), token: auth.token, teamId: auth.teamId },
+        (client) => client.callTool("workspace-move_artifact", args)
+      );
+      if (!result.success) {
+        throw apiError(result.message || result.reason || result.error || "Could not move the artifact", result);
+      }
+      progress.succeed("Artifact moved");
+      if (mode === "pretty") {
+        console.log();
+        printSuccess(`Artifact moved to ${result.workspaceName}`);
+        printKeyValue("Session ID", result.sessionId);
+        printKeyValue("Workspace", `${result.workspaceName} (${result.workspaceId})`);
+        console.log(chalk10.gray("  The repository, URL and live deployment are unchanged."));
+        console.log();
+      } else {
+        outputResult(mode, result);
+      }
+    } catch (err) {
+      progress.fail("Failed");
+      if (err instanceof CliError) {
+        if (mode === "pretty") {
+          printError(err.message);
+        } else {
+          outputError(mode, { code: err.code, message: err.message });
+        }
+        process.exit(err.exitCode);
+      }
+      throw err;
+    }
+  });
+}
+var moveCommand = createMoveCommand();
+
 // src/commands/explore.ts
-import { Command as Command15 } from "commander";
-import chalk9 from "chalk";
+import { Command as Command18 } from "commander";
+import chalk11 from "chalk";
 
 // src/api/tool.ts
 async function runTool(toolName, args, options = {}) {
@@ -2476,25 +2724,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 Command18("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 +2798,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 ? chalk11.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(chalk11.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(`  ${chalk11.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(
+          chalk11.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(chalk11.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(chalk11.bold(`  ${file.path}`));
       if (file.asset) {
-        console.log(chalk9.gray(`    binary \u2014 ${file.size ?? "?"} bytes, ${file.mime ?? "unknown type"}`));
+        console.log(chalk11.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(chalk11.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(
+            chalk11.yellow(
               `    lines ${file.startLine}-${file.endLine} of ${file.totalLines} \u2014 read the rest with --range`
             )
           );
@@ -2612,33 +2843,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(chalk11.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(`  ${chalk11.yellow(commit.revision.slice(0, 10))}  ${commit.message.split("\n")[0]}`);
+      console.log(chalk11.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(chalk11.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(chalk11.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(chalk11.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 Command19 } 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 chalk12 from "chalk";
+var editCommand = new Command19("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 +2891,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(`  ${chalk12.gray(changed.op.padEnd(12))} ${detail}`);
       }
       console.log();
       printKeyValue("Revision", result.revision ?? "unknown");
@@ -2758,11 +2989,11 @@ function readFile(path7) {
 }
 
 // src/commands/uploadAsset.ts
-import { Command as Command17 } from "commander";
+import { Command as Command20 } 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 chalk13 from "chalk";
+var uploadAssetCommand = new Command20("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 +3030,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(
+          `    ${chalk13.cyan(
             `anima edit ${sessionId} -m "Add asset" --changes '[{"op":"write","path":"public/${path5.basename(file)}","assetUploadId":"${grant.assetUploadId}"}]'`
           )}`
         );
@@ -2876,8 +3107,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 Command21 } from "commander";
+var deleteCommand = new Command21("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 +3149,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 Command22 } from "commander";
+import chalk14 from "chalk";
+var listSubcommand = new Command22("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 +3166,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 Command22("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 +3185,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 Command22("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 +3204,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 Command22("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 +3221,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(`  ${chalk14.bold(`Review ${review.reviewId}`)} ${chalk14.gray(`by ${review.author.name}`)}`);
+    console.log(`    ${chalk14.cyan.underline(review.artifactUrl)}`);
     if (!review.isLatest) {
       console.log(
-        chalk12.yellow("    The artifact moved since this was written \u2014 check the comments still apply.")
+        chalk14.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" ? chalk14.gray(comment.status) : null,
+        comment.unassigned ? chalk14.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(`    ${chalk14.bold(`#${comment.index}`)} ${comment.body}${marks ? ` ${marks}` : ""}`);
+      console.log(chalk14.gray(`       ${comment.commentId}${describeAnchor(comment)}`));
       for (const reply of comment.replies ?? []) {
-        console.log(chalk12.gray(`       \u21B3 ${reply.author.name}: ${reply.body}`));
+        console.log(chalk14.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(`      ${chalk14.gray(line)}`);
     }
     console.log();
   }
@@ -3033,13 +3264,13 @@ function describeAnchor(comment) {
 }
 
 // src/commands/skill.ts
-import { Command as Command20 } from "commander";
+import { Command as Command23 } from "commander";
 import fs7 from "fs";
 import path6 from "path";
-import chalk13 from "chalk";
+import chalk15 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 Command23("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 +3297,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 ${chalk15.cyan(target)}`);
+        console.log(`  ${chalk15.gray(`${document.length} bytes, from ${apiUrl}${GUIDE_PATH}`)}`);
         console.log();
       } else {
         outputResult(mode, {
@@ -3196,7 +3427,7 @@ function writeDocument(target, document) {
 }
 
 // src/index.ts
-var program = new Command21().name("anima").description(
+var program = new Command24().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 +3437,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.
@@ -3241,6 +3473,7 @@ EXAMPLES:
   anima explore <sessionId> --search "buttonColor"
   anima edit <sessionId> -m "Blue pill" --replace src/App.tsx --old red --new blue
   anima review list                      # what humans asked you to change
+  anima move <sessionId> -w <workspaceId>  # re-file it; the URL is unchanged
   anima publish <sessionId>              # only on explicit request
 
 OUTPUT: pretty text in a terminal; a single JSON object on stdout when piped
@@ -3249,8 +3482,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);
@@ -3258,6 +3493,7 @@ program.addCommand(uploadAssetCommand);
 program.addCommand(getGitTokenCommand);
 program.addCommand(reviewCommand);
 program.addCommand(duplicateCommand);
+program.addCommand(moveCommand);
 program.addCommand(publishCommand);
 program.addCommand(unpublishCommand);
 program.addCommand(updateCommand);