gearbox-code 0.1.6 → 0.1.8

package/README.md

@@ -1,111 +1,93 @@
-# ⚙ gearbox
+# gearbox
 
-A beautiful, simple coding harness for the terminal. It reads, edits, and runs your code through one clean agent loop, talking to any provider (Anthropic, OpenAI, Google, DeepSeek).
+## Install
 
-> **What it does:** the point of Gearbox is *intelligent per-task model routing* — automatically using the right model for each task across every provider and account you pay for, cheaply and transparently. Basic routing is live: it classifies each task, filters candidates by quality bar, and picks the cheapest one that fits. The richer engine (shadow-eval, credit/limit scoring, confidence display) layers on top. See [`DESIGN.md`](./DESIGN.md).
+macOS, Linux, WSL:
 
+```bash
+curl -fsSL https://unpkg.com/gearbox-code@latest/install.sh | bash
 ```
- ⚙   gearbox
-     coding harness · sonnet-4.6
- ──────────────────────────────────────────────────────────
-
- › add a --json flag to the CLI and cover it with a test
 
- ⏺  I'll see how args are parsed, add the flag, then test it.
+Windows PowerShell:
 
-   ✓ read_file  src/cli.tsx
-     renders the Ink app · 18 lines
-   ✓ edit_file  src/cli.tsx
-   ✓ run_shell  bun test
-     9 pass · 0 fail
-
- ⏺  Done — flag added with a passing test.
-
- ╭──────────────────────────────────────────────────────────╮
- │ › ask gearbox to build or fix something                  │
- ╰──────────────────────────────────────────────────────────╯
-  gearbox · sonnet-4.6 · 18,432 tok · ⏎ send  ctrl+c quit
+```powershell
+irm https://unpkg.com/gearbox-code@latest/install.ps1 | iex
 ```
 
-## Run
+These installers do not use `sudo`, admin privileges, or `npm install -g`.
+They install Gearbox into a user-owned directory, create the `gearbox` command,
+then start onboarding before the coding app opens.
+
+Run without installing:
 
 ```bash
-bun install
-gearbox auth add <api-key>     # paste-detects common providers when possible
-# or: gearbox auth add <provider> <api-key>
-# or: gearbox auth import      # import keys from env/cloud credentials
-bun start                      # or: bun run src/cli.tsx
-bun start -- --model gemini-flash   # pick a model
+npx gearbox-code@latest
 ```
 
-No provider configured? Gearbox opens a setup screen and will not run a fake model. Preview the look without running anything:
+## First Run
+
+Gearbox needs one provider account before it opens the coding app. The installer
+runs setup automatically. You can also run it yourself:
 
 ```bash
-bun run scripts/preview.tsx
+gearbox onboard
 ```
 
-## Install
-
-One command, no sudo, no npm global permissions:
+Common setup commands:
 
 ```bash
-curl -fsSL https://unpkg.com/gearbox-code@latest/install.sh | bash
+gearbox auth add <api-key>                # auto-detects known key prefixes
+gearbox auth add <provider> <api-key>     # anthropic, openai, google, deepseek, openrouter, groq, xai, mistral...
+gearbox auth import                       # import credentials from env/cloud config
+gearbox auth providers                    # list supported providers
 ```
 
-The installer is served from the published npm package, downloads the latest
-`gearbox-code` tarball, and creates a user-owned `gearbox` command in
-`~/.local/bin`.
-
-Then:
+After setup:
 
 ```bash
-gearbox auth add <api-key>     # each person uses their own provider account
-cd ~/any/project && gearbox    # the current directory is the workspace
+cd ~/your-project
+gearbox
 ```
 
-If `~/.local/bin` is not on your PATH, the installer prints the exact line to
-add to your shell config.
+No account configured means no fake/demo model: Gearbox runs onboarding first.
 
-You can still run without installing:
+## Uninstall
+
+macOS, Linux, WSL:
 
 ```bash
-npx gearbox-code@latest
+rm -f ~/.local/bin/gearbox
+rm -rf ~/.local/share/gearbox
 ```
 
-**Upgrade** later by rerunning the install command. `gearbox upgrade` still works
-for git checkouts.
+Windows PowerShell:
 
-## Develop From Source
+```powershell
+Remove-Item "$env:LOCALAPPDATA\Gearbox" -Recurse -Force
+```
 
