airgate 0.1.5 → 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

@@ -1984,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)
@@ -1993,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;
@@ -2984,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;
@@ -3014,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 {
@@ -3026,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++)
@@ -5757,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) {
@@ -5776,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;
     });
@@ -5800,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;
@@ -7777,7 +7777,7 @@ var log = {
 import { createInterface } from "node:readline";
 
 // src/version.ts
-var VERSION = "0.1.5";
+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";
@@ -7829,7 +7829,7 @@ function gitFiles(dir) {
   return out;
 }
 function runTar(cwd, args, input, limit = UPLOAD_LIMIT) {
-  return new Promise((resolve7, 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;
@@ -7849,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(" ")}`));
-      resolve7(Buffer.concat(chunks));
+      resolve8(Buffer.concat(chunks));
     });
     child.stdin.on("error", () => void 0);
     child.stdin.end(input ?? "");
@@ -8637,7 +8637,7 @@ var LineReader = class {
   }
 };
 function ttyPrompt(stdin, out) {
-  return (question, opts2 = {}) => new Promise((resolve7, reject) => {
+  return (question, opts2 = {}) => new Promise((resolve8, reject) => {
     out.write(question);
     const decoder = new StringDecoder2("utf8");
     let answer = "";
@@ -8650,7 +8650,7 @@ function ttyPrompt(stdin, out) {
       stdin.pause();
       out.write("\n");
       if (err) reject(err);
-      else resolve7(answer);
+      else resolve8(answer);
     };
     const onData = (d) => {
       for (const ch of decoder.write(d)) {
@@ -8677,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((resolve7) => {
+  return new Promise((resolve8) => {
     try {
       const child = spawn2(cmd, args, { stdio: "ignore", detached: true });
-      child.on("error", () => resolve7(false));
+      child.on("error", () => resolve8(false));
       child.on("spawn", () => {
         child.unref();
-        resolve7(true);
+        resolve8(true);
       });
     } catch {
-      resolve7(false);
+      resolve8(false);
     }
   });
 }
@@ -9282,6 +9282,237 @@ When you are done, leave your changes in the files there (no need to commit or p
   }
 };
 
+// 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 });
@@ -9635,6 +9866,74 @@ var TOOLS = [
       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.",
@@ -9678,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":
@@ -9746,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"];
@@ -9827,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".'));
@@ -10441,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) {
@@ -11427,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++) {
@@ -11553,8 +11852,8 @@ var ui = {
 };
 
 // src/commands/workspace.ts
-import { writeFileSync as writeFileSync7, existsSync as existsSync6, statSync as statSync4 } from "node:fs";
-import { basename as basename3, resolve as resolve6 } from "node:path";
+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;
@@ -11602,16 +11901,16 @@ var pull = {
     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 = resolve6(ctx.io.cwd, out);
-    if (existsSync6(dest) && !bool(ctx.args, "force")) {
-      if (statSync4(dest).isDirectory()) return void save2(ctx, resolve6(dest, basename3(path)), 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) {
-  writeFileSync7(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)})`);
 }
@@ -11773,6 +12072,7 @@ var COMMANDS = [
   runTask,
   models,
   relay,
+  crew,
   files,
   pull,
   snapshot2,

package/package.json

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