kaizen-agent 0.1.1 → 0.3.0

package/README.md

@@ -29,9 +29,13 @@ cd ~/kaizen && bun run cli/install.ts
 
 Flags, either way:
 
+Run interactively with no flags and it asks where to install, as an arrow-key
+choice; piped or scripted runs take the global install without asking.
+
 | Flag | Effect |
 |---|---|
-| *(none)* | Install for every project, into `~/.claude/` |
+| *(none)* | Ask, defaulting to every project (`~/.claude/`) |
+| `--global` | Every project, no question asked |
 | `--project` | Install into `.claude/` in the current directory only |
 | `--check` | Report what is linked and exit non-zero if anything is missing |
 | `--force` | Replace a real file sitting where a link belongs |

package/cli/install.ts

@@ -60,8 +60,77 @@ function linkState(src: string, dest: string) {
 const args = new Set(Bun.argv.slice(2));
 const check = args.has("--check");
 const force = args.has("--force");
-const root = args.has("--project") ? process.cwd() : home;
-const base = join(root, ".claude");
+const base = join(await chooseRoot(), ".claude");
+
+async function chooseRoot() {
+  if (args.has("--project")) return process.cwd();
+  if (args.has("--global") || check) return home;
+
+  // Only ask when there is someone to answer. Piped, scripted, or CI runs take the
+  // global install silently rather than hanging on a prompt nobody sees.
+  if (!process.stdin.isTTY) return home;
+
+  const choice = await select("Install where?", [
+    { label: "Every project", hint: join(home, ".claude"), value: home },
+    { label: "This one only", hint: join(process.cwd(), ".claude"), value: process.cwd() },
+  ]);
+  return choice;
+}
+
+// Arrow-key picker. Raw mode delivers keys unbuffered, one escape sequence at a
+// time; the alternative is a dependency for forty lines of escape codes.
+async function select<T>(question: string, options: { label: string; hint: string; value: T }[]) {
+  const { stdin, stdout } = process;
+  let active = 0;
+
+  const draw = (first: boolean) => {
+    if (!first) stdout.write(`\x1b[${options.length}A`); // back up over the list
+    for (const [i, o] of options.entries()) {
+      const on = i === active;
+      stdout.write(
+        `\x1b[2K  ${on ? "\x1b[36m>\x1b[0m" : " "} ${on ? "\x1b[1m" : "\x1b[2m"}${o.label}\x1b[0m` +
+          `  \x1b[2m${o.hint}\x1b[0m\n`,
+      );
+    }
+  };
+
+  stdout.write(`\n\x1b[1m${question}\x1b[0m  \x1b[2m(arrows, enter)\x1b[0m\n`);
+  stdout.write("\x1b[?25l"); // hide cursor
+  draw(true);
+  stdin.setRawMode(true);
+  stdin.resume();
+
+  try {
+    outer: for await (const chunk of stdin) {
+      // A chunk can hold more than one keypress -- an arrow and the enter behind
+      // it arrive together when input is piped -- so walk it rather than
+      // comparing the whole thing to one key.
+      const keys = chunk.toString();
+      for (let i = 0; i < keys.length; i++) {
+        const rest = keys.slice(i);
+        if (rest.startsWith("\x03")) {                  // ctrl-c
+          stdout.write("\ncancelled\n");
+          process.exit(130);
+        }
+        if (rest.startsWith("\r") || rest.startsWith("\n")) break outer;
+        if (rest.startsWith("\x1b[A") || rest.startsWith("\x1b[B")) {
+          active = rest[2] === "A"
+            ? (active - 1 + options.length) % options.length
+            : (active + 1) % options.length;
+          i += 2;
+        } else if (rest.startsWith("k")) active = (active - 1 + options.length) % options.length;
+        else if (rest.startsWith("j")) active = (active + 1) % options.length;
+        else continue;
+        draw(false);
+      }
+    }
+  } finally {
+    stdin.setRawMode(false);
+    stdin.pause();
+    stdout.write("\x1b[?25h\n"); // show cursor again
+  }
+  return options[active]!.value;
+}
 
 let bad = 0;
 for (const [src, sub] of links) {
@@ -91,4 +160,5 @@ if (check) {
   process.exit(bad ? 1 : 0);
 }
 console.log(`\nInstalled into ${base}. Restart Claude Code: skills load live, slash commands only on session start.`);
+console.log(`Then, in a repository you want to use it on: /kaizen-init`);
 if (bad) process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaizen-agent",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Staged AI development workflow: plan, human approval, implement, independent review, bounded fix loop.",
   "type": "module",
   "bin": {