kaizen-agent 1.22.1 → 1.23.0

package/cli/settings.ts

@@ -117,6 +117,7 @@ const SETTINGS: Setting[] = [
   { key: "dictation.model", label: "Dictation model", group: "Board", values: ["tiny", "base", "small", "large-v3-turbo"], help: "Whisper model the web board dictates with, in the browser. tiny ~60 MB rough; base ~165 MB English-leaning; small ~410 MB accurate across languages; large-v3-turbo ~1.5 GB best, needs a capable GPU. Downloaded once on the next mic press" },
   { key: "sources.every", label: "Gather requests", group: "Board", values: ["off", "1h", "6h", "24h"], help: "How often the board checks your request sources for new ideas while it is running. off: only when you press Gather now" },
   { key: "board.projects_dir", label: "Projects folder", group: "Board", values: [], text: true, folder: true, help: `A folder your projects live in, e.g. ${process.platform === "win32" ? join(homedir(), "Projects") : "~/Projects"}. Every folder inside it appears in the board's project list, ready to choose; choosing one sets it up. Empty: only projects kaizen already knows` },
+  { key: "board.open", label: "Open the board in", group: "Board", values: ["browser", "app"], help: "browser: a tab in your default browser. app: a Chrome, Edge or Brave window with no tabs or address bar, like a desktop app; your default browser when none is installed" },
   { key: "ui.mouse", label: "Enable mouse", group: "Terminal", values: ["false", "true"], help: "Click to select, click again to act. While on, the terminal cannot select text with the mouse" },
 ];
 

package/cli/state.test.ts

@@ -463,6 +463,26 @@ test("nativePath on Windows reads the spellings Git Bash writes into the project
   } finally { Object.defineProperty(process, "platform", platform); }
 });
 
