airgate 0.2.1 → 0.2.3

package/README.md

@@ -25,7 +25,7 @@ macOS and Linux, Node.js 20.10 or newer.
 airgate login     # approve this terminal in your browser
 airgate           # the full-screen terminal app
 airgate launch    # a new pod
-airgate up        # move the session you're in to a pod; airgate down brings the work back
+airgate up        # move the session you're in to a pod (files, conversation, memory); airgate down brings it back
 airgate help      # every command
 ```
 
@@ -60,7 +60,7 @@ airgate share web                              # teammates open, watch and fork
 airgate recall "rate limiting"                 # what a teammate already did
 airgate recall --patch <id> --apply            # reuse it here instead of paying again
 airgate note "tests need DATABASE_URL=sqlite::memory:"
-airgate team trigger add acme/web pr --recipe squad   # a crew on every pull request
+airgate team trigger add acme/web pr --mission squad  # a crew on every pull request
 ```
 
 Guide: https://airgate.sh/docs/teams
@@ -68,7 +68,7 @@ Guide: https://airgate.sh/docs/teams
 ## For your agent
 
 Claude Code or Codex on your laptop can send work to pods on its own: one task in a fresh pod
-with the result back here, or the whole project and conversation up and back.
+with the result back here, or the whole project, conversation and memory up and back.
 
 ```sh
 airgate run "get the failing tests passing"   # a fresh pod; the result comes back as a patch

package/dist/airgate.mjs

@@ -813,6 +813,9 @@ var Api = class {
   resumeAgentSession(id, body) {
     return this.request("POST", `/v1/pods/${enc(id)}/agent-session/resume`, { body });
   }
+  exportAgentMemory(id, dir) {
+    return this.request("GET", `/v1/pods/${enc(id)}/agent-memory?${new URLSearchParams({ dir })}`);
+  }
   exportAgentSession(id, q) {
     const qs = new URLSearchParams({ agent: q.agent, dir: q.dir, ...q.id ? { id: q.id } : {} });
     return this.request("GET", `/v1/pods/${enc(id)}/agent-session?${qs}`);
@@ -7559,7 +7562,7 @@ import { rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { resolve as resolve4 } from "node:path";
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.2.3";
 
 // src/commands/team.ts
 async function checkSimilar(ctx, task2) {
@@ -7634,7 +7637,7 @@ var team = {
     "airgate team audit [--csv]           who did what (admins)",
     "airgate team billing \xB7 upgrade [--seats n] \xB7 seats <n>   the team plan: seats and its pooled hours",
     "airgate team secrets \xB7 secret set NAME (value from a hidden prompt or stdin) \xB7 secret rm NAME   reach every member's pods",
-    "airgate team triggers \xB7 trigger add <owner/repo> pr|issue [--label l] [--recipe r] \xB7 trigger rm <id>   crews started by GitHub"
+    "airgate team triggers \xB7 trigger add <owner/repo> pr|issue [--label l] [--mission m] \xB7 trigger rm <id>   crews started by GitHub"
   ],
   flags: {
     admin: { type: "boolean", help: "invite: as an admin" },
@@ -7651,7 +7654,8 @@ var team = {
     csv: { type: "boolean", help: "audit: as CSV" },
     seats: { type: "string", value: "n", help: "upgrade: how many seats (at least everyone in it)" },
     label: { type: "string", value: "label", help: "trigger: the issue label that starts a crew (default airgate)" },
-    recipe: { type: "string", value: "recipe", help: "trigger: race, contest, council, squad or split" },
+    mission: { type: "string", value: "mission", help: "trigger: the crew's mission: race, contest, council, squad or split" },
+    recipe: { type: "string", value: "mission", help: "trigger: the old name for --mission" },
     yes: { type: "boolean", short: "y", help: "don't ask" },
     "no-open": { type: "boolean", help: "print the link instead of opening the browser" }
   },
@@ -7851,14 +7855,15 @@ var team = {
       case "triggers": {
         const list2 = await ctx.api.triggers();
         if (ctx.json) return ui2.json(list2);
-        if (!list2.length) return void ui2.out(ui2.c("dim", "no triggers. add one: airgate team trigger add <owner/repo> pr|issue [--recipe squad]"));
+        if (!list2.length) return void ui2.out(ui2.c("dim", "no triggers. add one: airgate team trigger add <owner/repo> pr|issue [--mission squad]"));
         return void ui2.table(list2.map((t) => [t.repo, t.event === "pr_opened" ? "a pull request opens" : `an issue gets "${t.label}"`, `${t.recipe} crew`, ui2.c("dim", t.id)]), { head: ["repo", "when", "starts", "id"] });
       }
       case "trigger": {
         if (a1 === "add") {
           const [, , repo, when] = ctx.args.positionals;
-          if (!repo || when !== "pr" && when !== "issue") throw new UsageError("airgate team trigger add <owner/repo> pr|issue [--label l] [--recipe r]");
-          const t = await ctx.api.addTrigger({ repo, event: when === "pr" ? "pr_opened" : "issue_labeled", ...str(ctx.args, "label") ? { label: str(ctx.args, "label") } : {}, ...str(ctx.args, "recipe") ? { recipe: str(ctx.args, "recipe") } : {} });
+          if (!repo || when !== "pr" && when !== "issue") throw new UsageError("airgate team trigger add <owner/repo> pr|issue [--label l] [--mission m]");
+          const mission = str(ctx.args, "mission") ?? str(ctx.args, "recipe");
+          const t = await ctx.api.addTrigger({ repo, event: when === "pr" ? "pr_opened" : "issue_labeled", ...str(ctx.args, "label") ? { label: str(ctx.args, "label") } : {}, ...mission ? { recipe: mission } : {} });
           if (ctx.json) return ui2.json(t);
           ui2.out(`${ui2.c("ok", "added")}: ${t.event === "pr_opened" ? "each pull request opened on" : `each issue labelled "${t.label}" on`} ${t.repo} starts a ${t.recipe} crew.`);
           return void ui2.out(ui2.c("dim", "it runs as you; what it pushes or opens waits in the airlock. the GitHub App must be on the repo: airgate github"));
@@ -8752,6 +8757,79 @@ function bringBack(sent, podContent, now = /* @__PURE__ */ new Date()) {
   atomic(file, body);
   return { agent: sent.agent, id, file, outcome: "new", sha256: sha256(body) };
 }
+var TEXTISH = /\.(md|markdown|txt|json|jsonl|ya?ml|toml)$/i;
+function findClaudeMemory(home, projectDir, env = {}) {
+  for (const p of spellings(projectDir)) {
+    const dir = join3(claudeHome(home, env), "projects", claudeKey(p), "memory");
+    try {
+      if (statSync(dir).isDirectory() && listFiles(dir).length) return dir;
+    } catch {
+    }
+  }
+  return null;
+}
+function listFiles(dir, rel = "") {
+  const out = [];
+  for (const x of readdirSync2(join3(dir, rel), { withFileTypes: true })) {
+    const r = rel ? `${rel}/${x.name}` : x.name;
+    if (x.isDirectory()) out.push(...listFiles(dir, r));
+    else if (x.isFile()) out.push(r);
+  }
+  return out;
+}
+async function packMemory(dir, projectDir, podPath, limit = UPLOAD_LIMIT) {
+  const froms = spellings(projectDir);
+  const stage = mkdtempSync(join3(tmpdir(), "airgate-memory-"));
+  try {
+    const files2 = {};
+    for (const rel of listFiles(dir)) {
+      const body = readFileSync4(join3(dir, rel));
+      files2[rel] = sha256(body);
+      const out = join3(stage, "memory", rel);
+      mkdirSync2(dirname(out), { recursive: true });
+      writeFileSync3(out, TEXTISH.test(rel) ? rewriteAll(body.toString("utf8"), froms, podPath) : body);
+    }
+    const archive = await runTar(stage, ["-czf", "-", "memory"], null, limit);
+    return { podDir: `.claude/projects/${claudeKey(podPath)}`, archive, sent: { dir, localPath: projectDir, podPath, files: files2 }, count: Object.keys(files2).length };
+  } finally {
+    rmSync3(stage, { recursive: true, force: true });
+  }
+}
+function bringBackMemory(sent, pod) {
+  const out = { added: [], updated: [], conflicts: [], sent: { ...sent, files: { ...sent.files } } };
+  const write2 = (file, body) => {
+    mkdirSync2(dirname(file), { recursive: true });
+    const tmp = `${file}.airgate-${process.pid}`;
+    writeFileSync3(tmp, body, { mode: 384 });
+    renameSync2(tmp, file);
+  };
+  for (const f of pod) {
+    const rel = f.path.replace(/\\/g, "/");
+    if (!rel || rel.startsWith("/") || rel.split("/").some((p) => p === ".." || p === "")) continue;
+    const body = TEXTISH.test(rel) ? Buffer.from(rewritePath(f.body.toString("utf8"), sent.podPath, sent.localPath)) : f.body;
+    const file = join3(sent.dir, rel);
+    const local = existsSync2(file) ? readFileSync4(file) : null;
+    if (local && local.equals(body)) {
+      out.sent.files[rel] = sha256(local);
+      continue;
+    }
+    if (!local) {
+      write2(file, body);
+      out.added.push(rel);
+      out.sent.files[rel] = sha256(body);
+    } else if (sent.files[rel] && sha256(local) === sent.files[rel]) {
+      write2(file, body);
+      out.updated.push(rel);
+      out.sent.files[rel] = sha256(body);
+    } else {
+      const dot = rel.lastIndexOf(".");
+      const savedAs = dot > rel.lastIndexOf("/") ? `${rel.slice(0, dot)}.from-pod${rel.slice(dot)}` : `${rel}.from-pod`;
+      write2(join3(sent.dir, savedAs), body);
+      out.conflicts.push({ file: rel, savedAs });
+    }
+  }
+  return out;
+}
 
 // src/patch.ts
 var RULES2 = [
@@ -8961,7 +9039,7 @@ function podDirName(projectDir) {
 var up = {
   name: "up",
   group: "up \xB7 down",
-  usage: "[dir] [--pod p] [--agent a] [--with-config] [--env [.env]] [--session id | --no-session]",
+  usage: "[dir] [--pod p] [--agent a] [--with-config] [--env [.env]] [--session id | --no-session] [--no-memory]",
   summary: "move this project (with uncommitted work) into a pod",
   example: "airgate up --with-config",
   notes: [
@@ -8970,6 +9048,7 @@ var up = {
     "--with-config also sends ~/.claude settings.json, CLAUDE.md, skills/, agents/, commands/ (never credentials).",
     "remembers the pod in .airgate/state.json (kept out of git via .git/info/exclude) so `airgate down` knows where to look.",
     "also sends your latest Claude Code / Codex conversation in this directory and resumes it in the pod (paths rewritten); --no-session to skip, --session <id> to pick one. dropped with a warning if it is over the size limit.",
+    "and Claude Code's memory for this project (~/.claude/projects/<project>/memory); --no-memory to skip. down brings new and changed memories back, never overwriting one you changed here.",
     "--env [file] sends the keys of a dotenv file (default .env) as secrets of that pod; the names sent are listed."
   ],
   flags: {
@@ -8981,6 +9060,7 @@ var up = {
     env: { type: "string", value: "file", implicit: ".env", help: "send a dotenv file's keys as this pod's secrets (default .env)" },
     session: { type: "string", value: "id", help: "send this Claude Code / Codex conversation (default: the latest here)" },
     "no-session": { type: "boolean", help: "don't send the agent conversation" },
+    "no-memory": { type: "boolean", help: "don't send Claude Code's memory for this project" },
     yes: { type: "boolean", short: "y", help: "don't ask" }
   },
   async run(ctx) {
@@ -9024,6 +9104,16 @@ var up = {
       for (const f of [findClaudeSession(home, projectDir, sessionId, ctx.io.env), findCodexSession(home, projectDir, sessionId, ctx.io.env)]) if (f) found.push(f);
       if (sessionId && !found.length) throw new CliError(`no Claude Code or Codex session ${sessionId} for ${projectDir}`, "leave out --session to take the latest one");
     }
+    let memory2 = null;
+    const memDir = bool(ctx.args, "no-memory") ? null : findClaudeMemory(home, projectDir, ctx.io.env);
+    if (memDir) {
+      try {
+        memory2 = await packMemory(memDir, projectDir, podPath);
+      } catch (e) {
+        if (!(e instanceof TooLargeError)) throw e;
+        ui2.err(ui2.ce("warn", `Claude Code's memory for this project is over ${bytes(UPLOAD_LIMIT)} packed: not sent`));
+      }
+    }
     const sessions = [];
     for (const f of found) {
       try {
@@ -9070,6 +9160,15 @@ var up = {
     let envSent = null;
     const envFile = str(ctx.args, "env");
     if (envFile) envSent = await ui2.spin(`sending ${envFile} as secrets`, sendDotenv(ctx, envFile, pod.id));
+    let memorySent;
+    if (memory2) {
+      try {
+        await ui2.spin(`sending Claude Code's memory (${memory2.count} file${memory2.count === 1 ? "" : "s"})`, ctx.api.upload(pod.id, memory2.podDir, memory2.archive));
+        memorySent = memory2.sent;
+      } catch (e) {
+        ui2.err(ui2.ce("warn", `couldn't send the memory: ${e.message}`));
+      }
+    }
     const sent = [];
     const resumed = [];
     for (const p of sessions) {
@@ -9099,7 +9198,7 @@ var up = {
     } catch {
       based = false;
     }
-    const state = { gateway: ctx.cfg.gateway, podId: pod.id, podName: pod.spec.name, dir: podDir, at: Date.now(), ...sent.length ? { sessions: sent } : {} };
+    const state = { gateway: ctx.cfg.gateway, podId: pod.id, podName: pod.spec.name, dir: podDir, at: Date.now(), ...sent.length ? { sessions: sent } : {}, ...memorySent ? { memory: memorySent } : {} };
     writeState(projectDir, state);
     if (ctx.json) {
       return ui2.json({ pod, dir: podDir, bytes: packed.archive.length, files: packed.files, skipped: packed.skipped, config: config?.parts ?? [], baseSet: based, sessions: resumed, secrets: envSent });
@@ -9112,6 +9211,7 @@ var up = {
       ui2.out(`secrets for ${pod.spec.name}: ${envSent.sent.length ? envSent.sent.join(", ") : "none"}${envSent.skipped.length ? ui2.c("dim", ` (skipped: ${envSent.skipped.join(", ")})`) : ""}`);
       for (const f of envSent.failed) ui2.err(ui2.ce("warn", `not sent: ${f}`));
     }
+    if (memorySent) ui2.out(`memory: ${Object.keys(memorySent.files).length} file(s) of Claude Code's memory for this project`);
     for (const r of resumed) {
       ui2.out(`conversation: ${r.command}${r.running ? ui2.c("dim", ` \xB7 resuming in the pod (cd ~/${podDir})`) : ui2.c("dim", ` \xB7 sent; in the pod: cd ~/${podDir} && ${r.command}`)}`);
     }
@@ -9136,8 +9236,35 @@ async function downSessions(ctx, root, state, pod, quiet2 = false) {
     }
   }
   if (state.sessions?.length) writeState(root, { ...state, sessions: next });
-  if (!quiet2 && !ctx.json) printSessions(ctx, out);
-  return out;
+  let memory2 = null;
+  if (state.memory) {
+    try {
+      const x = await ctx.api.exportAgentMemory(pod.id, state.dir);
+      memory2 = bringBackMemory(state.memory, x.files.map((f) => ({ path: f.path, body: Buffer.from(f.b64, "base64") })));
+      writeState(root, { ...readState(root, state), memory: memory2.sent });
+    } catch (e) {
+      if (!(e instanceof ApiError && e.status === 404)) ctx.ui.err(ctx.ui.ce("warn", `couldn't bring Claude Code's memory back: ${e.message}`));
+    }
+  }
+  if (!quiet2 && !ctx.json) {
+    printSessions(ctx, out);
+    printMemory(ctx, memory2);
+  }
+  return { convo: out, memory: memory2 };
+}
+function readState(root, fallback) {
+  try {
+    return JSON.parse(readFileSync5(statePath(root), "utf8"));
+  } catch {
+    return fallback;
+  }
+}
+function printMemory(ctx, m) {
+  if (!m) return;
+  const n2 = m.added.length + m.updated.length;
+  if (!n2 && !m.conflicts.length) return ctx.ui.out(ctx.ui.c("dim", "memory: nothing new in the pod"));
+  if (n2) ctx.ui.out(`memory: ${[m.added.length ? `${m.added.length} new` : "", m.updated.length ? `${m.updated.length} updated` : ""].filter(Boolean).join(", ")} from the pod`);
+  for (const c of m.conflicts) ctx.ui.out(`memory: ${c.file} changed here and in the pod; yours kept, the pod's saved as ${c.savedAs}`);
 }
 function printSessions(ctx, list2) {
   for (const r of list2) {
@@ -9259,11 +9386,13 @@ ${check.stderr.trim()}`, "commit or stash local edits to those files, or look wi
     } catch {
       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: files2, outside, refused, applied: true, acked, sessions: convo });
+    const back = takeSessions && found ? await downSessions(ctx, found.root, found.state, pod, true) : { convo: [], memory: null };
+    const convo = back.convo;
+    if (ctx.json) return ui2.json({ pod: pod.id, base, files: files2, outside, refused, applied: true, acked, sessions: convo, memory: back.memory && { added: back.memory.added, updated: back.memory.updated, conflicts: back.memory.conflicts } });
     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);
+    printMemory(ctx, back.memory);
   }
 };
 
@@ -10062,10 +10191,10 @@ var 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",
+  summary: "several agents, each in its own pod, on one task. missions: 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.",
+    "the mission says how the crew works. 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).",
@@ -10095,7 +10224,7 @@ var crew = {
       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"] }
+        { head: ["crew", "mission", "", "task"] }
       );
       return;
     }
@@ -10130,7 +10259,7 @@ var crew = {
         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(", ")}`);
+    if (!KINDS.includes(first)) throw new UsageError(`"${first}" isn't a mission or an action`, `missions: ${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>"`);
@@ -10402,7 +10531,7 @@ var TOOLS = [
   },
   {
     name: "pod_down",
-    description: "Apply a pod\u2019s work to the local repo as a git patch, with the CLI\u2019s safety checks (refuses symlinks and paths outside the repo; all or nothing). Look with pod_diff first and tell the user about risky files.",
+    description: "Apply a pod\u2019s work to the local repo as a git patch (and bring back the conversation and Claude Code\u2019s memory that up sent), with the CLI\u2019s safety checks (refuses symlinks and paths outside the repo; all or nothing). Look with pod_diff first and tell the user about risky files.",
     inputSchema: obj({ pod: s("pod name or id (default: the pod from airgate up in dir)"), dir: s("the local project directory (default: where the server started)") }),
     async call(ctx, a) {
       const argv = ["--yes"];
@@ -10445,7 +10574,7 @@ var TOOLS = [
   },
   {
     name: "pod_up",
-    description: "Move the local project into a pod: its files (git-tracked and untracked-but-not-ignored), and by default the latest Claude Code / Codex conversation here, which resumes in the pod. Launches a new pod named after the folder unless pod is given. Bring the work back later with pod_diff / pod_down.",
+    description: "Move the local project into a pod: its files (git-tracked and untracked-but-not-ignored), and by default the latest Claude Code / Codex conversation here, which resumes in the pod, plus Claude Code\u2019s memory for the project. Launches a new pod named after the folder unless pod is given. Bring the work back later with pod_diff / pod_down.",
     inputSchema: obj({
       dir: s("the local project directory (default: where the server started)"),
       pod: s("send into this existing pod instead of launching one"),
@@ -10561,7 +10690,7 @@ var TOOLS = [
   },
   {
     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).",
+    description: "Start a crew: several agents, each in its own pod, on one task, run by airgate (it keeps going without you). kind is the mission: 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"] }),

package/package.json

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