gearbox-code 0.1.3 → 0.1.4

package/README.md

@@ -31,12 +31,14 @@ A beautiful, simple coding harness for the terminal. It reads, edits, and runs y
 
 ```bash
 bun install
-export ANTHROPIC_API_KEY=...   # or OPENAI_API_KEY / GOOGLE_GENERATIVE_AI_API_KEY / DEEPSEEK_API_KEY
+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 key? It launches in demo mode so you can see the interface. Preview the look without running anything:
+No provider configured? Gearbox opens a setup screen and will not run a fake model. Preview the look without running anything:
 
 ```bash
 bun run scripts/preview.tsx
@@ -48,7 +50,7 @@ Requires [Bun](https://bun.sh). Clone the repo, then:
 
 ```bash
 ./install.sh          # bun install + bun link  → 'gearbox' on your PATH
-export ANTHROPIC_API_KEY=...   # each person uses their own key (add to ~/.zshrc)
+gearbox auth add <api-key>     # each person uses their own provider account
 cd ~/any/project && gearbox    # the current directory is the workspace
 ```
 

package/dist/cli.mjs

@@ -64171,6 +64171,104 @@ var init_detect = __esm(() => {
   init_store();
 });
 
+// src/accounts/onboarding.ts
+function normalizeProviderId(input) {
+  const key = input.trim().toLowerCase().replace(/[_\s]+/g, "-");
+  return ALIASES[key] ?? key;
+}
+function apiKeyProviders() {
+  return CATALOG.filter((p) => (p.authKind === "api-key" || p.authKind === "openai-compat") && p.group !== "local" && (p.authKind !== "openai-compat" || Boolean(p.baseUrl)));
+}
+function featuredApiKeyProviders() {
+  const providers = apiKeyProviders();
+  const byId = new Map(providers.map((p) => [p.id, p]));
+  const first = FEATURED.map((id) => byId.get(id)).filter((p) => Boolean(p));
+  const rest2 = providers.filter((p) => !FEATURED.includes(p.id)).sort((a, b) => a.label.localeCompare(b.label));
+  return [...first, ...rest2];
+}
+function needsOnboarding(state) {
+  return state.configured.length === 0;
+}
+function onboardingSummary(state) {
+  if (!needsOnboarding(state))
+    return "ready";
+  const lines = [
+    "setup required",
+    "  Add any common provider API key:",
+    ...featuredApiKeyProviders().slice(0, 10).map((p) => `  /account add ${p.id} <api-key>`.padEnd(38) + `${p.label}`)
+  ];
+  const more = featuredApiKeyProviders().length - 10;
+  if (more > 0)
+    lines.push(`  /onboard providers                    show ${more} more providers`);
+  if (state.importable.length || state.cloudImportable.length)
+    lines.push("", "  /account import                       import detected env/cloud credentials");
+  lines.push("  /account add azure <endpoint> <api-key>  Azure OpenAI / Foundry");
+  if (state.hasClaudeCli)
+    lines.push("  /account add claude                   use Claude subscription CLI");
+  if (state.hasCodexCli)
+    lines.push("  /account add codex                    use ChatGPT subscription CLI");
+  lines.push("", "Paste-detect works for known key prefixes: /account add <api-key>");
+  return lines.join(`
+`);
+}
+var ALIASES, FEATURED;
+var init_onboarding = __esm(() => {
+  init_catalog();
+  ALIASES = {
+    anthropic: "anthropic",
+    claude: "anthropic",
+    openai: "openai",
+    gpt: "openai",
+    google: "google",
+    gemini: "google",
+    deepseek: "deepseek",
+    grok: "xai",
+    xai: "xai",
+    "x-ai": "xai",
+    mistral: "mistral",
+    groq: "groq",
+    together: "together",
+    fireworks: "fireworks",
+    deepinfra: "deepinfra",
+    cerebras: "cerebras",
+    perplexity: "perplexity",
+    baseten: "baseten",
+    moonshot: "moonshot",
+    kimi: "moonshot",
+    zai: "zai",
+    zhipu: "zai",
+    nebius: "nebius",
+    hyperbolic: "hyperbolic",
+    sambanova: "sambanova",
+    novita: "novita",
+    openrouter: "openrouter",
+    requesty: "requesty",
+    portkey: "portkey",
+    litellm: "litellm",
+    "vercel-gateway": "vercel-gateway",
+    vercel: "vercel-gateway",
+    "ai-gateway": "vercel-gateway",
+    azure: "azure",
+    "azure-foundry": "azure-foundry",
+    foundry: "azure-foundry"
+  };
+  FEATURED = [
+    "anthropic",
+    "openai",
+    "google",
+    "deepseek",
+    "openrouter",
+    "xai",
+    "mistral",
+    "groq",
+    "together",
+    "fireworks",
+    "perplexity",
+    "cerebras",
+    "requesty"
+  ];
+});
+
 // src/agent/cli-backend.ts
 function newState() {
   return { text: "", usage: { inputTokens: 0, outputTokens: 0 }, rates: new Map, toolNames: new Map };
@@ -64423,9 +64521,10 @@ import { mkdirSync as mkdirSync7 } from "node:fs";
 import { join as join10 } from "node:path";
 import { homedir as homedir8 } from "node:os";
 async function addApiKeyAccount(provider, key, opts = {}) {
+  provider = normalizeProviderId(provider);
   const cat = catalogProvider(provider);
   if (!cat)
-    return { ok: false, message: `unknown provider "${provider}" — see /accounts catalog` };
+    return { ok: false, message: `unknown provider "${provider}" — use /onboard providers` };
   if (cat.group === "cli")
     return { ok: false, message: `${cat.label} is a subscription account — use /login ${provider} (P3), not a key` };
   if (cat.authKind !== "api-key" && cat.authKind !== "openai-compat") {
@@ -64638,6 +64737,7 @@ function shortId() {
 var init_onboard = __esm(() => {
   init_store();
   init_catalog();
+  init_onboarding();
   init_resolve();
   init_cli_backend();
   init_proc();
@@ -118420,6 +118520,7 @@ var COMMANDS = [
   { name: "/context", usage: "/context", desc: "see what's loaded and how many tokens it uses", group: "chat" },
   { name: "/memory", usage: "/memory [note]", desc: "show or add facts to remember (or start a line with #)", group: "chat" },
   { name: "/account", usage: "/account", desc: "list accounts; /account <number> to switch, /account add to add one", group: "accounts" },
+  { name: "/onboard", usage: "/onboard", desc: "first-run setup; provider list and import/add commands", group: "accounts" },
   { name: "/cost", usage: "/cost", desc: "see what you've spent per account", group: "accounts" },
   { name: "/copy", usage: "/copy", desc: "copy the last reply to the clipboard", group: "output" },
   { name: "/export", usage: "/export [file]", desc: "save the conversation to a file", group: "output" },
@@ -121187,9 +121288,6 @@ 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 {
@@ -133121,6 +133219,7 @@ init_store();
 init_detect();
 init_onboard();
 init_catalog();
+init_onboarding();
 init_cli_backend();
 
 // src/accounts/balance.ts
@@ -133233,72 +133332,6 @@ ${summary}` },
   return { messages, summarizedTurns: old.length, before: before2, after: after2 };
 }
 
-// src/agent/mock.ts
-var sleep = (ms) => new Promise((r2) => setTimeout(r2, ms));
-async function stream(text2, onEvent, chunk2 = 3, delay3 = 8) {
-  for (let i2 = 0;i2 < text2.length; i2 += chunk2) {
-    onEvent({ type: "text", text: text2.slice(i2, i2 + chunk2) });
-    await sleep(delay3);
-  }
-}
-async function streamWrite(id, path, content, onEvent, stop) {
-  onEvent({ type: "tool-start", id, name: "write_file", arg: "" });
-  onEvent({ type: "tool-stream", id, arg: path });
-  for (let i2 = 0;i2 < content.length; i2 += 8) {
-    if (stop())
-      return;
-    onEvent({ type: "tool-stream", id, delta: content.slice(i2, i2 + 8) });
-    await sleep(16);
-  }
-  const diff2 = content.replace(/\n$/, "").split(`
-`).map((text2) => ({ sign: "+", text: text2 }));
-  onEvent({ type: "tool-end", id, ok: true, summary: `wrote ${path} (+${diff2.length} −0)`, diff: diff2 });
-}
-async function runTaskMock(opts) {
-  const { prompt, messages, onEvent, signal } = opts;
-  const stop = () => signal?.aborted === true;
-  await stream(`Sure — let me take a look around first.
-`, onEvent);
-  if (stop())
-    return done(messages, onEvent);
-  onEvent({ type: "tool-start", id: "1", name: "list_dir", arg: "." });
-  await sleep(260);
-  if (stop())
-    return done(messages, onEvent);
-  onEvent({ type: "tool-end", id: "1", ok: true, summary: "src · package.json · README.md · 5 more" });
-  onEvent({ type: "tool-start", id: "2", name: "read_file", arg: "src/cli.tsx" });
-  await sleep(220);
-  if (stop())
-    return done(messages, onEvent);
-  onEvent({ type: "tool-end", id: "2", ok: true, summary: "renders the Ink app · 38 lines" });
-  await stream(`
-Here's a quick file — watch it stream in:
-`, onEvent);
-  if (stop())
-    return done(messages, onEvent);
-  const demoFile = `# hello.py — written live in demo mode
-
-def greet(name: str) -> str:
-    return f"Hello, {name}!"
-
-if __name__ == "__main__":
-    for who in ("world", "gearbox", "Boo"):
-        print(greet(who))
-`;
-  await streamWrite("3", "hello.py", demoFile, onEvent, stop);
-  if (stop())
-    return done(messages, onEvent);
-  await stream(`
-This is demo mode — no API key is set, so I'm not calling a real model. ` + `Set ANTHROPIC_API_KEY (or OPENAI / GOOGLE / DEEPSEEK) and I'll actually work on: "${prompt}".
-`, onEvent);
-  return done(messages, onEvent);
-}
-function done(messages, onEvent) {
-  const usage = { inputTokens: 0, outputTokens: 0 };
-  onEvent({ type: "done", usage });
-  return { messages, usage };
-}
-
 // src/ui/clipboard.ts
 init_proc();
 function osc52(text2) {
@@ -133653,11 +133686,11 @@ function ActivityRail({ items, width }) {
     ]
   }, undefined, true, undefined, this);
 }
-function App2({ selector: initialSelector, demo, runner, fullscreen = false, resumeId }) {
+function App2({ selector: initialSelector, runner, fullscreen = false, resumeId }) {
   const { exit } = use_app_default();
   const { stdin, isRawModeSupported, setRawMode } = use_stdin_default();
   const { columns, rows } = useTerminalSize();
-  const online = useOnline(20000, !demo);
+  const online = useOnline(20000, true);
   const width = columns;
   const splashSize = rows >= 24 && columns >= 42 ? "big" : rows >= 13 && columns >= 22 ? "mini" : "none";
   const [items, setItems] = import_react26.useState([]);
@@ -133736,10 +133769,6 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
     const t2 = setInterval(() => setElapsed(Math.floor((Date.now() - start) / 1000)), 500);
     return () => clearInterval(t2);
   }, [busy]);
-  import_react26.useEffect(() => {
-    if (firstRunRef.current)
-      updatePrefs({ onboarded: true });
-  }, []);
   import_react26.useEffect(() => {
     const proj = basename2(process.cwd());
     setTitle(busy ? `✳ ${proj} · working` : `${proj} · gearbox`);
@@ -133800,8 +133829,6 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
     setTimeout(pumpPerm, 0);
   };
   import_react26.useEffect(() => {
-    if (demo)
-      return;
     const acctId = loadPrefs().activeAccount;
     if (!acctId)
       return;
@@ -133813,7 +133840,7 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
         setActiveCliModelId(undefined);
       setActiveCli({ id: a.id, label: bin });
     }
-  }, [demo]);
+  }, []);
   import_react26.useEffect(() => {
     setPermissionHandler((req) => new Promise((resolve11) => {
       if (modeRef.current === "auto-accept" && (req.kind === "write" || req.kind === "edit")) {
@@ -134055,8 +134082,6 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
     };
   }, [stdin, fullscreen, rows, scrollBy, copyWithFeedback]);
   const persist = import_react26.useCallback(() => {
-    if (demo)
-      return;
     const s2 = sessionRef.current;
     if (!itemsRef.current.length)
       return;
@@ -134070,7 +134095,7 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
       items: itemsRef.current,
       turns: s2.turns
     });
-  }, [demo]);
+  }, []);
   const loadInto = (s2) => {
     idRef.current = s2.items.reduce((m2, i2) => Math.max(m2, i2.id), 0) + 1;
     setItems(s2.items);
@@ -134230,10 +134255,24 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
   const [lastPick, setLastPick] = import_react26.useState(null);
   const [activeCli, setActiveCli] = import_react26.useState(null);
   const [activeCliModel, setActiveCliModel] = import_react26.useState(null);
+  const onboardingState = {
+    configured: listAccounts(),
+    importable: importableEnvCreds(),
+    cloudImportable: importableCloudCreds().map((c) => ({ provider: c.provider, label: c.label, source: c.source })),
+    hasClaudeCli: Boolean(which("claude")),
+    hasCodexCli: Boolean(which("codex"))
+  };
+  const setupRequired = needsOnboarding(onboardingState);
+  import_react26.useEffect(() => {
+    if (!setupRequired && firstRunRef.current) {
+      firstRunRef.current = false;
+      updatePrefs({ onboarded: true });
+    }
+  }, [setupRequired]);
   const model = lastPick?.model ?? choice?.model ?? null;
-  const modelLabel = demo ? "demo · no key" : activeCli ? `${activeCli.label}${activeCliModel ? ` · ${activeCliModel}` : ""}` : model?.label ?? "none";
+  const modelLabel = setupRequired ? "setup required" : activeCli ? `${activeCli.label}${activeCliModel ? ` · ${activeCliModel}` : ""}` : model?.label ?? "none";
   const subscription = activeCli ? activeCli.label : null;
-  const routing = demo || activeCli ? null : lastPick?.reason ?? choice?.reason ?? null;
+  const routing = setupRequired || activeCli ? null : lastPick?.reason ?? choice?.reason ?? null;
   const ctxPct = !activeCli && model && lastInput > 0 ? Math.round(lastInput / model.contextWindow * 100) : null;
   const push = (it) => setItems((prev) => [...prev, it]);
   const pushPhase = (label, detail) => {
@@ -134304,8 +134343,6 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
     };
   };
   const defaultRunner = import_react26.useCallback(async ({ prompt, messages, onEvent, selector: sel, signal }) => {
-    if (demo)
-      return runTaskMock({ prompt, messages, onEvent, signal });
     const cli = activeCliRef.current;
     if (cli) {
       routedRef.current = null;
@@ -134338,10 +134375,8 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
     const produced = r2.messages.slice(ctx.length);
     const ledger = sanitizeToolPairs([...messages, { role: "user", content: prompt }, ...produced]);
     return { messages: ledger, usage: r2.usage };
-  }, [demo]);
+  }, []);
   const compactNow = import_react26.useCallback(async (keepRecent, signal) => {
-    if (demo)
-      return "compaction needs a model (no key in demo)";
     let model2;
     try {
       model2 = selectorRef.current.select({ prompt: "", kind: "summarize" }).model;
@@ -134355,7 +134390,7 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
     const saved = res.before - res.after;
     const savedStr = saved >= 1000 ? `${(saved / 1000).toFixed(1)}k` : String(Math.max(0, saved));
     return `compacted ${res.summarizedTurns} earlier turn${res.summarizedTurns > 1 ? "s" : ""} · ~${savedStr} tokens freed`;
-  }, [demo]);
+  }, []);
   const MODE_NOTE = {
     normal: "normal mode — I'll ask before writes, edits, and shell",
     "auto-accept": "auto-accept edits — file writes/edits apply without asking (shell still gated)",
@@ -134603,7 +134638,7 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
       recordUsage({ accountId: acctId, inputTokens: r2.usage.inputTokens, outputTokens: r2.usage.outputTokens, costUSD: cost, estimated: cm?.costUSD == null });
       if (cm?.rates?.length)
         recordRateLimits(acctId, cm.rates);
-      if (!demo && !ac.signal.aborted) {
+      if (!ac.signal.aborted) {
         try {
           const cm2 = selectorRef.current.select({ prompt: "", kind: "summarize" }).model;
           const budget = Math.max(8000, cm2.contextWindow - 32000);
@@ -134981,13 +135016,26 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
             }
           })();
           if (!m2) {
-            notice("no model available — set a key to see the working set");
+            notice(`no model available — add a provider first
+
+` + onboardingSummary(onboardingState));
             return;
           }
           const { sections } = buildContext({ history: msgRef.current, userText: lastPromptRef.current || "(your next message)", model: m2, plan: modeRef.current === "plan" });
           push({ kind: "context", id: idRef.current++, view: buildContextView(sections, m2.contextWindow, process.cwd()) });
           return;
         }
+        case "onboard": {
+          echo(text2);
+          if (arg.trim().toLowerCase() === "providers") {
+            const rows2 = featuredApiKeyProviders().map((p) => `  ${p.id.padEnd(18)} ${p.label.padEnd(24)} ${p.envVars[0] ?? ""}`.trimEnd());
+            notice(["providers you can add with /account add <provider> <api-key>", ...rows2, "", "Aliases work for common names, e.g. gemini -> google, grok -> xai, kimi -> moonshot."].join(`
+`));
+          } else {
+            notice(onboardingSummary(onboardingState));
+          }
+          return;
+        }
         case "accounts":
         case "account": {
           echo(text2);
@@ -135255,10 +135303,6 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
             notice("busy — try /compact once the current turn finishes");
             return;
           }
-          if (demo) {
-            notice("compaction needs a model (no key in demo)");
-            return;
-          }
           setBusy(true);
           setVerb("Compacting context");
           setMascotState("thinking");
@@ -135296,7 +135340,7 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
       notice(`/${name31} hit an error: ${(e2?.message ?? String(e2)).split(`
 `)[0]}`);
     }
-  }, [exit, runTurn]);
+  }, [exit, runTurn, onboardingState]);
   const submit = import_react26.useCallback((value) => {
     let text2 = value.trim();
     if (pasteStoreRef.current.size) {
@@ -135350,6 +135394,13 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
       handleCommand(text2);
       return;
     }
+    if (setupRequired) {
+      echo(text2);
+      notice(`set up a provider before sending a task
+
+` + onboardingSummary(onboardingState));
+      return;
+    }
     if (busyRef.current) {
       queueRef.current.push(text2);
       setQueued([...queueRef.current]);
@@ -135357,7 +135408,7 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
       return;
     }
     runTurn(text2);
-  }, [handleCommand, runTurn]);
+  }, [handleCommand, runTurn, setupRequired, onboardingState]);
   import_react26.useEffect(() => {
     if (busy || queueRef.current.length === 0)
       return;
@@ -135681,78 +135732,169 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
         skin: ghostSkin,
         size: splashSize
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
+      setupRequired ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
         marginTop: 1,
+        flexDirection: "column",
+        alignItems: "center",
         children: [
           /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-            color: color.dim,
-            children: "talk or type "
+            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: [
-              glyph.bullet,
-              " "
+              "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.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 ",
+              "paste-detect: ",
               /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
                 color: color.accent,
-                children: "?"
+                children: "/account add <api-key>"
               }, undefined, false, undefined, this),
-              " for shortcuts · ",
+              "  ·  list: ",
               /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
                 color: color.accent,
-                children: "shift+tab"
+                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),
-              " cycles modes · ",
               /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-                color: color.accent,
-                children: "⌃Y"
+                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),
-              " copies the last reply"
+              /* @__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),
-          /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Text, {
-            color: color.faint,
-            children: demo ? "set ANTHROPIC_API_KEY (or another provider) to start — running in demo mode" : "/config inline on for terminal scrollback · /keys for shortcuts"
-          }, undefined, false, 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) : null
+      }, undefined, true, undefined, this)
     ]
   }, undefined, true, undefined, this);
   const paletteJsx = pickerRows.length || cmdMatches.length || fileMatches.length ? /* @__PURE__ */ jsx_dev_runtime12.jsxDEV(Box_default, {
@@ -135780,7 +135922,7 @@ function App2({ selector: initialSelector, demo, runner, fullscreen = false, res
     value: edit2.value,
     cursor: edit2.cursor,
     selectionAnchor: edit2.selectionAnchor,
-    placeholder: mode2 === "plan" ? "describe what to plan…" : "ask anything",
+    placeholder: setupRequired ? "add a provider with /account add <provider> <api-key>" : mode2 === "plan" ? "describe what to plan…" : "ask anything",
     suggestion,
     busy,
     width,
@@ -135996,8 +136138,10 @@ Options:
   -v, --version       print version
   -h, --help          this help
 
-Set at least one provider key first (each user uses their own):
-  ANTHROPIC_API_KEY · OPENAI_API_KEY · GOOGLE_GENERATIVE_AI_API_KEY · DEEPSEEK_API_KEY
+Set up at least one provider first:
+  gearbox auth add <api-key>
+  gearbox auth add <provider> <api-key>
+  gearbox auth import
 
 Models: ${MODELS.map((m2) => m2.label).join(", ")}
 In-app: / for commands, @ for files, !cmd for shell, shift+tab for plan mode.`);
@@ -136056,7 +136200,6 @@ Importable from your env (gearbox auth import): ${imp.map((c) => c.envVar).join(
 }
 var mi = args.indexOf("--model");
 var preferred = mi >= 0 ? args[mi + 1] : undefined;
-var demo = !anyProviderAvailable();
 var pinned = preferred ?? loadPrefs().pinnedModel;
 var selector = pinned ? new FixedSelector(pinned) : new RoutingSelector;
 if (args.includes("--yolo"))
@@ -136090,7 +136233,6 @@ if (mouse)
   process.stdout.write("\x1B[?1000h\x1B[?1002h\x1B[?1006h");
 var app = render_default(/* @__PURE__ */ jsx_dev_runtime13.jsxDEV(App2, {
   selector,
-  demo,
   fullscreen,
   resumeId
 }, undefined, false, undefined, this), { exitOnCtrlC: false });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gearbox-code",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A beautiful multi-provider coding harness for the terminal. (Intelligent model routing lands on top of this soon.)",
   "type": "module",
   "license": "MIT",