airgate 0.1.4 → 0.1.6

package/README.md

@@ -4,7 +4,8 @@
 ⊠ airgate  give your AI its own computer
 ```
 
-A private cloud computer for Claude Code, Codex or any AI agent, ready in about two seconds. It
+A private cloud computer for Claude Code, Codex or any AI agent, ready in about two seconds, and
+crews of them that build, review and test one task together. It
 can't touch your laptop, keeps working when you close it, and every step can be undone.
 Always reachable, billed while working. [airgate.sh](https://airgate.sh)
 
@@ -28,6 +29,22 @@ airgate up        # move the session you're in to a pod; airgate down brings the
 airgate help      # every command
 ```
 
+## Crews
+
+Several agents, each in its own pod, on one task: they build, review, test and argue it out, and
+you get one patch back.
+
+```sh
+airgate crew contest "add sign-in with GitHub"   # one builds, another reviews until it holds
+airgate crew race "make search faster"           # several try it, a judge picks the best
+airgate crew council "pick a job queue" --build  # plans, critiques, a decision, then the build
+airgate crew squad "add CSV export"              # testers write tests and hunt bugs
+airgate crew split "add team billing"            # parts in parallel, then merged
+airgate crew down <id>                           # bring the result back here
+```
+
+Guide: https://airgate.sh/docs/crews
+
 ## For your agent
 
 Claude Code or Codex on your laptop can send work to pods on its own: one task in a fresh pod

package/dist/airgate.mjs

@@ -431,6 +431,7 @@ var Api = class {
       if (e?.name === "AbortError") throw e;
       throw new NetworkError(this.gateway, e);
     }
+    if (opts2.bytes && res.ok) return Buffer.from(await res.arrayBuffer());
     const text2 = await res.text();
     if (opts2.text && res.ok) return text2;
     let data = {};