+test("findTerminal on macOS opens $TERMINAL as an app; iTerm through a script", () => {
+  const keys = ["PATH", "TERMINAL", "TMUX", "HERDR_ENV"];
+  const saved = keys.map((k) => process.env[k]);
+  const platform = Object.getOwnPropertyDescriptor(process, "platform")!;
+  try {
+    Object.defineProperty(process, "platform", { value: "darwin" });
+    process.env.PATH = mkdtempSync(join(tmpdir(), "kz-empty-"));
+    delete process.env.TMUX; delete process.env.HERDR_ENV;
+    process.env.TERMINAL = "Ghostty";
+    expect(findTerminal("/p", ["claude", "x"])!.cmd).toEqual(["open", "-na", "Ghostty", "--args", "--working-directory=/p", "-e", "claude", "x"]);
+    process.env.TERMINAL = "iTerm";
+    const i = findTerminal("/p", ["claude", "x"])!;
+    expect(i.cmd[2]).toContain('create window with default profile command');
+    expect(i.cmd.slice(4)).toEqual(["'/p'", "'claude' 'x'"]);
+  } finally {
+    Object.defineProperty(process, "platform", platform);
+    keys.forEach((k, i) => (saved[i] === undefined ? delete process.env[k] : (process.env[k] = saved[i])));
+  }
+});
+
 test("findTerminal on Windows names cmd and PowerShell by full path, so a PATH without System32 still launches", () => {
   const keys = ["PATH", "ComSpec", "SystemRoot", "windir"];
   const saved = keys.map((k) => process.env[k]);

package/cli/state.ts

@@ -210,13 +210,26 @@ if ($o -match '"pane_id":"([^"]*)"') { & ${q(herdr)} pane run $Matches[1] ${q(ty
     return { cmd: ["tmux", "new-window", "-c", cwd, ...fullCmd], detached: false };
   }
 
-  if (process.env.TERMINAL && Bun.which(process.env.TERMINAL)) {
-    const term = process.env.TERMINAL;
-    if (term.includes("kitty")) return { cmd: [term, "--directory", cwd, ...fullCmd], detached: true };
-    if (term.includes("alacritty")) return { cmd: [term, "--working-directory", cwd, "-e", ...fullCmd], detached: true };
-    if (term.includes("ghostty")) return { cmd: [term, `--working-directory=${cwd}`, "-e", ...fullCmd], detached: true };
-    if (term.includes("foot")) return { cmd: [term, "-D", cwd, ...fullCmd], detached: true };
-    return { cmd: [term, "-e", ...fullCmd], detached: true };
+  // $TERMINAL: a command on PATH, or on macOS an app's name (TERMINAL=Ghostty, iTerm).
+  const term = process.env.TERMINAL;
+  if (term) {
+    const t = term.toLowerCase();
+    const args = t.includes("kitty") ? ["--directory", cwd, ...fullCmd]
+      : t.includes("alacritty") ? ["--working-directory", cwd, "-e", ...fullCmd]
+      : t.includes("ghostty") ? [`--working-directory=${cwd}`, "-e", ...fullCmd]
+      : t.includes("wezterm") ? ["start", "--cwd", cwd, "--", ...fullCmd]
+      : t.includes("foot") ? ["-D", cwd, ...fullCmd]
+      : ["-e", ...fullCmd];
+    if (process.platform !== "darwin") { if (Bun.which(term)) return { cmd: [term, ...args], detached: true }; }
+    else if (t.includes("iterm")) {
+      // iTerm takes a command line, not argv: the line goes into a one-shot script, as
+      // with Terminal below, and iTerm runs `sh <path>`.
+      const script = `f=$(mktemp) && printf 'rm -f "$0"\\n{ cd %s || (exit 127); } && %s\\n${hold}\\n' "$1" "$2" > "$f" && osascript -e "tell application \\"iTerm\\" to create window with default profile command \\"sh $f\\"" -e 'tell application "iTerm" to activate'`;
+      return { cmd: ["/bin/sh", "-c", script, "sh", shq(cwd), line], detached: true };
+    }
+    // On macOS a terminal is an app, started through open (Ghostty's binary cannot open
+    // a window itself). -n: a new instance, so the args reach it when it is already open.
+    else return { cmd: ["open", "-na", term, "--args", ...args], detached: true };
   }
 
   if (hasDisplay && Bun.which("xdg-terminal-exec")) {

package/cli/web.ts

@@ -676,6 +676,11 @@ export async function web(repoDir: string, opts: Opts = {}) {
 // A profile folder gives the window a browser instance of its own (Kaizen Bot's app);
 // on macOS that takes -n, as `open` otherwise hands the args to a running browser.
 export async function openApp(url: string, profile?: string) {
+  // Kaizen Bot's window (a profile) is always an app; the board asks the setting.
+  if (!profile) {
+    const { listSettings } = await import("./settings.ts");
+    if (listSettings(join(import.meta.dir, "..")).rows.find((r) => r.key === "board.open")?.value !== "app") return openDefault(url);
+  }
   const args = [`--app=${url}`, ...(profile ? [`--user-data-dir=${profile}`] : [])];
   const chromes = process.platform === "darwin"
     ? ["Google Chrome", "Chromium", "Microsoft Edge", "Brave Browser"]
@@ -697,6 +702,10 @@ export async function openApp(url: string, profile?: string) {
       }
     }
   } catch { /* fall through to a plain tab */ }
+  return openDefault(url);
+}
+
+async function openDefault(url: string) {
   // `start` is a cmd builtin, not a program, so it has to go through cmd.
   if (process.platform === "win32") {
     try { await Bun.$`${cmdExe()} /c start "" ${url}`.quiet(); return true; } catch { return false; }

package/package.json

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

package/skills/kaizen/config.default.yml

@@ -178,6 +178,9 @@ board:
   # not itself a project (no .git, no package.json) is read as a group, and the
   # folders inside it are offered too.
   projects_dir: ""
+  # Where `kaizen web` opens the board: browser (a tab in your default browser) or
+  # app (a Chrome, Edge or Brave window with no tabs or address bar).
+  open: browser
 
 sources:
   # How often the web board checks your request sources (links added in the board's