kaizen-agent 1.36.1 → 1.37.0

package/README.md

@@ -48,7 +48,7 @@ curl -fsSL https://bun.sh/install | bash && ~/.bun/bin/bunx kaizen-agent
 
 Already have Bun? Run `bunx kaizen-agent`.
 
-You also need an AI coding agent such as [Claude Code](https://docs.claude.com/en/docs/claude-code), and Git for the board's commit and push.
+kaizen needs an AI coding agent such as [Claude Code](https://docs.claude.com/en/docs/claude-code). If none is installed, the installer lets you pick one, runs its official installer after you say yes, and then carries on. Git is needed for the board's commit and push.
 
 ### Windows
 
@@ -58,7 +58,7 @@ Windows support is still in beta. In PowerShell:
 irm bun.sh/install.ps1 | iex; & "$env:USERPROFILE\.bun\bin\bunx.exe" kaizen-agent
 ```
 
-Already have Bun? Run `bunx kaizen-agent`. As on macOS and Linux you need an AI coding agent; Git is only needed for the board's commit and push.
+Already have Bun? Run `bunx kaizen-agent`. As on macOS and Linux, the installer offers to install an AI coding agent when none is found; Git is only needed for the board's commit and push.
 
 ## Use the board
 

package/cli/install.test.ts

@@ -159,3 +159,63 @@ it("init's gitignore keeps run state and personal notes out, the docs vault in",
     expect(ignored(".kaizen/notes/Project/Archive/Old.md")).toBe(false);
   } finally { rmSync(proj, { recursive: true, force: true }); }
 });
+
+// A box with no agent: the picker installs the chosen one with its official command and
+// the kaizen install carries on in the same run. `curl` is a fake that hands back a
+// script dropping a stub `claude` in ~/.local/bin, as the real installer does; nothing
+// reaches the network.
+const noAgentBox = () => {
+  const root = mkdtempSync(join(tmpdir(), "kz-noagent-"));
+  const home = join(root, "home"), pkg = join(root, "pkg"), bin = join(root, "bin");
+  mkdirSync(home); mkdirSync(bin);
+  const src = dirname(dirname(import.meta.path));
+  for (const d of ["cli", "skills", "agents", "commands", "web", "package.json"]) {
+    cpSync(join(src, d), join(pkg, d), { recursive: true, filter: (p) => !p.includes("node_modules") });
+  }
+  for (const t of ["sh", "bash", "mkdir", "chmod", "cat"]) { const w = Bun.which(t); if (w) symlinkSync(w, join(bin, t)); }
+  symlinkSync(process.execPath, join(bin, "bun"));
+  writeFileSync(join(bin, "curl"), `#!/bin/sh\necho "curl $*" >> "$HOME/curl.log"\nprintf 'mkdir -p "$HOME/.local/bin"\\nprintf "#!/bin/sh\\\\nexit 0\\\\n" > "$HOME/.local/bin/claude"\\nchmod +x "$HOME/.local/bin/claude"\\n'\n`, { mode: 0o755 });
+  const env = { PATH: bin, HOME: home, USERPROFILE: home, TMPDIR: root, TERM: "xterm" };
+  return { root, home, pkg, env };
+};
+
+it.skipIf(typeof (Bun as any).Terminal !== "function")("no agent: the picked agent is installed after a yes, and the kaizen install goes on", async () => {
+  const { root, home, pkg, env } = noAgentBox();
+  let out = "";
+  const answered = new Set<string>();
+  const proc = Bun.spawn([process.execPath, join(pkg, "cli", "install.ts"), "--global"], {
+    cwd: home, env,
+    terminal: { cols: 160, rows: 40, data: (_t: unknown, d: Uint8Array) => { out += new TextDecoder().decode(d); } },
+  } as any);
+  const answer = (prompt: string, keys: string) => {
+    if (!answered.has(prompt) && out.includes(prompt)) { answered.add(prompt); (proc as any).terminal.write(keys); }
+  };
+  const until = Date.now() + 30_000;
+  try {
+    while (Date.now() < until && !out.includes("to install, or")) {
+      answer("Which one would you like to install?", "\r");
+      answer("Install Claude Code now?", "\r");
+      answer("Start Claude Code now to sign in?", "\x1b[B\r");
+      await Bun.sleep(100);
+    }
+    expect(out).toContain("curl -fsSL https://claude.ai/install.sh | bash");
+    expect(readFileSync(join(home, "curl.log"), "utf8")).toContain("https://claude.ai/install.sh");
+    expect(out).toContain("installed Claude Code");
+    expect(existsSync(join(home, ".local", "bin", "claude"))).toBe(true);
+    expect(out).toContain("to install, or");   // the kaizen install went on, no rerun
+  } finally {
+    proc.kill();
+    await proc.exited;
+    rmSync(root, { recursive: true, force: true });
+  }
+}, 40_000);
+
+it("no agent, no terminal: the list is printed and nothing is installed", () => {
+  const { root, home, pkg, env } = noAgentBox();
+  const p = Bun.spawnSync([process.execPath, join(pkg, "cli", "install.ts")], { cwd: home, env });
+  const ran = existsSync(join(home, "curl.log"));
+  rmSync(root, { recursive: true, force: true });
+  expect(p.exitCode).toBe(0);
+  expect(p.stdout.toString()).toContain("Install one, then run this again.");
+  expect(ran).toBe(false);
+});

package/cli/install.ts

@@ -54,25 +54,30 @@ const SKILLS = ["kaizen", "kaizen-help", "story-deck", "story-video"];
 // commands/ are Claude Code's own formats and go nowhere else.
 const AGENTS = [
   { name: "Claude Code", dir: ".claude", cmd: "claude", full: true,
-    docs: "https://docs.claude.com/en/docs/claude-code" },
+    docs: "https://docs.claude.com/en/docs/claude-code",
+    install: { posix: "curl -fsSL https://claude.ai/install.sh | bash", win32: "irm https://claude.ai/install.ps1 | iex" } },
   { name: "Codex", dir: ".codex", cmd: "codex", full: false,
-    docs: "https://github.com/openai/codex" },
+    docs: "https://github.com/openai/codex",
+    install: { posix: "npm install -g @openai/codex", win32: "npm install -g @openai/codex" } },
   { name: "Antigravity", dir: ".agents", cmd: "agy", full: false,
     docs: "https://antigravity.google" },
   { name: "OpenCode", dir: ".opencode", cmd: "opencode", full: false,
-    docs: "https://opencode.ai" },
+    docs: "https://opencode.ai",
+    install: { posix: "curl -fsSL https://opencode.ai/install | bash", win32: "npm install -g opencode-ai" } },
   { name: "Cursor", dir: ".cursor", cmd: "cursor", full: false,
     docs: "https://cursor.com" },
   { name: "Gemini CLI", dir: ".gemini", cmd: "gemini", full: false,
-    docs: "https://github.com/google-gemini/gemini-cli" },
-];
+    docs: "https://github.com/google-gemini/gemini-cli",
+    install: { posix: "npm install -g @google/gemini-cli", win32: "npm install -g @google/gemini-cli" } },
+] as { name: string; dir: string; cmd: string; full: boolean; docs: string; install?: { posix: string; win32: string } }[];
 
 // An agent counts as present if it has a directory or a command. The directory
 // alone misses someone who installed the agent and has not run it yet; the command
 // alone misses one that is not on this shell's PATH.
