gearbox-code 0.1.7 → 0.1.8

package/README.md

@@ -1,117 +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.
-
-   ✓ 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.
+Windows PowerShell:
 
- ╭──────────────────────────────────────────────────────────╮
- │ › 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.
 
-```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
-```
-
-No provider configured? Gearbox opens a setup screen and will not run a fake model. Preview the look without running anything:
+Run without installing:
 
 ```bash
-bun run scripts/preview.tsx
+npx gearbox-code@latest
 ```
 
-## Install
+## First Run
 
-macOS, Linux, WSL:
+Gearbox needs one provider account before it opens the coding app. The installer
+runs setup automatically. You can also run it yourself:
 
 ```bash
-curl -fsSL https://unpkg.com/gearbox-code@latest/install.sh | bash
+gearbox onboard
 ```
 
-Windows PowerShell:
+Common setup commands:
 
-```powershell
-irm https://unpkg.com/gearbox-code@latest/install.ps1 | iex
+```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 installers are served from the published npm package, download the latest
-`gearbox-code` tarball, and create a user-owned `gearbox` command. They avoid
-`sudo`, admin privileges, and `npm install -g`.
-
-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 };
       }
@@ -136244,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.7";
+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"))) {
@@ -136270,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
@@ -136284,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
@@ -136296,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));
@@ -136343,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

@@ -81,6 +81,12 @@ node "$TargetCli" %*
   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.7",
+  "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",