@@ -530,11 +531,11 @@ var Api = class {
   checkpoint(id, label2) {
     return this.request("POST", `/v1/pods/${enc(id)}/checkpoints`, { body: { label: label2 } }).then((r) => r.pod);
   }
-  restore(id, checkpointId) {
-    return this.request("POST", `/v1/pods/${enc(id)}/restore`, { body: { checkpointId } }).then((r) => r.pod);
+  restore(id, checkpointId2) {
+    return this.request("POST", `/v1/pods/${enc(id)}/restore`, { body: { checkpointId: checkpointId2 } }).then((r) => r.pod);
   }
-  fork(id, checkpointId, overrides) {
-    return this.request("POST", `/v1/pods/${enc(id)}/fork`, { body: { checkpointId, overrides } }).then((r) => r.pod);
+  fork(id, checkpointId2, overrides) {
+    return this.request("POST", `/v1/pods/${enc(id)}/fork`, { body: { checkpointId: checkpointId2, overrides } }).then((r) => r.pod);
   }
   diff(id, base) {
     return this.request("GET", `/v1/pods/${enc(id)}/diff?base=${encodeURIComponent(base)}`);
@@ -580,6 +581,38 @@ var Api = class {
   githubDisconnect(id) {
     return this.request("DELETE", `/v1/github/installations/${id}`);
   }
+  /* a workspace's files, live or at a checkpoint */
+  files(id, path = "", checkpoint2) {
+    const q = new URLSearchParams({ path, ...checkpoint2 ? { checkpoint: checkpoint2 } : {} });
+    return this.request("GET", `/v1/pods/${enc(id)}/files?${q}`);
+  }
+  fileRaw(id, path, checkpoint2) {
+    const q = new URLSearchParams({ path, ...checkpoint2 ? { checkpoint: checkpoint2 } : {} });
+    return this.request("GET", `/v1/pods/${enc(id)}/files/raw?${q}`, { bytes: true });
+  }
+  /** after launch: the network and the AI switch */
+  updatePod(id, patch) {
+    return this.request("PATCH", `/v1/pods/${enc(id)}`, { body: patch }).then((r) => r.pod);
+  }
+  /* saved snapshots */
+  snapshots() {
+    return this.request("GET", "/v1/snapshots").then((r) => r.snapshots);
+  }
+  saveSnapshot(id, name, checkpointId2) {
+    return this.request("POST", `/v1/pods/${enc(id)}/snapshots`, { body: { name, ...checkpointId2 ? { checkpointId: checkpointId2 } : {} } }).then((r) => r.snapshot);
+  }
+  sharedSnapshot(code3) {
+    return this.request("GET", `/v1/snapshots/shared/${enc(code3)}`).then((r) => r.snapshot);
+  }
+  launchSnapshot(ref, overrides = {}) {
+    return this.request("POST", `/v1/snapshots/${enc(ref)}/launch`, { body: { overrides } }).then((r) => r.pod);
+  }
+  shareSnapshot(ref, on) {
+    return this.request(on ? "POST" : "DELETE", `/v1/snapshots/${enc(ref)}/share`).then((r) => r.snapshot);
+  }
+  deleteSnapshot(ref) {
+    return this.request("DELETE", `/v1/snapshots/${enc(ref)}`);
+  }
   /* model sign-ins: connected to airgate (opt-in), and whether a laptop relay is connected */
   modelsAuth() {
     return this.request("GET", "/v1/models/auth");
@@ -1951,7 +1984,7 @@ function borderOf(name, v) {
   return { chars: chars3, title, color, pad: pad3 };
 }
 function box(s2, { x, y, cols: w, rows: h }, chars3, title, color) {
-  const [tl, tr, bl, br, across2, down3] = Array.from(chars3, (ch) => ch.charCodeAt(0));
+  const [tl, tr, bl, br, across2, down4] = Array.from(chars3, (ch) => ch.charCodeAt(0));
   const set = (cx, cy, ch) => {
     const i = s2.index(cx, cy);
     if (i >= 0)
@@ -1960,7 +1993,7 @@ function box(s2, { x, y, cols: w, rows: h }, chars3, title, color) {
   for (let c = 1; c < w - 1; c++)
     set(x + c, y, across2), set(x + c, y + h - 1, across2);
   for (let r = 1; r < h - 1; r++)
-    set(x, y + r, down3), set(x + w - 1, y + r, down3);
+    set(x, y + r, down4), set(x + w - 1, y + r, down4);
   set(x, y, tl), set(x + w - 1, y, tr), set(x, y + h - 1, bl), set(x + w - 1, y + h - 1, br);
   if (title && w >= 7) {
     const room = w - 6;
@@ -2951,10 +2984,10 @@ function outline(src, options) {
               if (!line2(x, y))
                 continue;
               const up2 = line2(x, y - 1) && (is(solid, x - 1, y) || is(solid, x - 1, y - 1) || is(solid, x + 1, y) || is(solid, x + 1, y - 1));
-              const down3 = line2(x, y + 1) && (is(solid, x - 1, y) || is(solid, x - 1, y + 1) || is(solid, x + 1, y) || is(solid, x + 1, y + 1));
+              const down4 = line2(x, y + 1) && (is(solid, x - 1, y) || is(solid, x - 1, y + 1) || is(solid, x + 1, y) || is(solid, x + 1, y + 1));
               const left = line2(x - 1, y) && (is(solid, x, y - 1) || is(solid, x - 1, y - 1) || is(solid, x, y + 1) || is(solid, x - 1, y + 1));
               const right = line2(x + 1, y) && (is(solid, x, y - 1) || is(solid, x + 1, y - 1) || is(solid, x, y + 1) || is(solid, x + 1, y + 1));
-              const bits = (up2 ? 1 : 0) | (down3 ? 2 : 0) | (left ? 4 : 0) | (right ? 8 : 0);
+              const bits = (up2 ? 1 : 0) | (down4 ? 2 : 0) | (left ? 4 : 0) | (right ? 8 : 0);
               if (!bits)
                 continue;
               let c = ink;
@@ -2981,7 +3014,7 @@ function shadow(src, options) {
     fail2(`shadow.solid takes true or false, not ${show(o.solid)}`);
   const solid = o.solid ?? true;
   return build2("shadow", src, o, ({ meta: m, inks }) => {
-    const tone = color ? [inks.add(color), inks.add(color)] : m.palette ? [inks.add(QUIET2.dark), inks.add(QUIET2.light)] : [NONE, NONE];
+    const tone2 = color ? [inks.add(color), inks.add(color)] : m.palette ? [inks.add(QUIET2.dark), inks.add(QUIET2.light)] : [NONE, NONE];
     const cols = m.cols + Math.abs(dx), rows2 = m.rows + Math.abs(dy);
     const x0 = dx < 0 ? -dx : 0, y0 = dy < 0 ? -dy : 0;
     return {
@@ -2993,7 +3026,7 @@ function shadow(src, options) {
         const ink = new Uint8Array(cols * rows2), out = new Uint8Array(cols * rows2).fill(1), queue = new Int32Array(cols * rows2);
         const over2 = { mask: null };
         return (t, s2, g, ctx) => {
-          const c = tone[ctx.paper ? 1 : 0];
+          const c = tone2[ctx.paper ? 1 : 0];
           if (solid) {
             ink.fill(0);
             for (let y = 0, i = 0; y < g.rows; y++)
@@ -5724,9 +5757,9 @@ function colorOn(stream, env) {
 }
 var ANSI = /\u001b\[[0-9;]*m/g;
 var visibleWidth = (s2) => [...s2.replace(ANSI, "")].length;
-function paint2(on, tone, s2) {
+function paint2(on, tone2, s2) {
   if (!on) return s2;
-  const [a, b2] = CODES[tone];
+  const [a, b2] = CODES[tone2];
   return `\x1B[${a}m${s2}\x1B[${b2}m`;
 }
 function formatTable(rows2, head, indent = 0) {
@@ -5743,16 +5776,16 @@ function paintArt(on, a) {
     if (!on || !tones2) return line2.trimEnd();
     let out = "";
     let run2 = "";
-    let tone;
+    let tone2;
     const flush = () => {
-      if (run2) out += tone ? paint2(true, tone, run2) : run2;
+      if (run2) out += tone2 ? paint2(true, tone2, run2) : run2;
       run2 = "";
     };
     [...line2].forEach((ch, x) => {
-      const t = ch === " " ? tone : tones2[x];
-      if (t !== tone) {
+      const t = ch === " " ? tone2 : tones2[x];
+      if (t !== tone2) {
         flush();
-        tone = t;
+        tone2 = t;
       }
       run2 += ch;
     });
@@ -5767,8 +5800,8 @@ function createUi(io) {
     tty: Boolean(io.stdout.isTTY),
     out: (line2 = "") => void io.stdout.write(line2 + "\n"),
     err: (line2 = "") => void io.stderr.write(line2 + "\n"),
-    c: (tone, s2) => paint2(outColor, tone, s2),
-    ce: (tone, s2) => paint2(errColor, tone, s2),
+    c: (tone2, s2) => paint2(outColor, tone2, s2),
+    ce: (tone2, s2) => paint2(errColor, tone2, s2),
     json: (v) => void io.stdout.write(JSON.stringify(v, null, 2) + "\n"),
     table(rows2, opts2 = {}) {
       const head = opts2.head ? opts2.head.map((h) => paint2(outColor, "dim", h)) : void 0;
@@ -7301,6 +7334,7 @@ var launch = {
     'autopilot jobs: --cron "0 2 * * *" --task "update deps, run tests" (repeat both for more; --job-name names them). more later: airgate job add'
   ],
   flags: {
+    from: { type: "string", value: "snapshot", help: "start from a saved snapshot: its name, or a share code (airgate snapshots)" },
     name: { type: "string", value: "name" },
     template: { type: "string", value: "template", choices: TEMPLATE_IDS, help: `${TEMPLATE_IDS.join(" | ")} (default code)` },
     agent: { type: "string", value: "agent", choices: Object.keys(AGENTS), help: `${AGENT_NAMES.join(" | ")} (default: the template's first)` },
@@ -7323,6 +7357,18 @@ var launch = {
   },
   async run(ctx) {
     if (ctx.args.positionals.length) throw new UsageError(`unexpected "${ctx.args.positionals[0]}"`, "name the pod with --name");
+    const from = str(ctx.args, "from");
+    if (from) {
+      const o = {};
+      if (str(ctx.args, "name")) o.name = str(ctx.args, "name");
+      if (str(ctx.args, "agent")) o.agent = str(ctx.args, "agent");
+      if (ctx.args.flags.memory !== "standard") o.size = ctx.args.flags.memory;
+      if (ctx.args.flags.browser === true) o.browser = true;
+      const pod2 = await ctx.ui.spin(`starting a pod from ${from}`, async () => waitReady(ctx, await ctx.api.launchSnapshot(from, o)));
+      if (ctx.json) return ctx.ui.json(pod2);
+      ctx.ui.out(readyLine(ctx, pod2));
+      return void ctx.ui.out(`next: airgate attach ${pod2.spec.name}`);
+    }
     const spec = specFromFlags(ctx);
     if (spec.repo) await checkRepo(ctx, spec.repo);
     const envFile = str(ctx.args, "env");
@@ -7369,7 +7415,7 @@ function readDotenv(ctx, file) {
 }
 function specFromFlags(ctx, defaults = {}) {
   const a = ctx.args;
-  const network = str(a, "network") ?? "allowlist";
+  const network2 = str(a, "network") ?? "allowlist";
   const autoStop = str(a, "auto-stop");
   let autoStopMinutes = null;
   if (autoStop === "keep-awake" || autoStop === "never") autoStopMinutes = 0;
@@ -7408,12 +7454,12 @@ function specFromFlags(ctx, defaults = {}) {
     agent,
     size: str(a, "memory") ?? "standard",
     masking: a.flags.mask !== false,
-    network,
+    network: network2,
     autoStopMinutes,
     autoCheckpoint: a.flags.undo !== false
   };
   if (repo) spec.repo = repo;
-  if (network === "allowlist") spec.allow = [.../* @__PURE__ */ new Set([...DEFAULT_ALLOW, ...list(a, "allow").flatMap((h) => h.split(",")).map((h) => h.trim()).filter(Boolean)])];
+  if (network2 === "allowlist") spec.allow = [.../* @__PURE__ */ new Set([...DEFAULT_ALLOW, ...list(a, "allow").flatMap((h) => h.split(",")).map((h) => h.trim()).filter(Boolean)])];
   const terms = list(a, "mask-term");
   if (terms.length) spec.maskTerms = terms;
   if (template !== "code") spec.template = template;
@@ -7497,7 +7543,10 @@ var destroy = {
   flags: { yes: { type: "boolean", short: "y", help: "don't ask" } },
   async run(ctx) {
     const p = await resolvePod(ctx, ctx.args.positionals[0]);
-    if (!await confirm(ctx, `destroy ${p.spec.name} (${p.id})? its files and checkpoints are gone for good.`)) {
+    const pending = await ctx.api.diff(p.id, "up").catch(() => null);
+    const unpulled = pending?.files.length ?? 0;
+    if (unpulled && !ctx.json) ctx.ui.err(ctx.ui.ce("warn", `${p.spec.name} has ${unpulled} changed file(s) not brought back. keep them first: airgate down --pod ${p.spec.name} (or save it: airgate snapshot ${p.spec.name} <name>)`));
+    if (!await confirm(ctx, `destroy ${p.spec.name} (${p.id})? its files and checkpoints are gone for good${unpulled ? `, including ${unpulled} changed file(s)` : ""}.`)) {
       throw new CliError("not destroyed");
     }
     await ctx.ui.spin(`destroying ${p.spec.name}`, ctx.api.destroy(p.id));
@@ -7728,7 +7777,7 @@ var log = {
 import { createInterface } from "node:readline";
 
 // src/version.ts
-var VERSION = "0.1.4";
+var VERSION = "0.1.6";
 
 // src/commands/updown.ts
 import { appendFileSync, existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync5, realpathSync as realpathSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "node:fs";
@@ -7780,7 +7829,7 @@ function gitFiles(dir) {
   return out;
 }
 function runTar(cwd, args, input, limit = UPLOAD_LIMIT) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve8, reject) => {
     const child = spawn("tar", args, { cwd, env: { ...process.env, COPYFILE_DISABLE: "1" }, stdio: ["pipe", "pipe", "pipe"] });
     const chunks = [];
     let size2 = 0;
@@ -7800,7 +7849,7 @@ function runTar(cwd, args, input, limit = UPLOAD_LIMIT) {
     child.on("close", (code3) => {
       if (over2) return reject(new TooLargeError(limit));
       if (code3 !== 0) return reject(new Error(`tar failed: ${err.trim().split("\n").slice(-3).join(" ")}`));
-      resolve6(Buffer.concat(chunks));
+      resolve8(Buffer.concat(chunks));
     });
     child.stdin.on("error", () => void 0);
     child.stdin.end(input ?? "");
@@ -7811,10 +7860,10 @@ async function packProject(dir, limit = UPLOAD_LIMIT) {
     const tracked = new Set(git(dir, ["ls-files", "-c", "-z"]).stdout.split("\0"));
     const all = gitFiles(dir).filter((f) => !f.startsWith(".airgate/"));
     const skipped2 = all.filter((f) => (isEnvFile(f) || f.split("/").pop() === ".envrc") && !tracked.has(f));
-    const files = all.filter((f) => !skipped2.includes(f));
-    if (!files.length) throw new Error("no files to send (git sees nothing tracked or untracked here)");
-    const archive2 = await runTar(dir, ["--null", "-T", "-", "-czf", "-"], files.join("\0") + "\0", limit);
-    return { archive: archive2, files: files.length, git: true, skipped: skipped2 };
+    const files2 = all.filter((f) => !skipped2.includes(f));
+    if (!files2.length) throw new Error("no files to send (git sees nothing tracked or untracked here)");
+    const archive2 = await runTar(dir, ["--null", "-T", "-", "-czf", "-"], files2.join("\0") + "\0", limit);
+    return { archive: archive2, files: files2.length, git: true, skipped: skipped2 };
   }
   const skipped = readdirSync(dir).filter((f) => isEnvFile(f) || f === ".envrc");
   const archive = await runTar(dir, ["--exclude=node_modules", "--exclude=.git", "--exclude=.airgate", ...ENV_EXCLUDES, "-czf", "-", "."], null, limit);
@@ -7895,7 +7944,7 @@ function firstLine(file) {
   }
 }
 function codexRollouts(root, limit = 3e3) {
-  const files = [];
+  const files2 = [];
   const walk = (d, depth) => {
     let list2 = [];
     try {
@@ -7906,11 +7955,11 @@ function codexRollouts(root, limit = 3e3) {
     for (const x of list2) {
       const full = join3(d, x.name);
       if (x.isDirectory() && depth < 4) walk(full, depth + 1);
-      else if (x.isFile() && /^rollout-.*\.jsonl$/.test(x.name)) files.push({ f: full, m: statSync(full).mtimeMs });
+      else if (x.isFile() && /^rollout-.*\.jsonl$/.test(x.name)) files2.push({ f: full, m: statSync(full).mtimeMs });
     }
   };
   walk(join3(root, "sessions"), 0);
-  return files.sort((a, b2) => b2.m - a.m).slice(0, limit).map((x) => x.f);
+  return files2.sort((a, b2) => b2.m - a.m).slice(0, limit).map((x) => x.f);
 }
 var codexId = (file) => /([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl$/.exec(file)?.[1] ?? null;
 function findCodexSession(home, projectDir, id, env = {}) {
@@ -8161,8 +8210,8 @@ function rewritePaths(text2, pre) {
   }
   return lines.join("\n");
 }
-function orderFiles(files) {
-  return [...files.filter((f) => f.risky), ...files.filter((f) => !f.risky)];
+function orderFiles(files2) {
+  return [...files2.filter((f) => f.risky), ...files2.filter((f) => !f.risky)];
 }
 function refusals(blocks) {
   const out = [];
@@ -8416,9 +8465,9 @@ function printSessions(ctx, list2) {
 function printFiles(ctx, blocks, toErr) {
   const line2 = toErr ? ctx.ui.err : ctx.ui.out;
   const c = toErr ? ctx.ui.ce : ctx.ui.c;
-  const files = orderFiles(blocks.map((b2) => b2.file));
-  const width = Math.max(...files.map((f) => f.path.length + (f.from ? f.from.length + 4 : 0)));
-  for (const f of files) {
+  const files2 = orderFiles(blocks.map((b2) => b2.file));
+  const width = Math.max(...files2.map((f) => f.path.length + (f.from ? f.from.length + 4 : 0)));
+  for (const f of files2) {
     const name = f.from ? `${f.from} \u2192 ${f.path}` : f.path;
     const mark = f.risky ? c("warn", "!") : " ";
     line2(`  ${mark} ${STATUS_MARK[f.status]} ${f.risky ? name.padEnd(width) + "  " + c("warn", f.reason ?? "") : name}`.trimEnd());
@@ -8469,9 +8518,9 @@ var down2 = {
     const { blocks, outside } = selectProject(parsePatch(d.patch), prefix);
     const refused = refusals(blocks);
     const patch = blocks.map((b2) => b2.text).join("");
-    const files = orderFiles(blocks.map((b2) => b2.file));
+    const files2 = orderFiles(blocks.map((b2) => b2.file));
     if (ctx.json && (dry || !blocks.length)) {
-      return ui2.json({ pod: pod.id, base, files, outside, refused, patch, applied: false });
+      return ui2.json({ pod: pod.id, base, files: files2, outside, refused, patch, applied: false });
     }
     const takeSessions = !dry && !bool(ctx.args, "no-session") && found?.state.podId === pod.id;
     if (!blocks.length) {
@@ -8480,8 +8529,8 @@ var down2 = {
       if (takeSessions && found) await downSessions(ctx, found.root, found.state, pod);
       return;
     }
-    const risky = files.filter((f) => f.risky).length;
-    const head = `${files.length} file(s) from ${pod.spec.name}${risky ? `, ${risky} risky` : ""}:`;
+    const risky = files2.filter((f) => f.risky).length;
+    const head = `${files2.length} file(s) from ${pod.spec.name}${risky ? `, ${risky} risky` : ""}:`;
     if (dry) {
       ui2.err(head);
       printFiles(ctx, blocks, true);
@@ -8516,7 +8565,7 @@ var down2 = {
       throw new CliError(`the patch doesn't apply here, nothing changed:
 ${check.stderr.trim()}`, "commit or stash local edits to those files, or look with: airgate down --dry-run");
     }
-    if (!await confirm(ctx, `apply ${files.length} file(s)${risky ? ` (${risky} risky)` : ""}?`)) throw new CliError("nothing applied");
+    if (!await confirm(ctx, `apply ${files2.length} file(s)${risky ? ` (${risky} risky)` : ""}?`)) throw new CliError("nothing applied");
     const applied = git(top, ["apply", ...applyArgs], patch);
     if (applied.status !== 0) throw new CliError(`git apply failed: ${applied.stderr.trim()}`);
     let acked = true;
@@ -8526,8 +8575,8 @@ ${check.stderr.trim()}`, "commit or stash local edits to those files, or look wi
       acked = false;
     }
     const convo = takeSessions && found ? await downSessions(ctx, found.root, found.state, pod, true) : [];
-    if (ctx.json) return ui2.json({ pod: pod.id, base, files, outside, refused, applied: true, acked, sessions: convo });
-    ui2.out(`${ui2.c("ok", "down")}: applied ${files.length} file(s). review: git status \xB7 git diff`);
+    if (ctx.json) return ui2.json({ pod: pod.id, base, files: files2, outside, refused, applied: true, acked, sessions: convo });
+    ui2.out(`${ui2.c("ok", "down")}: applied ${files2.length} file(s). review: git status \xB7 git diff`);
     if (!acked) ui2.err(ui2.ce("warn", "couldn't tell the pod what was taken; the next down will show these again"));
     printSessions(ctx, convo);
   }
@@ -8588,7 +8637,7 @@ var LineReader = class {
   }
 };
 function ttyPrompt(stdin, out) {
-  return (question, opts2 = {}) => new Promise((resolve6, reject) => {
+  return (question, opts2 = {}) => new Promise((resolve8, reject) => {
     out.write(question);
     const decoder = new StringDecoder2("utf8");
     let answer = "";
@@ -8601,7 +8650,7 @@ function ttyPrompt(stdin, out) {
       stdin.pause();
       out.write("\n");
       if (err) reject(err);
-      else resolve6(answer);
+      else resolve8(answer);
     };
     const onData = (d) => {
       for (const ch of decoder.write(d)) {
@@ -8628,16 +8677,16 @@ function ttyPrompt(stdin, out) {
 }
 function openInBrowser(url) {
   const [cmd, args] = process.platform === "darwin" ? ["open", [url]] : process.platform === "win32" ? ["cmd", ["/c", "start", '""', url]] : ["xdg-open", [url]];
-  return new Promise((resolve6) => {
+  return new Promise((resolve8) => {
     try {
       const child = spawn2(cmd, args, { stdio: "ignore", detached: true });
-      child.on("error", () => resolve6(false));
+      child.on("error", () => resolve8(false));
       child.on("spawn", () => {
         child.unref();
-        resolve6(true);
+        resolve8(true);
       });
     } catch {
-      resolve6(false);
+      resolve8(false);
     }
   });
 }
@@ -9213,26 +9262,257 @@ When you are done, leave your changes in the files there (no need to commit or p
         ui2.err(ui2.ce("bad", keepNote(`the task finished, but its changes didn't come back: ${why}`)));
         return 1;
       }
-      const files = result.files ?? [];
+      const files2 = result.files ?? [];
       const keep = noApply || bool(ctx.args, "keep");
       await finish(ctx, pod, keep ? "sleep" : "destroy");
       if (!keep) restoreState();
-      if (ctx.json) return out({ applied: !noApply && files.length > 0, files, ...noApply ? { patch: result.patch ?? "" } : {}, pod_state: keep ? "sleeping" : "deleted" });
+      if (ctx.json) return out({ applied: !noApply && files2.length > 0, files: files2, ...noApply ? { patch: result.patch ?? "" } : {}, pod_state: keep ? "sleeping" : "deleted" });
       ctx.io.stdout.write(r.log.endsWith("\n") || !r.log ? r.log : r.log + "\n");
       if (noApply) {
         ctx.io.stdout.write(result.patch ?? "");
-        ui2.err(`${files.length} file(s) changed, not applied. apply: airgate down --pod ${name} \xB7 delete the pod: airgate destroy ${name}`);
+        ui2.err(`${files2.length} file(s) changed, not applied. apply: airgate down --pod ${name} \xB7 delete the pod: airgate destroy ${name}`);
         return 0;
       }
-      const risky = files.filter((f) => f.risky).length;
+      const risky = files2.filter((f) => f.risky).length;
       ui2.out(
-        `${ui2.c("ok", "done")}: ${files.length ? `${files.length} file(s) changed here${risky ? `, ${risky} risky` : ""}. review: git status \xB7 git diff` : "no changes came back"}` + (keep ? ` \xB7 the pod is kept (asleep): ${name}` : " \xB7 the pod is deleted")
+        `${ui2.c("ok", "done")}: ${files2.length ? `${files2.length} file(s) changed here${risky ? `, ${risky} risky` : ""}. review: git status \xB7 git diff` : "no changes came back"}` + (keep ? ` \xB7 the pod is kept (asleep): ${name}` : " \xB7 the pod is deleted")
       );
       return 0;
     }
   }
 };
 
+// src/commands/crews.ts
+import { existsSync as existsSync6, readFileSync as readFileSync9, realpathSync as realpathSync3, rmSync as rmSync5, statSync as statSync4, writeFileSync as writeFileSync6 } from "node:fs";
+import { relative as relative3, resolve as resolve6 } from "node:path";
+var KINDS = ["race", "contest", "council", "squad", "split"];
+var ACTIONS = ["show", "say", "stop", "down", "rm", "list"];
+var AGENT_ALIAS = { claude: "claude-code", "claude-code": "claude-code", codex: "codex", opencode: "opencode", pi: "pi" };
+function membersFrom(values) {
+  const items = values.flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
+  if (!items.length) return void 0;
+  return items.map((it) => {
+    const m = /^([a-z][a-z0-9-]*)=([a-z-]+)(?::(.+))?$/.exec(it);
+    if (!m) throw new UsageError(`--as ${it}: role=agent, e.g. reviewer=codex or worker-2=opencode:qwen/qwen3-coder`);
+    const agent = AGENT_ALIAS[m[2]];
+    if (!agent) throw new UsageError(`--as ${it}: the agent is one of claude, codex, opencode, pi`);
+    return { role: m[1], agent, ...m[3] ? { model: m[3] } : {} };
+  });
+}
+var tone = (ctx, state) => state === "done" ? ctx.ui.c("ok", state) : state === "failed" ? ctx.ui.c("bad", state) : state === "stopped" ? ctx.ui.c("dim", state) : ctx.ui.c("warn", state);
+function printRoom(ctx, messages) {
+  for (const m of messages) {
+    const who = m.author === "airgate" ? ctx.ui.c("dim", "airgate") : m.author === "you" ? ctx.ui.c("warn", "you") : m.author;
+    const lines = m.text.split("\n");
+    ctx.ui.out(`${who}: ${lines[0]}`);
+    for (const l of lines.slice(1, 12)) ctx.ui.out(`  ${l}`);
+    if (lines.length > 12) ctx.ui.out(ctx.ui.c("dim", `  \u2026 (${lines.length - 12} more lines: airgate crew show)`));
+  }
+}
+async function follow(ctx, id) {
+  let since = 0;
+  const controller = new AbortController();
+  const stop = () => controller.abort();
+  ctx.io.signals.on("SIGINT", stop);
+  ctx.io.signal?.addEventListener("abort", stop);
+  try {
+    for (; ; ) {
+      const r = await ctx.api.request("GET", `/v1/crews/${encodeURIComponent(id)}/messages?since=${since}`);
+      printRoom(ctx, r.messages);
+      if (r.messages.length) since = r.messages[r.messages.length - 1].id;
+      if (["done", "failed", "stopped"].includes(r.state)) break;
+      if (controller.signal.aborted) {
+        ctx.ui.err(ctx.ui.ce("dim", `stopped following; the crew goes on. follow again: airgate crew show ${id} --follow \xB7 stop it: airgate crew stop ${id}`));
+        break;
+      }
+      await new Promise((res) => setTimeout(res, Number(ctx.io.env.AIRGATE_CREW_POLL_MS) || 2e3));
+    }
+  } finally {
+    ctx.io.signals.off("SIGINT", stop);
+    ctx.io.signal?.removeEventListener("abort", stop);
+  }
+  return (await ctx.api.request("GET", `/v1/crews/${encodeURIComponent(id)}`)).crew;
+}
+function printResult(ctx, c) {
+  if (c.state === "failed") return void ctx.ui.err(ctx.ui.ce("bad", `failed: ${c.error ?? "unknown"}. its pods are asleep with their work: airgate pods`));
+  if (!c.result) return;
+  ctx.ui.out();
+  ctx.ui.out(`${tone(ctx, c.state)}: ${c.result.summary ?? ""}`);
+  if (c.result.files?.length) ctx.ui.out(ctx.ui.c("dim", `${c.result.files.length} file(s): ${c.result.files.slice(0, 8).join(", ")}${c.result.files.length > 8 ? "\u2026" : ""}`));
+  if (c.result.hasPatch) ctx.ui.out(`bring it back here: airgate crew down ${c.id}`);
+}
+async function down3(ctx, id) {
+  const r = await ctx.api.request("GET", `/v1/crews/${encodeURIComponent(id)}/result`);
+  const { blocks, outside } = selectProject(parsePatch(r.patch), r.dir);
+  const refused = refusals(blocks);
+  const patch = blocks.map((b2) => b2.text).join("");
+  const files2 = orderFiles(blocks.map((b2) => b2.file));
+  if (bool(ctx.args, "dry-run")) {
+    if (ctx.json) return ctx.ui.json({ files: files2, outside, refused, patch });
+    return void ctx.io.stdout.write(patch);
+  }
+  if (refused.length) throw new CliError(`refused: ${refused.map((x) => `${x.path} (${x.why})`).join(", ")}`, `nothing applied. look: airgate crew down ${id} --dry-run`);
+  if (!blocks.length) return void ctx.ui.out("nothing to apply.");
+  const top = gitTopLevel(ctx.io.cwd);
+  if (!top) throw new CliError("crew down needs a git repo here", "git init && git add -A && git commit -m base");
+  const rel = relative3(realpathSync3(top), realpathSync3(ctx.io.cwd));
+  const args = ["--whitespace=nowarn", ...rel ? [`--directory=${rel}`] : [], "-"];
+  const check = git(top, ["apply", "--check", ...args], patch);
+  if (check.status !== 0) throw new CliError(`the patch doesn't apply here, nothing changed:
+${check.stderr.trim()}`, "commit or stash local edits to those files first");
+  const risky = files2.filter((f) => f.risky).length;
+  if (!ctx.json) for (const f of files2) ctx.ui.out(`  ${f.risky ? ctx.ui.c("warn", "!") : " "} ${f.path}${f.risky ? ctx.ui.c("warn", `  ${f.reason ?? ""}`) : ""}`);
+  if (!await confirm(ctx, `apply ${files2.length} file(s)${risky ? ` (${risky} risky)` : ""}?`)) throw new CliError("nothing applied");
+  const applied = git(top, ["apply", ...args], patch);
+  if (applied.status !== 0) throw new CliError(`git apply failed: ${applied.stderr.trim()}`);
+  if (ctx.json) return ctx.ui.json({ applied: true, files: files2 });
+  ctx.ui.out(`${ctx.ui.c("ok", "applied")} ${files2.length} file(s) from the crew. review: git status \xB7 git diff`);
+}
+var crew = {
+  name: "crew",
+  aliases: ["crews"],
+  group: "pods",
+  usage: '<race|contest|council|squad|split> "<task>" [dir] [--pod p | --from snapshot | --repo owner/name] [--as role=agent] \u2026 | show|say|stop|down|rm <id>',
+  summary: "several agents, each in its own pod, on one task: race, contest, council, squad, split",
+  example: 'airgate crew contest "add OAuth with GitHub"',
+  notes: [
+    "race: builders try the same task, a judge tests each and picks one. contest: a builder builds, a reviewer reviews and tries to break it, until it holds. council: members propose plans and critique each other, a chair decides (--build to build it). squad: a builder builds, testers write tests and hunt bugs, the builder fixes. split: a planner splits the work, workers build the parts, an integrator merges.",
+    "starting point: this folder (sent up to a pod made for the crew, deleted after), --pod (an existing pod), --from (a snapshot) or --repo. members fork from it; each has its own pod.",
+    "--as role=agent[:model] picks a member's agent: --as reviewer=codex --as builder-3=opencode:qwen/qwen3-coder (opencode with a model id uses airgate's built-in models).",
+    "airgate runs the crew, so it keeps going with this laptop closed. this command follows the room until it ends (--detach to return at once). while it follows, this laptop signs the members' model calls if it has a sign-in (airgate models).",
+    "the result is one patch: airgate crew down <id> applies it here like airgate down. --pr opens a pull request instead (it waits in your airlock; needs --repo or a pod with a repo)."
+  ],
+  flags: {
+    pod: { type: "string", value: "pod", help: "start from this pod (its workspace)" },
+    from: { type: "string", value: "snapshot", help: "start from a saved snapshot (name or share code)" },
+    repo: { type: "string", value: "owner/name", help: "start from a GitHub repo" },
+    as: { type: "list", value: "role=agent", help: "a member's agent, e.g. reviewer=codex (repeatable)" },
+    rounds: { type: "string", value: "n", help: "contest / squad rounds (1\u20135)" },
+    minutes: { type: "string", value: "n", help: "time limit for the whole crew (default 60)" },
+    build: { type: "boolean", help: "council: also build the decision" },
+    pr: { type: "boolean", help: "open a pull request with the result (it waits in your airlock)" },
+    delete: { type: "boolean", help: "delete member pods afterwards (default: they sleep)" },
+    detach: { type: "boolean", short: "d", help: "start it and return; don't follow the room" },
+    follow: { type: "boolean", short: "f", help: "show: keep following the room" },
+    "dry-run": { type: "boolean", short: "n", help: "down: print the patch, change nothing" },
+    yes: { type: "boolean", short: "y", help: "don't ask" }
+  },
+  async run(ctx) {
+    const { ui: ui2 } = ctx;
+    const [first, second, third, extra] = ctx.args.positionals;
+    if (!first || first === "list") {
+      const list2 = (await ctx.api.request("GET", "/v1/crews")).crews;
+      if (ctx.json) return ui2.json(list2);
+      if (!list2.length) return void ui2.out(ui2.c("dim", 'no crews yet. start one: airgate crew contest "<task>" (in a project folder)'));
+      ui2.table(
+        list2.map((c2) => [c2.id, c2.recipe, tone(ctx, c2.state), c2.task.length > 48 ? `${c2.task.slice(0, 47)}\u2026` : c2.task]),
+        { head: ["crew", "recipe", "", "task"] }
+      );
+      return;
+    }
+    if (ACTIONS.includes(first)) {
+      if (!second) throw new UsageError(`airgate crew ${first} <id>`);
+      const id = second;
+      if (first === "show") {
+        if (bool(ctx.args, "follow") && !ctx.json) return void printResult(ctx, await follow(ctx, id));
+        const c2 = (await ctx.api.request("GET", `/v1/crews/${encodeURIComponent(id)}`)).crew;
+        if (ctx.json) return ui2.json(c2);
+        ui2.out(`${c2.id} \xB7 ${c2.recipe} \xB7 ${tone(ctx, c2.state)}${c2.step && !["done", "failed", "stopped"].includes(c2.state) ? ` \xB7 ${c2.step}` : ""}`);
+        ui2.out(`task: ${c2.task}`);
+        ui2.table(c2.members.map((m) => [m.role, AGENTS[m.agent]?.label ?? m.agent, m.pod ? `${m.pod.name} (${m.pod.state})` : ui2.c("dim", "not started")]), { head: ["member", "agent", "pod"] });
+        ui2.out();
+        printRoom(ctx, c2.messages ?? []);
+        return void printResult(ctx, c2);
+      }
+      if (first === "say") {
+        const text2 = [third, extra].filter(Boolean).join(" ").trim();
+        if (!text2) throw new UsageError('airgate crew say <id> "what the crew should know"');
+        await ctx.api.request("POST", `/v1/crews/${encodeURIComponent(id)}/messages`, { body: { text: text2 } });
+        return ctx.json ? ui2.json({ ok: true }) : void ui2.out("said to the crew. members read the room between steps.");
+      }
+      if (first === "stop") {
+        const c2 = (await ctx.api.request("POST", `/v1/crews/${encodeURIComponent(id)}/stop`)).crew;
+        return ctx.json ? ui2.json(c2) : void ui2.out(`stopping ${c2.id} at its next step; its pods go to sleep with their work.`);
+      }
+      if (first === "down") return down3(ctx, id);
+      if (first === "rm") {
+        if (!await confirm(ctx, `delete crew ${id} and its member pods?`)) throw new CliError("nothing deleted");
+        await ctx.api.request("DELETE", `/v1/crews/${encodeURIComponent(id)}`);
+        return ctx.json ? ui2.json({ ok: true }) : void ui2.out(`deleted ${id}.`);
+      }
+    }
+    if (!KINDS.includes(first)) throw new UsageError(`"${first}" isn't a recipe or an action`, `recipes: ${KINDS.join(", ")} \xB7 actions: ${ACTIONS.join(", ")}`);
+    const kind = first;
+    const task2 = (second ?? "").trim();
+    if (!task2) throw new UsageError(`what should the crew do? airgate crew ${kind} "<task>"`);
+    if (extra) throw new UsageError(`unexpected "${extra}" (put the task in quotes)`);
+    const sources = ["pod", "from", "repo"].filter((k) => str(ctx.args, k));
+    if (sources.length > 1) throw new UsageError("one starting point: --pod, --from or --repo");
+    if (sources.length && third) throw new UsageError("a folder or --pod / --from / --repo, not both");
+    let basePodId;
+    let dir = "";
+    let temporaryBase = false;
+    let restoreState = null;
+    if (str(ctx.args, "pod")) basePodId = (await resolvePod(ctx, str(ctx.args, "pod"))).id;
+    else if (str(ctx.args, "from")) {
+      const p = await ui2.spin("starting the base pod from the snapshot", async () => waitReady(ctx, await ctx.api.launchSnapshot(str(ctx.args, "from"), { name: `crew-base-${Date.now().toString(36).slice(-4)}` })));
+      basePodId = p.id;
+      temporaryBase = true;
+    } else if (str(ctx.args, "repo")) {
+      const repo = str(ctx.args, "repo");
+      const look = await ctx.api.inspectRepo(repo).catch((e) => e instanceof ApiError && e.status === 404 ? null : Promise.reject(e));
+      if (look && !look.reachable) throw new CliError(`airgate can't reach ${look.repo} (private, and not shared with Airgate)`, "connect GitHub: airgate github connect, or start from a local clone instead");
+      const spec = { name: `crew-base-${Date.now().toString(36).slice(-4)}`, agent: "claude-code", size: "standard", repo: look?.repo ?? repo, masking: true, network: "allowlist", allow: DEFAULT_ALLOW, autoStopMinutes: null, autoCheckpoint: false };
+      basePodId = (await ui2.spin(`starting the base pod on ${spec.repo}`, async () => waitReady(ctx, await ctx.api.launch(spec)))).id;
+      temporaryBase = true;
+    } else {
+      const projectDir = resolve6(ctx.io.cwd, third ?? ".");
+      if (!existsSync6(projectDir) || !statSync4(projectDir).isDirectory()) throw new CliError(`no directory ${projectDir}`);
+      const sp = statePath(projectDir);
+      const before = existsSync6(sp) ? readFileSync9(sp, "utf8") : null;
+      restoreState = () => {
+        try {
+          if (before !== null) writeFileSync6(sp, before);
+          else rmSync5(sp, { force: true });
+        } catch {
+        }
+      };
+      const sent = await ui2.spin(`sending ${podDirName(projectDir)} up for the crew`, runCommand(ctx, up, [projectDir, "--name", `crew-base-${Date.now().toString(36).slice(-4)}`, "--no-session", "--yes"], ctx.io.cwd));
+      restoreState();
+      basePodId = sent.pod.id;
+      dir = sent.dir;
+      temporaryBase = true;
+    }
+    const body = { kind, task: task2, basePodId, dir, temporaryBase, keep: bool(ctx.args, "delete") ? "delete" : "sleep", build: bool(ctx.args, "build"), pr: bool(ctx.args, "pr") };
+    const members = membersFrom(ctx.args.flags.as ?? []);
+    if (members) body.members = members;
+    if (str(ctx.args, "rounds")) body.rounds = Number(str(ctx.args, "rounds"));
+    if (str(ctx.args, "minutes")) body.maxMinutes = Number(str(ctx.args, "minutes"));
+    let c;
+    try {
+      c = (await ctx.api.request("POST", "/v1/crews", { body })).crew;
+    } catch (e) {
+      if (temporaryBase) await ctx.api.destroy(basePodId).catch(() => void 0);
+      throw e;
+    }
+    if (ctx.json || bool(ctx.args, "detach")) {
+      if (ctx.json) return ui2.json(c);
+      ui2.out(`${ui2.c("ok", "started")} ${c.id} (${c.recipe}): ${c.members.map((m) => `${m.role} ${AGENTS[m.agent]?.label ?? m.agent}`).join(" \xB7 ")}`);
+      return void ui2.out(ui2.c("dim", `follow it: airgate crew show ${c.id} --follow \xB7 in the app: airgate.sh/app/crews`));
+    }
+    ui2.out(`${c.id} \xB7 ${c.recipe} \xB7 ${c.members.map((m) => `${m.role} ${AGENTS[m.agent]?.label ?? m.agent}`).join(" \xB7 ")}`);
+    ui2.out(ui2.c("dim", `following the room (ctrl-c stops following; the crew goes on). in the app: airgate.sh/app/crews`));
+    const relayer = relayIfSignedIn(ctx);
+    try {
+      const end = await follow(ctx, c.id);
+      printResult(ctx, end);
+      return end.state === "failed" ? 1 : 0;
+    } finally {
+      relayer?.stop();
+    }
+  }
+};
+
 // src/commands/mcp.ts
 var PROTOCOL_VERSION = "2025-06-18";
 var obj = (properties, required = []) => ({ type: "object", properties, required, additionalProperties: false });
@@ -9287,9 +9567,19 @@ var TOOLS = [
       model: s("built-in model: an OpenRouter id, e.g. qwen/qwen3-coder"),
       repo: s("GitHub repo to clone, owner/name"),
       browser: b("add Chromium + Playwright the agent can drive"),
-      jobs: { type: "array", items: jobSchema, description: "autopilot: scheduled jobs" }
+      jobs: { type: "array", items: jobSchema, description: "autopilot: scheduled jobs" },
+      fromSnapshot: s("start from a saved snapshot (its name, or a share code): its workspace and settings")
     }),
     async call(ctx, a) {
+      if (typeof a.fromSnapshot === "string" && a.fromSnapshot) {
+        const o = {};
+        if (typeof a.name === "string" && a.name) o.name = a.name;
+        if (typeof a.agent === "string" && a.agent) o.agent = a.agent;
+        if (a.browser === true) o.browser = true;
+        const pod2 = await waitReady(ctx, await ctx.api.launchSnapshot(a.fromSnapshot, o));
+        OWN.set(pod2.id, "launch");
+        return { name: pod2.spec.name, id: pod2.id, state: pod2.state, spec: pod2.spec };
+      }
       const argv = [];
       const opt = (flag, v) => typeof v === "string" && v && argv.push(`--${flag}`, v);
       opt("name", a.name);
@@ -9520,6 +9810,130 @@ var TOOLS = [
       return { deleted: p.spec.name, id: p.id };
     }
   },
+  {
+    name: "pod_files",
+    description: "List a folder of a pod's workspace (path relative to ~/workspace; '' for the top), live or at a checkpoint. Looking at a checkpoint never rewinds the pod.",
+    inputSchema: obj({ pod: POD, path: s("folder inside the workspace (default: the top)"), checkpoint: s("a checkpoint id or label (default: the live workspace)") }, ["pod"]),
+    async call(ctx, a) {
+      const p = await resolvePod(ctx, need(a, "pod"));
+      const cp = typeof a.checkpoint === "string" && a.checkpoint ? resolveCheckpoint(await ctx.api.checkpoints(p.id), a.checkpoint).id : void 0;
+      return ctx.api.files(p.id, typeof a.path === "string" ? a.path : "", cp);
+    }
+  },
+  {
+    name: "pod_file_read",
+    description: "Read one file of a pod's workspace, live or at a checkpoint (e.g. to compare with how it was before). Text up to 256 KB comes back as text; anything else as base64.",
+    inputSchema: obj({ pod: POD, path: s("file inside the workspace"), checkpoint: s("a checkpoint id or label (default: live)") }, ["pod", "path"]),
+    async call(ctx, a) {
+      const p = await resolvePod(ctx, need(a, "pod"));
+      const cp = typeof a.checkpoint === "string" && a.checkpoint ? resolveCheckpoint(await ctx.api.checkpoints(p.id), a.checkpoint).id : void 0;
+      const body = await ctx.api.fileRaw(p.id, need(a, "path"), cp);
+      const text2 = body.toString("utf8");
+      if (body.length <= 256 * 1024 && !text2.includes("\uFFFD") && !body.includes(0)) return { path: a.path, bytes: body.length, text: text2 };
+      return { path: a.path, bytes: body.length, base64: body.length <= 2 * 1024 * 1024 ? body.toString("base64") : void 0, note: body.length > 2 * 1024 * 1024 ? "too big to return here: airgate pull" : void 0 };
+    }
+  },
+  {
+    name: "snapshot_save",
+    description: "Save a pod's workspace (live, or at a checkpoint) as a named snapshot new pods can start from (pod_launch with fromSnapshot). Only files: never secrets, conversations or the masking vault.",
+    inputSchema: obj({ pod: POD, name: s("a name for it"), checkpoint: s("save it as it was at this checkpoint (default: live)") }, ["pod", "name"]),
+    async call(ctx, a) {
+      const p = await resolvePod(ctx, need(a, "pod"));
+      const cp = typeof a.checkpoint === "string" && a.checkpoint ? resolveCheckpoint(await ctx.api.checkpoints(p.id), a.checkpoint).id : void 0;
+      return ctx.api.saveSnapshot(p.id, need(a, "name"), cp);
+    }
+  },
+  {
+    name: "snapshots_list",
+    description: "Your saved snapshots (name, state, which pod they came from, whether shared).",
+    inputSchema: obj({}),
+    async call(ctx) {
+      return ctx.api.snapshots();
+    }
+  },
+  {
+    name: "pod_settings",
+    description: "Change a pod's network after launch (open | allowlist | off, extra allowlist hosts) or switch its AI off/on (aiOff: no model calls at all). Applies immediately. Only when the user asked for it.",
+    inputSchema: obj({ pod: POD, network: s("open | allowlist | off", { enum: ["open", "allowlist", "off"] }), allow: { type: "array", items: { type: "string" }, description: "extra allowlist hosts (replaces the list)" }, aiOff: b("true switches the pod's AI off; false back on") }, ["pod"]),
+    async call(ctx, a) {
+      const p = await resolvePod(ctx, need(a, "pod"));
+      const patch = {};
+      if (typeof a.network === "string") patch.network = a.network;
+      if (Array.isArray(a.allow)) patch.allow = a.allow.map(String);
+      if (typeof a.aiOff === "boolean") patch.aiOff = a.aiOff;
+      if (!Object.keys(patch).length) throw new UsageError("nothing to change: network, allow or aiOff");
+      const pod = await ctx.api.updatePod(p.id, patch);
+      return { name: pod.spec.name, network: pod.spec.network, allow: pod.spec.allow ?? [], aiOff: Boolean(pod.spec.aiOff) };
+    }
+  },
+  {
+    name: "crew_start",
+    description: "Start a crew: several agents, each in its own pod, on one task, run by airgate (it keeps going without you). kind: race (builders try the same task, a judge tests each and picks one), contest (a builder builds, a reviewer reviews and tries to break it, until it holds), council (members propose plans and critique each other, a chair decides; build: true also builds it), squad (a builder builds, testers write tests and hunt bugs, the builder fixes), split (a planner splits the work, workers build parts, an integrator merges). Starting point: the local project in dir (default), or pod, snapshot or repo. Returns at once with the crew id: follow with crew_status, bring the result back with crew_down. Tell the user it started and roughly what it costs (one pod per member while they work).",
+    inputSchema: obj(
+      {
+        kind: s("race | contest | council | squad | split", { enum: ["race", "contest", "council", "squad", "split"] }),
+        task: s("what the crew should do"),
+        dir: s("the local project to start from (default: where the server started)"),
+        pod: s("start from this existing pod instead"),
+        snapshot: s("start from this saved snapshot instead"),
+        repo: s("start from this GitHub repo instead (owner/name)"),
+        members: { type: "array", items: { type: "string" }, description: 'role=agent[:model] overrides, e.g. ["reviewer=codex", "builder-3=opencode:qwen/qwen3-coder"]' },
+        rounds: n("contest / squad rounds, 1\u20135"),
+        maxMinutes: n("time limit for the whole crew (default 60)"),
+        build: b("council: also build the decision"),
+        pr: b("open a pull request with the result (it waits in the airlock)")
+      },
+      ["kind", "task"]
+    ),
+    async call(ctx, a) {
+      const argv = [need(a, "kind"), need(a, "task"), "--detach"];
+      const opt = (flag, v) => typeof v === "string" && v && argv.push(`--${flag}`, v);
+      opt("pod", a.pod);
+      opt("from", a.snapshot);
+      opt("repo", a.repo);
+      for (const m of Array.isArray(a.members) ? a.members : []) argv.push("--as", String(m));
+      if (typeof a.rounds === "number") argv.push("--rounds", String(a.rounds));
+      if (typeof a.maxMinutes === "number") argv.push("--minutes", String(a.maxMinutes));
+      if (a.build === true) argv.push("--build");
+      if (a.pr === true) argv.push("--pr");
+      return runCommand(ctx, crew, argv, dirOf(ctx, a));
+    }
+  },
+  {
+    name: "crew_status",
+    description: "A crew's state, members (and their pods), the room's messages after `since` (a message id), and the result once done.",
+    inputSchema: obj({ crew: s("the crew id"), since: n("only messages after this id") }, ["crew"]),
+    async call(ctx, a) {
+      const id = encodeURIComponent(need(a, "crew"));
+      const c = (await ctx.api.request("GET", `/v1/crews/${id}`)).crew;
+      const since = typeof a.since === "number" ? a.since : 0;
+      return { ...c, messages: (c.messages ?? []).filter((m) => m.id > since) };
+    }
+  },
+  {
+    name: "crew_say",
+    description: "Post to a crew's room as the user (members read it between steps). Only what the user asked you to tell them.",
+    inputSchema: obj({ crew: s("the crew id"), text: s("the message") }, ["crew", "text"]),
+    async call(ctx, a) {
+      return ctx.api.request("POST", `/v1/crews/${encodeURIComponent(need(a, "crew"))}/messages`, { body: { text: need(a, "text") } });
+    }
+  },
+  {
+    name: "crew_stop",
+    description: "Stop a crew at its next step; its pods go to sleep with their work.",
+    inputSchema: obj({ crew: s("the crew id") }, ["crew"]),
+    async call(ctx, a) {
+      return ctx.api.request("POST", `/v1/crews/${encodeURIComponent(need(a, "crew"))}/stop`);
+    }
+  },
+  {
+    name: "crew_down",
+    description: "Bring a finished crew's result (one patch) into the local repo, with airgate down's checks (all or nothing; symlinks and paths outside refused). apply: false returns the patch without applying it.",
+    inputSchema: obj({ crew: s("the crew id"), dir: s("the local project (default: where the server started)"), apply: b("false: just return the patch") }, ["crew"]),
+    async call(ctx, a) {
+      return runCommand(ctx, crew, ["down", need(a, "crew"), ...a.apply === false ? ["--dry-run"] : ["--yes"]], dirOf(ctx, a));
+    }
+  },
   {
     name: "pod_ports",
     description: "What is listening in a pod (dev servers on ports 1024+) and its preview links.",
@@ -9563,7 +9977,7 @@ async function handle(ctx, msg) {
         protocolVersion: asked,
         capabilities: { tools: { listChanged: false } },
         serverInfo: { name: "airgate", title: "Airgate", version: VERSION },
-        instructions: "Airgate pods are private cloud computers for coding agents. pod_run does one task in a fresh pod and brings the result back; pod_up / pod_down move the local project and conversation there and back; task_start hands an existing pod a task (run_status / run_log follow it). Sleep pods you are done with; delete only pods you launched (or the user asked). Outbound actions wait in the airlock for the user: never approve on your own initiative."
+        instructions: "Airgate pods are private cloud computers for coding agents; crews put several agents (each in its own pod) on one task: crew_start, crew_status, crew_down. pod_run does one task in a fresh pod and brings the result back; pod_up / pod_down move the local project and conversation there and back; task_start hands an existing pod a task (run_status / run_log follow it). Sleep pods you are done with; delete only pods you launched (or the user asked). Outbound actions wait in the airlock for the user: never approve on your own initiative."
       });
     }
     case "ping":
@@ -9631,7 +10045,7 @@ var mcp = {
 };
 
 // src/commands/misc.ts
-import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync6 } from "node:fs";
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync7 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join7 } from "node:path";
 var PAGES = ["pods", "airlock", "usage", "settings", "mask", "chat", "notes", "data", "status"];
@@ -9712,7 +10126,7 @@ var skill = {
     const base = bool(ctx.args, "project") ? join7(ctx.io.cwd, ".claude") : join7(ctx.io.env.HOME ?? homedir3(), ".claude");
     const dir = join7(base, "skills", "airgate");
     mkdirSync5(dir, { recursive: true });
-    writeFileSync6(join7(dir, "SKILL.md"), text2);
+    writeFileSync7(join7(dir, "SKILL.md"), text2);
     if (ctx.json) return ctx.ui.json({ installed: join7(dir, "SKILL.md") });
     ctx.ui.out(`${ctx.ui.c("ok", "installed")} the airgate skill: ${join7(dir, "SKILL.md")}`);
     ctx.ui.out(ctx.ui.c("dim", 'claude code picks it up in its next session. ask it to "move this to an airgate pod".'));
@@ -9867,7 +10281,7 @@ var race = {
   async run(ctx) {
     const [ref, cpRef = "current"] = ctx.args.positionals;
     const p = await resolvePod(ctx, ref);
-    const checkpointId = cpRef === "current" ? "current" : resolveCheckpoint(await ctx.api.checkpoints(p.id), cpRef).id;
+    const checkpointId2 = cpRef === "current" ? "current" : resolveCheckpoint(await ctx.api.checkpoints(p.id), cpRef).id;
     const overrides = {};
     const agent = str(ctx.args, "agent");
     if (agent) overrides.agent = agent;
@@ -9875,7 +10289,7 @@ var race = {
     if (name) overrides.name = name;
     let pod;
     try {
-      pod = await ctx.ui.spin(`forking ${p.spec.name}`, async () => waitReady(ctx, await ctx.api.fork(p.id, checkpointId, overrides)));
+      pod = await ctx.ui.spin(`forking ${p.spec.name}`, async () => waitReady(ctx, await ctx.api.fork(p.id, checkpointId2, overrides)));
     } catch (e) {
       if (e instanceof ApiError && e.code === "checkpoint_not_mounted") {
         throw new CliError("that checkpoint can't be read on the provider right now", `race from the live workspace: airgate race ${p.spec.name} current (or rewind first)`);
@@ -9884,7 +10298,7 @@ var race = {
     }
     if (ctx.json) return ctx.ui.json(pod);
     ctx.ui.out(readyLine(ctx, pod));
-    ctx.ui.out(`racing ${p.spec.name} from ${checkpointId === "current" ? "its current state" : `"${cpRef}"`}. compare: airgate down --pod ${pod.spec.name} --dry-run`);
+    ctx.ui.out(`racing ${p.spec.name} from ${checkpointId2 === "current" ? "its current state" : `"${cpRef}"`}. compare: airgate down --pod ${pod.spec.name} --dry-run`);
   }
 };
 
@@ -10148,19 +10562,19 @@ function validateForm(f) {
   return e;
 }
 function formSpec(f, catalog = null) {
-  const network = NETWORK_LIST[f.network];
+  const network2 = NETWORK_LIST[f.network];
   const template = formTemplate(f);
   const spec = {
     name: f.name.trim(),
     agent: AGENT_LIST[f.agent],
     size: SIZE_LIST[f.memory],
     masking: f.mask,
-    network,
+    network: network2,
     autoStopMinutes: null,
     autoCheckpoint: f.undo
   };
   if (f.repo.trim()) spec.repo = f.repo.trim();
-  if (network === "allowlist") spec.allow = DEFAULT_ALLOW2;
+  if (network2 === "allowlist") spec.allow = DEFAULT_ALLOW2;
   if (template !== "code") spec.template = template;
   if (f.browser) spec.browser = true;
   if (template === "autopilot") spec.jobs = [{ cron: formCron(f), task: f.task.trim(), enabled: true }];
@@ -10326,8 +10740,8 @@ function modalKey(s2, m, key) {
     }
   }
 }
-function toast(s2, text2, tone = "ok") {
-  const t = { id: s2.nextToast, text: text2, tone, until: s2.now + TOAST_MS };
+function toast(s2, text2, tone2 = "ok") {
+  const t = { id: s2.nextToast, text: text2, tone: tone2, until: s2.now + TOAST_MS };
   return { ...s2, toasts: [...s2.toasts.slice(-2), t], nextToast: s2.nextToast + 1 };
 }
 function moveSel(s2, d) {
@@ -11312,25 +11726,25 @@ function startTui(d) {
 `);
     const { cols, rows: rows2 } = size2();
     let note = `back from ${name}. the session keeps running.`;
-    let tone = "ok";
+    let tone2 = "ok";
     try {
       const ws = d.websocket(d.api.terminalUrl(podId, cols, rows2));
       const end = await attachSession({ stdin: d.stdin, stdout: d.stdout, ws, signals: d.signals });
       if (end.reason === "exit") note = `${name}: session ended (exit ${end.code})`;
       else if (end.reason === "error" || end.reason === "closed" && end.code !== 1e3) {
         note = `${name}: terminal ${end.reason === "error" ? end.message : "closed"}`;
-        tone = "bad";
+        tone2 = "bad";
       }
     } catch (e) {
       note = `couldn't attach: ${errText(e)}`;
-      tone = "bad";
+      tone2 = "bad";
     }
     if (finished) return;
     suspended = false;
     shown2 = [];
     d.stdout.write(ENTER_ALT);
     listenKeys(true);
-    dispatch(tone === "ok" ? { type: "done", text: note } : { type: "failed", text: note });
+    dispatch(tone2 === "ok" ? { type: "done", text: note } : { type: "failed", text: note });
   }
   async function stream() {
     for (let attempt = 0; !controller.signal.aborted; attempt++) {
@@ -11437,6 +11851,171 @@ var ui = {
   }
 };
 
+// src/commands/workspace.ts
+import { writeFileSync as writeFileSync8, existsSync as existsSync7, statSync as statSync5 } from "node:fs";
+import { basename as basename3, resolve as resolve7 } from "node:path";
+async function checkpointId(ctx, podId, ref) {
+  if (!ref || ref === "current") return void 0;
+  return resolveCheckpoint(await ctx.api.checkpoints(podId), ref).id;
+}
+var files = {
+  name: "files",
+  aliases: ["ls-files"],
+  group: "pods",
+  usage: "<pod> [path] [--at <checkpoint>]",
+  summary: "what's in a pod's workspace, live or at a checkpoint (nothing is rewound)",
+  example: 'airgate files web src --at "#2"',
+  notes: ["--at takes a checkpoint id, its label, or #1 for the newest (airgate checkpoints <pod>). get a file with: airgate pull <pod> <path>"],
+  flags: { at: { type: "string", value: "checkpoint", help: "look at a checkpoint instead of the live workspace" } },
+  async run(ctx) {
+    const [ref, path = ""] = ctx.args.positionals;
+    if (!ref) throw new UsageError("which pod? airgate files <pod> [path]");
+    const pod = await resolvePod(ctx, ref);
+    const at3 = await checkpointId(ctx, pod.id, str(ctx.args, "at"));
+    const r = await ctx.api.files(pod.id, path, at3);
+    if (ctx.json) return ctx.ui.json(r);
+    if (!r.entries.length) return void ctx.ui.out(ctx.ui.c("dim", `${r.path || "~/workspace"} is empty`));
+    ctx.ui.table(
+      r.entries.map((e) => [e.type === "dir" ? `${e.name}/` : e.name, e.type === "dir" ? "" : ctx.ui.c("dim", bytes(e.size))]),
+      { head: [`${pod.spec.name}:~/workspace/${r.path}${at3 ? ` @ ${str(ctx.args, "at")}` : ""}`, ""] }
+    );
+  }
+};
+var pull = {
+  name: "pull",
+  group: "pods",
+  usage: "<pod> <path> [--at <checkpoint>] [-o <file>]",
+  summary: "copy one file from a pod (live or at a checkpoint) to this laptop",
+  example: 'airgate pull web src/app.ts --at "before the refactor"',
+  notes: ["up to 25 MB. without -o it lands in this folder under its own name (never over an existing file unless --force). -o - prints it."],
+  flags: {
+    at: { type: "string", value: "checkpoint", help: "from a checkpoint instead of the live workspace" },
+    out: { type: "string", short: "o", value: "file", help: "where to save it (- prints it)" },
+    force: { type: "boolean", help: "overwrite an existing file" }
+  },
+  async run(ctx) {
+    const [ref, path] = ctx.args.positionals;
+    if (!ref || !path) throw new UsageError("airgate pull <pod> <path>");
+    const pod = await resolvePod(ctx, ref);
+    const at3 = await checkpointId(ctx, pod.id, str(ctx.args, "at"));
+    const body = await ctx.ui.spin(`reading ${path}`, ctx.api.fileRaw(pod.id, path, at3));
+    const out = str(ctx.args, "out") ?? basename3(path);
+    if (out === "-") return void ctx.io.stdout.write(body);
+    const dest = resolve7(ctx.io.cwd, out);
+    if (existsSync7(dest) && !bool(ctx.args, "force")) {
+      if (statSync5(dest).isDirectory()) return void save2(ctx, resolve7(dest, basename3(path)), body);
+      throw new CliError(`${out} exists here`, "pick another name with -o, or --force to overwrite");
+    }
+    save2(ctx, dest, body);
+  }
+};
+function save2(ctx, dest, body) {
+  writeFileSync8(dest, body);
+  if (ctx.json) return ctx.ui.json({ saved: dest, bytes: body.length });
+  ctx.ui.out(`${ctx.ui.c("ok", "saved")} ${dest} (${bytes(body.length)})`);
+}
+var ai = {
+  name: "ai",
+  group: "pods",
+  usage: "<pod> on|off",
+  summary: "switch a pod's AI off (no model calls at all) or back on",
+  example: "airgate ai web off",
+  notes: ["off: airgate refuses the pod's model calls, and on allowlist or off networks the model hosts are closed too (an open network can still reach them directly)."],
+  async run(ctx) {
+    const [ref, state] = ctx.args.positionals;
+    if (!ref || state !== "on" && state !== "off") throw new UsageError("airgate ai <pod> on|off");
+    const pod = await resolvePod(ctx, ref);
+    const p = await ctx.api.updatePod(pod.id, { aiOff: state === "off" });
+    if (ctx.json) return ctx.ui.json(p);
+    ctx.ui.out(state === "off" ? `${ctx.ui.c("warn", "AI off")} for ${p.spec.name}: no model calls.${p.spec.network === "open" ? ctx.ui.c("dim", " (its network is open, so it could still reach a model directly: airgate network " + p.spec.name + " allowlist)") : ""}` : `${ctx.ui.c("ok", "AI on")} for ${p.spec.name}.`);
+  }
+};
+var network = {
+  name: "network",
+  group: "pods",
+  usage: "<pod> [open|allowlist|off] [--allow host,host] [--add host] [--remove host]",
+  summary: "see or change what a pod can reach on the internet, now",
+  example: "airgate network web allowlist --add api.stripe.com",
+  notes: [
+    "allowlist: common package registries and GitHub, plus your hosts; off: only the agent's model and airgate; open: anything.",
+    "the agent's own model and sign-in hosts stay reachable unless its AI is off."
+  ],
+  flags: {
+    allow: { type: "string", value: "hosts", help: "replace the extra hosts (comma separated)" },
+    add: { type: "string", value: "host", help: "add hosts (comma separated)" },
+    remove: { type: "string", value: "host", help: "remove hosts (comma separated)" }
+  },
+  async run(ctx) {
+    const [ref, mode] = ctx.args.positionals;
+    if (!ref) throw new UsageError("airgate network <pod> [open|allowlist|off]");
+    if (mode && !["open", "allowlist", "off"].includes(mode)) throw new UsageError("open, allowlist or off");
+    const pod = await resolvePod(ctx, ref);
+    const list2 = (v) => (v ?? "").split(",").map((h) => h.trim().toLowerCase()).filter(Boolean);
+    let allow = pod.spec.allow ?? [];
+    if (str(ctx.args, "allow") !== void 0) allow = list2(str(ctx.args, "allow"));
+    allow = [.../* @__PURE__ */ new Set([...allow, ...list2(str(ctx.args, "add"))])].filter((h) => !list2(str(ctx.args, "remove")).includes(h));
+    const changed = mode || ["allow", "add", "remove"].some((k) => str(ctx.args, k) !== void 0);
+    const p = changed ? await ctx.api.updatePod(pod.id, { ...mode ? { network: mode } : {}, allow }) : pod;
+    if (ctx.json) return ctx.ui.json({ network: p.spec.network, allow: p.spec.allow ?? [], aiOff: Boolean(p.spec.aiOff) });
+    ctx.ui.out(`${p.spec.name}: ${p.spec.network}${p.spec.network === "allowlist" && (p.spec.allow ?? []).length ? ` + ${(p.spec.allow ?? []).join(", ")}` : ""}${p.spec.aiOff ? ctx.ui.c("warn", " \xB7 AI off") : ""}${changed ? ctx.ui.c("dim", " (applied now)") : ""}`);
+  }
+};
+var snapshot2 = {
+  name: "snapshot",
+  aliases: ["snapshots"],
+  group: "undo \xB7 race",
+  usage: "[<pod> <name> [--at <checkpoint>] | share|unshare|rm <name> | show <code>]",
+  summary: "save a pod as a snapshot new pods start from; share it by code",
+  example: 'airgate snapshot web "clean base"',
+  notes: [
+    'a snapshot is a frozen copy of the workspace (live, or at a checkpoint): it stays when the pod is deleted. start a pod from it: airgate launch --from "<name>" (or a share code).',
+    "only the workspace is copied: never the pod's secrets, its agent's conversations or its masking vault. share gives a code anyone signed in to airgate can launch from; unshare stops it.",
+    "with no arguments: your snapshots."
+  ],
+  flags: { at: { type: "string", value: "checkpoint", help: "save the workspace as it was at a checkpoint" }, yes: { type: "boolean", short: "y", help: "don't ask" } },
+  async run(ctx) {
+    const { ui: ui2 } = ctx;
+    const [a, b2, extra] = ctx.args.positionals;
+    if (extra) throw new UsageError(`unexpected "${extra}" (put names with spaces in quotes)`);
+    if (!a) {
+      const list2 = await ctx.api.snapshots();
+      if (ctx.json) return ui2.json(list2);
+      if (!list2.length) return void ui2.out(ui2.c("dim", "no snapshots yet. save one: airgate snapshot <pod> <name>"));
+      ui2.table(
+        list2.map((s3) => [s3.name, s3.state === "ready" ? ui2.c("ok", "ready") : s3.state === "failed" ? ui2.c("bad", "failed") : ui2.c("warn", "saving"), `from ${s3.from.podName}`, s3.shareCode ? ui2.c("warn", `shared: ${s3.shareCode}`) : ui2.c("dim", "private")]),
+        { head: ["snapshot", "", "", ""] }
+      );
+      return void ui2.out(ui2.c("dim", 'start a pod from one: airgate launch --from "<name>"'));
+    }
+    if (a === "share" || a === "unshare") {
+      if (!b2) throw new UsageError(`airgate snapshot ${a} <name>`);
+      const s3 = await ctx.api.shareSnapshot(b2, a === "share");
+      if (ctx.json) return ui2.json(s3);
+      if (a === "unshare") return void ui2.out(`${s3.name}: private again; its old code no longer works.`);
+      ui2.out(`${s3.name}: share code ${s3.shareCode ?? ""}`);
+      return void ui2.out(ui2.c("dim", `anyone signed in to airgate can start a pod from it: airgate launch --from ${s3.shareCode}. it shares only the workspace files.`));
+    }
+    if (a === "rm" || a === "delete") {
+      if (!b2) throw new UsageError("airgate snapshot rm <name>");
+      if (!await confirm(ctx, `delete the snapshot "${b2}"? pods already started from it keep their files.`)) throw new CliError("nothing deleted");
+      await ctx.api.deleteSnapshot(b2);
+      return ctx.json ? ui2.json({ ok: true }) : void ui2.out(`deleted ${b2}.`);
+    }
+    if (a === "show") {
+      if (!b2) throw new UsageError("airgate snapshot show <code>");
+      const s3 = await ctx.api.sharedSnapshot(b2);
+      if (ctx.json) return ui2.json(s3);
+      return void ui2.out(`${s3.name} \xB7 ${s3.agent} \xB7 ${s3.template}${s3.state !== "ready" ? ` \xB7 ${s3.state}` : ""}. start a pod from it: airgate launch --from ${b2}`);
+    }
+    if (!b2) throw new UsageError("airgate snapshot <pod> <name>  (or: airgate snapshots)");
+    const pod = await resolvePod(ctx, a);
+    const at3 = await checkpointId(ctx, pod.id, str(ctx.args, "at"));
+    const s2 = await ui2.spin(`saving ${pod.spec.name} as "${b2}"`, ctx.api.saveSnapshot(pod.id, b2, at3));
+    if (ctx.json) return ui2.json(s2);
+    ui2.out(`${ui2.c("ok", "saved")} "${s2.name}" from ${pod.spec.name}${at3 ? ` at ${str(ctx.args, "at")}` : ""}. ${ui2.c("dim", `start a pod from it: airgate launch --from "${s2.name}" \xB7 share it: airgate snapshot share "${s2.name}"`)}`);
+  }
+};
+
 // src/cli.ts
 var help = {
   name: "help",
@@ -11493,6 +12072,12 @@ var COMMANDS = [
   runTask,
   models,
   relay,
+  crew,
+  files,
+  pull,
+  snapshot2,
+  ai,
+  network,
   usage,
   plan,
   upgrade,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airgate",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Give your AI its own computer: the airgate command line.",
   "type": "module",
   "bin": {