-const onPath = new Set(
-  AGENTS.filter((a) => Bun.which(a.cmd)).map((a) => a.dir),
-);
+// Recomputed after kaizen installs an agent, so the install carries on in the same run.
+// PATH passed explicitly: Bun.which does not see later edits to process.env.PATH.
+const detect = () => new Set(AGENTS.filter((a) => Bun.which(a.cmd, { PATH: process.env.PATH })).map((a) => a.dir));
+let onPath = detect();
 const found = (r: string) =>
   AGENTS.filter((a) => existsSync(join(r, a.dir)) || onPath.has(a.dir));
 
@@ -308,38 +313,83 @@ function removeLink(p: string) {
 // nothing, so send them to the agent first rather than laying out files no reader
 // will ever load.
 if (!found(home).length && !args.has("--force")) {
-  await noAgent();
-  process.exit(0);
+  if (!(await noAgent())) process.exit(0);
 }
 
-async function noAgent() {
+// Returns true once an agent is installed and found, so the kaizen install goes on.
+async function noAgent(): Promise<boolean> {
   console.log(`  ${c.bold("No AI coding agent found on this machine.")}\n`);
   console.log(`  ${c.dim("kaizen is a workflow that an agent runs — it plans, you approve, it builds,")}`);
   console.log(`  ${c.dim("and a second agent reviews. So an agent has to be installed first.")}\n`);
 
-  if (!interactive) {
+  const list = () => {
     for (const a of AGENTS) console.log(`    ${a.name.padEnd(14)} ${a.docs}`);
     console.log(`\n  ${c.dim("Install one, then run this again.")}`);
-    return;
-  }
+  };
+  if (!interactive) { list(); return false; }
 
   const pick = await select("Which one would you like to install?", [
     ...AGENTS.map((a) => ({ label: a.name, hint: a.docs, value: a as (typeof AGENTS)[number] | null })),
     { label: "None of these — just show me the list", hint: "", value: null },
   ]);
+  if (!pick) { list(); return false; }
+
+  const docs = async (why = "") => {
+    if (why) console.log(`  ${why}`);
+    console.log(`  ${c.bold(pick.name)}`);
+    console.log(`  ${c.cyan(pick.docs)}\n`);
+    const opened = await openUrl(pick.docs);
+    console.log(opened
+      ? `  ${c.dim("Opened in your browser. Install it, then run")} ${c.cyan("kaizen")} ${c.dim("again.")}`
+      : `  ${c.dim("Open that page to install it, then run")} ${c.cyan("kaizen")} ${c.dim("again.")}`);
+    return false;
+  };
 
-  if (!pick) {
-    for (const a of AGENTS) console.log(`    ${a.name.padEnd(14)} ${a.docs}`);
-    console.log(`\n  ${c.dim("Install one, then run this again.")}`);
-    return;
+  const win = process.platform === "win32";
+  const cmd = pick.install?.[win ? "win32" : "posix"];
+  if (!cmd) return docs();
+  if (cmd.startsWith("npm ") && !Bun.which("npm")) return docs(c.dim(`${pick.name} installs with npm, which needs Node.js: https://nodejs.org`));
+
+  console.log(`\n  ${c.dim("Official installer:")} ${c.cyan(cmd)}`);
+  if (!(await select(`Install ${pick.name} now?`, [
+    { label: "Yes", hint: "run the command above", value: true },
+    { label: "No", hint: "open the docs page instead", value: false },
+  ]))) return docs();
+
+  // ponytail: sh/powershell straight from the vendor's one-liner; no sudo, a failure falls back to the docs.
+  const code = Bun.spawnSync(win ? ["powershell", "-NoProfile", "-Command", cmd] : ["sh", "-c", cmd],
+    { stdio: ["inherit", "inherit", "inherit"] }).exitCode;
+  addInstallerBins();
+  onPath = detect();
+  const bin = Bun.which(pick.cmd, { PATH: process.env.PATH });
+  if (code !== 0 || !bin) {
+    return docs(code !== 0
+      ? `${c.bold("The install did not finish")} ${c.dim(`(exit ${code}).`)}`
+      : `${c.bold(`${pick.name} installed, but`)} ${c.cyan(pick.cmd)} ${c.bold("is not on PATH yet.")} ${c.dim("Open a new terminal and run kaizen again.")}`);
   }
+  step(`installed ${pick.name}`);
+
+  if (await select(`Start ${pick.name} now to sign in?`, [
+    { label: "Yes", hint: "exit the agent once you are signed in, and kaizen carries on", value: true },
+    { label: "Later", hint: `run ${pick.cmd} yourself before your first run`, value: false },
+  ])) Bun.spawnSync([bin], { stdio: ["inherit", "inherit", "inherit"] });
+  console.log();
+  return true;
+}
 
-  console.log(`  ${c.bold(pick.name)}`);
-  console.log(`  ${c.cyan(pick.docs)}\n`);
-  const opened = await openUrl(pick.docs);
-  console.log(opened
-    ? `  ${c.dim("Opened in your browser. Install it, then run")} ${c.cyan("kaizen")} ${c.dim("again.")}`
-    : `  ${c.dim("Open that page to install it, then run")} ${c.cyan("kaizen")} ${c.dim("again.")}`);
+// The vendors' installers drop the binary in a folder the running shell may not have
+// on PATH yet; add the usual ones so Bun.which sees the new agent.
+function addInstallerBins() {
+  const dirs = [join(home, ".local", "bin"), join(home, ".opencode", "bin")];
+  if (Bun.which("npm")) {
+    try {
+      const prefix = Bun.spawnSync(["npm", "prefix", "-g"]).stdout.toString().trim();
+      if (prefix) dirs.push(process.platform === "win32" ? prefix : join(prefix, "bin"));
+    } catch {}
+  }
+  const sep = process.platform === "win32" ? ";" : ":";
+  const have = (process.env.PATH ?? "").split(sep);
+  process.env.PATH = [...dirs.filter((d) => existsSync(d) && !have.includes(d)), ...have].join(sep);
 }
 
 // Best effort: a headless box or a locked-down desktop has no opener, and the URL

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaizen-agent",
-  "version": "1.36.1",
+  "version": "1.37.0",
   "description": "Staged workflow for AI agents — code, writing, research, operations: plan, human approval, build, independent review, bounded fix loop.",
   "type": "module",
   "bin": {