-Requires [Bun](https://bun.sh). Clone the repo, then:
+If you previously installed with npm global:
 
 ```bash
-bun install
-bun run src/cli.tsx
+npm uninstall -g gearbox-code
 ```
 
-**Standalone binary** (no clone/install on the target, same OS/arch):
+## What It Is
 
-```bash
-bun run build         # → dist/gearbox  (single ~64MB executable)
-cp dist/gearbox ~/.bun/bin/    # or anywhere on PATH; share the file directly
-```
+Gearbox is a terminal coding agent that can use the model accounts you already
+pay for. It supports provider accounts, local credential storage, model routing,
+session history, file edits, shell commands, and permission gates.
 
-> ⚠ **Before running on real code:** there is no permission/confirm gate yet — `write_file`, `edit_file`, `run_shell`, and the `!` prefix execute without asking. Fine for trusted internal use on your own repos; do not point it at anything you don't want modified. A confirm-gate is the next thing to land.
+Supported setup paths include API keys, detected env/cloud credentials, Azure,
+and provider CLIs where available.
 
 ## Develop
 
+Requires [Bun](https://bun.sh).
+
 ```bash
-bun test            # render + agent tests (no API key needed)
+bun install
+bun run src/cli.tsx
+bun test
 bun run typecheck
 ```
-
-## Principles
-
-- **Open + free.** MIT. No paid dependencies, no hosted backend, no telemetry. The only cost is your own model calls on your own keys.
-- **Beautiful + calm.** One accent color, generous spacing, consistent glyphs. The whole look lives in `src/ui/theme.ts`.
-- **Routing-ready.** Model choice happens in exactly one place (`src/model/selector.ts`); the router drops in there later with no changes upstream. See [`CLAUDE.md`](./CLAUDE.md).
-
-## Status
-
-v0.1 — streaming agent loop, real file + shell tools, a polished Ink TUI, multi-provider support, accounts + spend ledger, BM25 context retrieval, and basic per-task routing (classify → quality bar → cheapest winner). The richer routing engine (shadow-eval, credit/limit/plan scoring, per-repo calibration) is next (`DESIGN.md`).

package/dist/cli.mjs

@@ -63894,8 +63894,18 @@ var require_src6 = __commonJS((exports) => {
 });
 
 // src/proc.ts
+var exports_proc = {};
+__export(exports_proc, {
+  write: () => writeFile,
+  which: () => which,
+  spawnSyncProc: () => spawnSyncProc,
+  spawnProc: () => spawnProc,
+  readStream: () => readStream,
+  Glob: () => Glob
+});
 import { spawn, spawnSync as nodeSpawnSync, execFileSync } from "node:child_process";
 import { readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import { writeFile } from "node:fs/promises";
 import { resolve as resolve6 } from "node:path";
 function which(bin) {
   try {
@@ -64270,6 +64280,13 @@ var init_onboarding = __esm(() => {
 });
 
 // src/agent/cli-backend.ts
+var exports_cli_backend = {};
+__export(exports_cli_backend, {
+  subscriptionEnv: () => subscriptionEnv,
+  runCliTask: () => runCliTask,
+  parseCliLines: () => parseCliLines,
+  buildCliArgs: () => buildCliArgs
+});
 function newState() {
   return { text: "", usage: { inputTokens: 0, outputTokens: 0 }, rates: new Map, toolNames: new Map };
 }
@@ -64407,6 +64424,22 @@ function buildCliArgs(binary, prompt, opts = {}) {
     args.push("--resume", opts.sessionId);
   return args;
 }
+function parseCliLines(binary, lines, onEvent) {
+  const state = newState();
+  for (const line of lines) {
+    const t2 = line.trim();
+    if (!t2)
+      continue;
+    let obj;
+    try {
+      obj = JSON.parse(t2);
+    } catch {
+      continue;
+    }
+    mapCliEvent(binary, obj, state, onEvent);
+  }
+  return finalize(state);
+}
 function finalize(state) {
   return { messages: [], usage: state.usage, sessionId: state.sessionId, costUSD: state.costUSD, rates: [...state.rates.values()] };
 }
@@ -70267,7 +70300,8 @@ var import_react20 = __toESM(require_react(), 1);
 // node_modules/ink/build/hooks/use-focus-manager.js
 var import_react21 = __toESM(require_react(), 1);
 // src/cli.tsx
-import { execFileSync as execFileSync4 } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import { execFileSync as execFileSync4, spawnSync } from "node:child_process";
 import { resolve as resolve11 } from "node:path";
 import { existsSync as existsSync8 } from "node:fs";
 
@@ -121288,6 +121322,9 @@ function pickDefaultModel(preferredId) {
     return wanted;
   return MODELS.find((m2) => providerAvailable(m2.provider));
 }
+function anyProviderAvailable() {
+  return MODELS.some((m2) => providerAvailable(m2.provider));
+}
 
 // src/model/selector.ts
 class FixedSelector {
@@ -131808,7 +131845,7 @@ var uiMessagesSchema = lazyValidator3(() => zodSchema7(exports_external.array(ex
 })).nonempty("Messages array must not be empty")));
 
 // src/tools.ts
-import { readFile, writeFile, readdir, stat as stat2 } from "node:fs/promises";
+import { readFile, writeFile as writeFile2, readdir, stat as stat2 } from "node:fs/promises";
 import { existsSync as existsSync3 } from "node:fs";
 import { resolve as resolve7, relative, isAbsolute } from "node:path";
 // node_modules/diff/libesm/diff/base.js
@@ -132171,7 +132208,7 @@ function createTools(onEvent) {
         if (!await requestPermission({ kind: "write", title: exists ? "Overwrite a file" : "Create a file", detail: path }))
           throw new Error(DENIED);
         const before2 = exists ? await readFile(abs, "utf8") : "";
-        await writeFile(abs, content, "utf8");
+        await writeFile2(abs, content, "utf8");
         const diff2 = computeDiff(before2, content);
         return { summary: `wrote ${path} (${diffStat(diff2)})`, diff: diff2 };
       }
@@ -132187,7 +132224,7 @@ function createTools(onEvent) {
         if (!await requestPermission({ kind: "edit", title: "Edit a file", detail: path }))
           throw new Error(DENIED);
         const after2 = before2.replace(find2, replace2);
-        await writeFile(abs, after2, "utf8");
+        await writeFile2(abs, after2, "utf8");
         const diff2 = computeDiff(before2, after2);
         return { summary: `edited ${path} (${diffStat(diff2)})`, diff: diff2 };
       }
@@ -133686,6 +133723,235 @@ function ActivityRail({ items, width }) {
     ]
   }, undefined, true, undefined, this);
 }
+function SetupSplash({ state, width, skin, splashSize }) {
+  const providers = featuredApiKeyProviders().slice(0, width >= 92 ? 12 : 8);
+  const left = providers.filter((_, i2) => i2 % 2 === 0);
+  const right = providers.filter((_, i2) => i2 % 2 === 1);
+  const detected = state.importable.length + state.cloudImportable.length;
+  const panelWidth = Math.min(Math.max(width - 4, 12), 104);
+  const showTwoCols = panelWidth >= 82;
+  const firstColumn = showTwoCols ? left : providers;
+  const secondColumn = showTwoCols ? right : [];
+  const providerLine = (id, label) => /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+    color: color.dim,
+    children: [
+      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+        color: color.accent,
+        children: [
+          "/account add ",
+          id
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+        color: color.faint,
+        children: [
+          "  ",
+          label
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, id, true, undefined, this);
+  return /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+    flexDirection: "column",
+    alignItems: "center",
+    children: [
+      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(MascotSplash, {
+        skin,
+        size: splashSize
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+        marginTop: 1,
+        flexDirection: "column",
+        alignItems: "center",
+        children: [
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+            color: color.accent,
+            bold: true,
+            children: "GEARBOX"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+            color: color.text,
+            children: "one terminal, every model account you already pay for"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+            color: color.faint,
+            children: "Set up one provider. Gearbox routes from there."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+        marginTop: 1,
+        width: panelWidth,
+        borderStyle: "round",
+        borderColor: color.accentDim,
+        paddingX: 2,
+        paddingY: 1,
+        flexDirection: "column",
+        children: [
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+            justifyContent: "space-between",
+            children: [
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.text,
+                bold: true,
+                children: "start here"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: detected ? color.ok : color.faint,
+                children: detected ? `${detected} detected` : "no account yet"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          detected ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+            marginTop: 1,
+            children: [
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.ok,
+                children: [
+                  glyph.on,
+                  " "
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.text,
+                children: "Credentials found on this machine: "
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.accent,
+                children: "/account import"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this) : null,
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+            marginTop: 1,
+            flexDirection: showTwoCols ? "row" : "column",
+            children: [
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+                flexDirection: "column",
+                width: showTwoCols ? Math.floor((panelWidth - 6) / 2) : undefined,
+                children: [
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.faint,
+                    children: "API key"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.text,
+                    children: [
+                      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                        color: color.accent,
+                        children: "/account add <api-key>"
+                      }, undefined, false, undefined, this),
+                      "  auto-detect when possible"
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.text,
+                    children: /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                      color: color.accent,
+                      children: "/account add <provider> <api-key>"
+                    }, undefined, false, undefined, this)
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+                flexDirection: "column",
+                marginLeft: showTwoCols ? 4 : 0,
+                marginTop: showTwoCols ? 0 : 1,
+                children: [
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.faint,
+                    children: "Subscriptions and cloud"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.text,
+                    children: /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                      color: color.accent,
+                      children: "/account add azure <endpoint> <api-key>"
+                    }, undefined, false, undefined, this)
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.text,
+                    children: [
+                      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                        color: color.accent,
+                        children: "/account add claude"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                        color: color.faint,
+                        children: "  "
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                        color: color.accent,
+                        children: "/account add codex"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+            marginTop: 1,
+            children: /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.faint,
+              children: glyph.rule.repeat(Math.max(panelWidth - 6, 20))
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+            marginTop: 1,
+            flexDirection: showTwoCols ? "row" : "column",
+            children: [
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+                flexDirection: "column",
+                width: showTwoCols ? Math.floor((panelWidth - 6) / 2) : undefined,
+                children: [
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.faint,
+                    children: "Common providers"
+                  }, undefined, false, undefined, this),
+                  firstColumn.map((p) => providerLine(p.id, p.label))
+                ]
+              }, undefined, true, undefined, this),
+              secondColumn.length ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+                flexDirection: "column",
+                marginLeft: 4,
+                children: [
+                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                    color: color.faint,
+                    children: " "
+                  }, undefined, false, undefined, this),
+                  secondColumn.map((p) => providerLine(p.id, p.label))
+                ]
+              }, undefined, true, undefined, this) : null
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+            marginTop: 1,
+            justifyContent: "space-between",
+            children: [
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.faint,
+                children: "Full catalog: "
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.accent,
+                children: "/onboard providers"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.faint,
+                children: "  Help: "
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                color: color.accent,
+                children: "/account"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
 function App2({ selector: initialSelector, runner, fullscreen = false, resumeId }) {
   const { exit } = use_app_default();
   const { stdin, isRawModeSupported, setRawMode } = use_stdin_default();
@@ -135727,176 +135993,92 @@ function App2({ selector: initialSelector, runner, fullscreen = false, resumeId
   const hero = /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
     flexDirection: "column",
     alignItems: "center",
-    children: [
-      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(MascotSplash, {
-        skin: ghostSkin,
-        size: splashSize
-      }, undefined, false, undefined, this),
-      setupRequired ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
-        marginTop: 1,
-        flexDirection: "column",
-        alignItems: "center",
-        children: [
-          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-            color: color.text,
-            children: "setup required"
-          }, undefined, false, undefined, this),
-          onboardingState.importable.length || onboardingState.cloudImportable.length ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-            color: color.faint,
-            children: [
-              "detected credentials: ",
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accent,
-                children: "/account import"
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this) : null,
-          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-            color: color.faint,
-            children: [
-              "add any provider key: ",
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accent,
-                children: "/account add <provider> <api-key>"
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-            color: color.faint,
-            children: [
-              "paste-detect: ",
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accent,
-                children: "/account add <api-key>"
-              }, undefined, false, undefined, this),
-              "  ·  list: ",
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accent,
-                children: "/onboard providers"
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
-            marginTop: 1,
-            flexDirection: "column",
-            alignItems: "flex-start",
-            children: [
-              featuredApiKeyProviders().slice(0, 6).map((p) => /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.dim,
-                children: [
-                  "  ",
-                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                    color: color.accent,
-                    children: [
-                      "/account add ",
-                      p.id,
-                      " <api-key>"
-                    ]
-                  }, undefined, true, undefined, this),
-                  "  ",
-                  p.label
-                ]
-              }, p.id, true, undefined, this)),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.dim,
-                children: [
-                  "  ",
-                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                    color: color.accent,
-                    children: "/account add azure <endpoint> <api-key>"
-                  }, undefined, false, undefined, this),
-                  "  Azure OpenAI / Foundry"
-                ]
-              }, undefined, true, undefined, this)
-            ]
-          }, undefined, true, undefined, this),
-          onboardingState.hasClaudeCli || onboardingState.hasCodexCli ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-            color: color.faint,
-            children: [
-              onboardingState.hasClaudeCli ? "/account add claude" : "",
-              onboardingState.hasClaudeCli && onboardingState.hasCodexCli ? "  ·  " : "",
-              onboardingState.hasCodexCli ? "/account add codex" : ""
-            ]
-          }, undefined, true, undefined, this) : null
-        ]
-      }, undefined, true, undefined, this) : /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(jsx_dev_runtime12.Fragment, {
-        children: [
-          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
-            marginTop: 1,
-            children: [
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.dim,
-                children: "talk or type "
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.faint,
-                children: [
-                  glyph.bullet,
-                  " "
-                ]
-              }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accentDim,
-                children: "/"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.dim,
-                children: "commands "
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accentDim,
-                children: "@"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.dim,
-                children: "files "
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accentDim,
-                children: "!"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.dim,
-                children: "shell"
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this),
-          firstRunRef.current ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
-            marginTop: 1,
-            flexDirection: "column",
-            alignItems: "center",
-            children: [
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.faint,
-                children: [
-                  "new here? press ",
-                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                    color: color.accent,
-                    children: "?"
-                  }, undefined, false, undefined, this),
-                  " for shortcuts · ",
-                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                    color: color.accent,
-                    children: "shift+tab"
-                  }, undefined, false, undefined, this),
-                  " cycles modes · ",
-                  /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                    color: color.accent,
-                    children: "⌃Y"
-                  }, undefined, false, undefined, this),
-                  " copies the last reply"
-                ]
-              }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.faint,
-                children: "/config inline on for terminal scrollback · /keys for shortcuts"
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this) : null
-        ]
-      }, undefined, true, undefined, this)
-    ]
-  }, undefined, true, undefined, this);
+    children: setupRequired ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(SetupSplash, {
+      state: onboardingState,
+      width,
+      skin: ghostSkin,
+      splashSize
+    }, undefined, false, undefined, this) : /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(jsx_dev_runtime12.Fragment, {
+      children: [
+        /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(MascotSplash, {
+          skin: ghostSkin,
+          size: splashSize
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+          marginTop: 1,
+          children: [
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.dim,
+              children: "talk or type "
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.faint,
+              children: [
+                glyph.bullet,
+                " "
+              ]
+            }, undefined, true, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.accentDim,
+              children: "/"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.dim,
+              children: "commands "
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.accentDim,
+              children: "@"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.dim,
+              children: "files "
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.accentDim,
+              children: "!"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.dim,
+              children: "shell"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this),
+        firstRunRef.current ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+          marginTop: 1,
+          flexDirection: "column",
+          alignItems: "center",
+          children: [
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.faint,
+              children: [
+                "new here? press ",
+                /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                  color: color.accent,
+                  children: "?"
+                }, undefined, false, undefined, this),
+                " for shortcuts · ",
+                /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                  color: color.accent,
+                  children: "shift+tab"
+                }, undefined, false, undefined, this),
+                " cycles modes · ",
+                /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+                  color: color.accent,
+                  children: "⌃Y"
+                }, undefined, false, undefined, this),
+                " copies the last reply"
+              ]
+            }, undefined, true, undefined, this),
+            /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
+              color: color.faint,
+              children: "/config inline on for terminal scrollback · /keys for shortcuts"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this) : null
+      ]
+    }, undefined, true, undefined, this)
+  }, undefined, false, undefined, this);
   const paletteJsx = pickerRows.length || cmdMatches.length || fileMatches.length ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
     flexDirection: "column",
     children: [
@@ -136099,8 +136281,153 @@ function App2({ selector: initialSelector, runner, fullscreen = false, resumeId
 var jsx_dev_runtime13 = __toESM(require_jsx_dev_runtime(), 1);
 process.env.LANG = process.env.LANG || "en_US.UTF-8";
 process.env.LC_ALL = process.env.LC_ALL || "en_US.UTF-8";
-var VERSION16 = "0.1.6";
+var VERSION16 = "0.1.8";
 var args = process.argv.slice(2);
+async function runCliOnboarding() {
+  const { listAccounts: listAccounts2 } = await Promise.resolve().then(() => (init_store(), exports_store));
+  const { importableEnvCreds: importableEnvCreds2, importEnvCred: importEnvCred2, importableCloudCreds: importableCloudCreds2, importCloudCred: importCloudCred2 } = await Promise.resolve().then(() => (init_detect(), exports_detect));
+  const { addApiKeyAccount: addApiKeyAccount2, addAzureAccount: addAzureAccount2, addAzureFoundryAccount: addAzureFoundryAccount2, addByPastedKey: addByPastedKey2, testAccount: testAccount2, addableProviders: addableProviders2, addCliAccount: addCliAccount2, cliAuthStatus: cliAuthStatus2, cliLoginArgs: cliLoginArgs2 } = await Promise.resolve().then(() => (init_onboard(), exports_onboard));
+  const { subscriptionEnv: subscriptionEnv2 } = await Promise.resolve().then(() => (init_cli_backend(), exports_cli_backend));
+  const { detectProviderByKey: detectProviderByKey2 } = await Promise.resolve().then(() => (init_catalog(), exports_catalog));
+  const { which: which2 } = await Promise.resolve().then(() => (init_proc(), exports_proc));
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const ask = async (q) => (await rl.question(q)).trim();
+  const providerRows = () => addableProviders2().map((p) => `  ${p.id.padEnd(16)} ${p.label}`).join(`
+`);
+  const testAndReport = async (account) => {
+    console.log("Testing credential...");
+    const t2 = await testAccount2(account);
+    console.log(t2.ok ? `OK: ${t2.message}` : `Stored, but the test failed: ${t2.message}`);
+  };
+  const addSubscription = async (provider) => {
+    const res = addCliAccount2(provider);
+    console.log(res.message);
+    if (!res.ok || !res.account || res.account.auth.kind !== "cli")
+      return false;
+    const bin = res.account.auth.binary;
+    const profile = res.account.auth.loginProfile;
+    let status = await cliAuthStatus2(bin, profile);
+    if (!status.loggedIn) {
+      console.log(`Starting ${bin} sign-in...`);
+      const r2 = spawnSync(bin, cliLoginArgs2(bin), { stdio: "inherit", env: subscriptionEnv2(bin, profile) });
+      if ((r2.status ?? 1) !== 0)
+        return false;
+      status = await cliAuthStatus2(bin, profile);
+    }
+    if (!status.loggedIn) {
+      console.log(`${bin} did not report a completed sign-in.`);
+      return false;
+    }
+    console.log(`OK: ${bin} subscription ready${status.detail ? ` (${status.detail})` : ""}`);
+    return true;
+  };
+  try {
+    console.log("");
+    console.log("Gearbox setup");
+    console.log("One provider account is required before the coding app opens.");
+    console.log("");
+    while (!anyProviderAvailable()) {
+      const env3 = importableEnvCreds2();
+      const cloud = importableCloudCreds2();
+      const existing = listAccounts2();
+      if (existing.length)
+        break;
+      console.log("Choose a setup path:");
+      if (env3.length || cloud.length)
+        console.log("  1) Import detected credentials");
+      console.log("  2) Paste an API key");
+      console.log("  3) Choose provider + API key");
+      console.log("  4) Azure OpenAI / Azure AI Foundry");
+      if (which2("claude"))
+        console.log("  5) Claude subscription CLI");
+      if (which2("codex"))
+        console.log("  6) ChatGPT subscription CLI");
+      console.log("  p) Show providers");
+      console.log("  q) Quit setup");
+      console.log("");
+      const choice = (await ask("Selection: ")).toLowerCase();
+      if (choice === "q" || choice === "quit" || choice === "skip") {
+        console.log("");
+        console.log("Setup skipped. Run `gearbox onboard` when you are ready.");
+        return false;
+      }
+      if (choice === "p" || choice === "providers") {
+        console.log("");
+        console.log(providerRows());
+        console.log("");
+        continue;
+      }
+      if (choice === "1" && (env3.length || cloud.length)) {
+        for (const c of env3)
+          await importEnvCred2(c);
+        for (const c of cloud)
+          await importCloudCred2(c);
+        console.log(`Imported ${env3.length + cloud.length} credential${env3.length + cloud.length === 1 ? "" : "s"}.`);
+        break;
+      }
+      if (choice === "2") {
+        const key = await ask("Paste API key: ");
+        if (!key)
+          continue;
+        const detected = detectProviderByKey2(key);
+        if (!detected) {
+          console.log("Could not detect the provider from that key. Use option 3.");
+          continue;
+        }
+        const res = await addByPastedKey2(key);
+        console.log(res.message);
+        if (res.ok && res.account) {
+          await testAndReport(res.account);
+          break;
+        }
+        continue;
+      }
+      if (choice === "3") {
+        console.log("");
+        console.log(providerRows());
+        console.log("");
+        const provider = await ask("Provider id: ");
+        const key = await ask("API key: ");
+        const res = await addApiKeyAccount2(provider, key);
+        console.log(res.message);
+        if (res.ok && res.account) {
+          await testAndReport(res.account);
+          break;
+        }
+        continue;
+      }
+      if (choice === "4") {
+        const endpoint = await ask("Azure resource name or endpoint: ");
+        const key = await ask("API key: ");
+        const apiVersion = await ask("API version (optional): ");
+        const res = /^https?:\/\//i.test(endpoint) ? await addAzureFoundryAccount2(endpoint, key) : await addAzureAccount2(endpoint, key, { apiVersion: apiVersion || undefined });
+        console.log(res.message);
+        if (res.ok && res.account) {
+          await testAndReport(res.account);
+          break;
+        }
+        continue;
+      }
+      if (choice === "5" && which2("claude")) {
+        if (await addSubscription("claude-cli"))
+          break;
+        continue;
+      }
+      if (choice === "6" && which2("codex")) {
+        if (await addSubscription("codex-cli"))
+          break;
+        continue;
+      }
+      console.log("Choose one of the listed options.");
+    }
+    console.log("");
+    console.log("Gearbox is ready.");
+    console.log("Run `gearbox` inside a project.");
+    return true;
+  } finally {
+    rl.close();
+  }
+}
 if (args[0] === "upgrade" || args[0] === "update") {
   const root2 = resolve11(import.meta.dir, "..");
   if (!existsSync8(resolve11(root2, ".git"))) {
@@ -136125,6 +136452,7 @@ if (args.includes("--help") || args.includes("-h")) {
 
 Usage:
   gearbox                 start in the current directory (it becomes the workspace)
+  gearbox onboard         set up a provider before opening the app
   gearbox --model <name>  start with a specific model
   gearbox --continue      resume the most recent session in this directory
   gearbox upgrade         pull the latest version + reinstall deps
@@ -136139,6 +136467,7 @@ Options:
   -h, --help          this help
 
 Set up at least one provider first:
+  gearbox onboard
   gearbox auth add <api-key>
   gearbox auth add <provider> <api-key>
   gearbox auth import
@@ -136151,6 +136480,10 @@ if (args.includes("--version") || args.includes("-v")) {
   console.log(VERSION16);
   process.exit(0);
 }
+if (args[0] === "onboard" || args[0] === "setup") {
+  await runCliOnboarding();
+  process.exit(0);
+}
 if (args[0] === "auth") {
   const { listAccounts: listAccounts2, loadAccounts: loadAccounts3, removeAccount: removeAccount2 } = await Promise.resolve().then(() => (init_store(), exports_store));
   const { importableEnvCreds: importableEnvCreds2, importEnvCred: importEnvCred2, importableCloudCreds: importableCloudCreds2, importCloudCred: importCloudCred2 } = await Promise.resolve().then(() => (init_detect(), exports_detect));
@@ -136198,6 +136531,18 @@ Importable from your env (gearbox auth import): ${imp.map((c) => c.envVar).join(
   }
   process.exit(0);
 }
+if (!anyProviderAvailable()) {
+  if (process.stdin.isTTY && process.stdout.isTTY && process.env.GEARBOX_SKIP_ONBOARD !== "1") {
+    const ready = await runCliOnboarding();
+    if (!ready || !anyProviderAvailable())
+      process.exit(0);
+  } else {
+    console.log("Gearbox needs one provider before the coding app can open.");
+    console.log("Run: gearbox onboard");
+    console.log("Or:  gearbox auth add <api-key>");
+    process.exit(1);
+  }
+}
 var mi = args.indexOf("--model");
 var preferred = mi >= 0 ? args[mi + 1] : undefined;
 var pinned = preferred ?? loadPrefs().pinnedModel;

package/install.ps1

@@ -0,0 +1,93 @@
+$ErrorActionPreference = "Stop"
+
+# Public Gearbox installer for Windows PowerShell.
+#
+# Installs the published npm package into user-owned directories:
+#   %LOCALAPPDATA%\Gearbox\versions\<version>\cli.mjs
+#   %LOCALAPPDATA%\Gearbox\bin\gearbox.cmd
+#
+# It avoids npm global installs, admin privileges, Program Files, and system PATH
+# writes. The user PATH is updated when needed.
+
+$PackageName = if ($env:GEARBOX_PACKAGE) { $env:GEARBOX_PACKAGE } else { "gearbox-code" }
+$Version = if ($env:GEARBOX_VERSION) { $env:GEARBOX_VERSION } else { "latest" }
+$InstallRoot = if ($env:GEARBOX_INSTALL_DIR) { $env:GEARBOX_INSTALL_DIR } else { Join-Path $env:LOCALAPPDATA "Gearbox" }
+$BinDir = if ($env:GEARBOX_BIN_DIR) { $env:GEARBOX_BIN_DIR } else { Join-Path $InstallRoot "bin" }
+
+function Require-Command($Name, $InstallHint) {
+  if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+    Write-Error "Gearbox installer needs '$Name'. $InstallHint"
+  }
+}
+
+Require-Command "node" "Install Node.js, then rerun this installer."
+Require-Command "tar" "Install a current Windows build or Git for Windows, then rerun this installer."
+
+$Temp = Join-Path ([System.IO.Path]::GetTempPath()) ("gearbox-install-" + [System.Guid]::NewGuid().ToString("N"))
+New-Item -ItemType Directory -Path $Temp | Out-Null
+
+try {
+  $MetaUrl = "https://registry.npmjs.org/$PackageName/$Version"
+  $MetaFile = Join-Path $Temp "meta.json"
+  Write-Host "-> Fetching $PackageName@$Version"
+  Invoke-WebRequest -Uri $MetaUrl -OutFile $MetaFile -UseBasicParsing
+
+  $Meta = Get-Content $MetaFile -Raw | ConvertFrom-Json
+  $ResolvedVersion = $Meta.version
+  $TarballUrl = $Meta.dist.tarball
+  if (-not $ResolvedVersion -or -not $TarballUrl) {
+    Write-Error "Could not resolve $PackageName@$Version from npm."
+  }
+
+  $TargetDir = Join-Path (Join-Path $InstallRoot "versions") $ResolvedVersion
+  $Archive = Join-Path $Temp "package.tgz"
+  $ExtractDir = Join-Path $Temp "extract"
+
+  Write-Host "-> Downloading $PackageName@$ResolvedVersion"
+  Invoke-WebRequest -Uri $TarballUrl -OutFile $Archive -UseBasicParsing
+  New-Item -ItemType Directory -Force -Path $ExtractDir, $TargetDir, $BinDir | Out-Null
+  tar -xzf $Archive -C $ExtractDir
+
+  $Cli = Join-Path $ExtractDir "package\dist\cli.mjs"
+  if (-not (Test-Path $Cli)) {
+    Write-Error "Package did not contain dist/cli.mjs."
+  }
+
+  $TargetCli = Join-Path $TargetDir "cli.mjs"
+  Copy-Item $Cli $TargetCli -Force
+
+  $CmdPath = Join-Path $BinDir "gearbox.cmd"
+  $Cmd = @"
+@echo off
+node "$TargetCli" %*
+"@
+  Set-Content -Path $CmdPath -Value $Cmd -Encoding ASCII
+
+  $UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
+  $PathParts = @()
+  if ($UserPath) { $PathParts = $UserPath -split ";" }
+  $AlreadyOnPath = $PathParts | Where-Object { $_ -ieq $BinDir }
+  if (-not $AlreadyOnPath) {
+    $NextPath = if ($UserPath) { "$UserPath;$BinDir" } else { $BinDir }
+    [Environment]::SetEnvironmentVariable("Path", $NextPath, "User")
+    $env:Path = "$env:Path;$BinDir"
+  }
+
+  Write-Host ""
+  Write-Host "Installed Gearbox $ResolvedVersion"
+  Write-Host "  $CmdPath"
+  Write-Host ""
+  Write-Host "Run it with: gearbox"
+  if (-not $AlreadyOnPath) {
+    Write-Host "Open a new terminal if this shell does not pick up the PATH change."
+  }
+
+  if ($env:GEARBOX_SKIP_ONBOARD -ne "1") {
+    Write-Host ""
+    Write-Host "Starting setup..."
+    & $CmdPath onboard
+  }
+}
+finally {
+  Remove-Item -Recurse -Force $Temp -ErrorAction SilentlyContinue
+}

package/install.sh

@@ -93,3 +93,13 @@ case ":${PATH}:" in
     echo "Then run: gearbox"
     ;;
 esac
+
+if [[ "${GEARBOX_SKIP_ONBOARD:-}" != "1" ]]; then
+  echo ""
+  echo "Starting setup..."
+  if [[ -r /dev/tty && -w /dev/tty ]]; then
+    "${BIN_DIR}/gearbox" onboard < /dev/tty > /dev/tty
+  else
+    echo "No interactive terminal detected. Run: ${BIN_DIR}/gearbox onboard"
+  fi
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gearbox-code",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "A beautiful multi-provider coding harness for the terminal. (Intelligent model routing lands on top of this soon.)",
   "type": "module",
   "license": "MIT",
@@ -9,7 +9,8 @@
   },
   "files": [
     "dist/cli.mjs",
-    "install.sh"
+    "install.sh",
+    "install.ps1"
   ],
   "scripts": {
     "start": "bun run src/cli.tsx",