switchboard-fyi 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable Switchboard CLI changes are recorded here. Keep this file in sync
 with the hosted release notes at `https://www.switchboard.fyi/release/latest`.
 
+## 0.2.2 - 2026-05-26
+
+### Fixed
+
+- Regenerated `codex` and `claude` shims now launch Switchboard through stable
+  `switchboard-fyi`/`switchboard` commands before falling back to direct script
+  paths, so Homebrew and npm upgrades no longer leave shims pointing at removed
+  versioned install directories.
+
+## 0.2.1 - 2026-05-26
+
+### Changed
+
+- Require `switchboard login` before local routing, observe mode, dashboard,
+  install, uninstall, settings, and difficulty mapping commands do any work.
+- Updated the signed-out home and status screens to point users toward login
+  instead of showing local routing stats or enabled actions.
+
 ## 0.2.0 - 2026-05-26
 
 ### Changed

package/bin/switchboard.mjs

@@ -42,6 +42,7 @@ const HARNESS_COMMANDS = {
   codex: "codex",
   claude: "claude",
 };
+const SWITCHBOARD_COMMAND_NAMES = ["switchboard-fyi", "switchboard"];
 const SHIM_PATH_START = "# >>> switchboard PATH >>>";
 const SHIM_PATH_END = "# <<< switchboard PATH <<<";
 const COMPONENT_STATUS_IDS = ["claude", "codex", "api"];
@@ -516,6 +517,7 @@ async function runCodex(argv) {
     return runRealHarnessDirect("codex", codexBinary, argv, {
       env: directHarnessEnv(),
     });
+  requireSwitchboardAuth();
   const observeMode =
     requestedObserve ||
     activeState.mode === "observe";
@@ -726,6 +728,7 @@ async function runClaude(argv) {
     return runRealHarnessDirect("claude", claudeBinary, argv, {
       env: directClaudeEnv(),
     });
+  requireSwitchboardAuth();
   const observeMode =
     requestedObserve ||
     activeState.mode === "observe";
@@ -1110,6 +1113,25 @@ function switchboardScriptPath() {
   return path.resolve(decodeURIComponent(new URL(import.meta.url).pathname));
 }
 
+function isVersionedSwitchboardInstallPath(file) {
+  const normalized = String(file || "").split(path.sep).join("/");
+  return (
+    normalized.includes("/Cellar/switchboard-fyi/") ||
+    normalized.includes("/.npm/_npx/") ||
+    normalized.includes("/_npx/")
+  );
+}
+
+function stableSwitchboardCommandPath() {
+  for (const name of SWITCHBOARD_COMMAND_NAMES) {
+    for (const candidate of commandPaths(name)) {
+      if (!candidate || isVersionedSwitchboardInstallPath(candidate)) continue;
+      if (isUsableExecutable(candidate)) return candidate;
+    }
+  }
+  return "";
+}
+
 function readInstallState() {
   try {
     const parsed = JSON.parse(fs.readFileSync(installStatePath(), "utf8"));
@@ -1516,12 +1538,36 @@ function installTargets(argv) {
 function writeHarnessShim(harness, realPath) {
   const commandName = HARNESS_COMMANDS[harness];
   const switchboardCommand = harness === "codex" ? "codex" : "claude-code";
+  const switchboardCommandPath = stableSwitchboardCommandPath();
+  const fallbackNodePath = process.execPath;
+  const fallbackScriptPath = switchboardScriptPath();
   const content = [
     "#!/bin/sh",
     "# switchboard-shim",
     `export SWITCHBOARD_SHIM_HARNESS=${shellQuote(harness)}`,
     `export ${envRealBinaryName(harness)}=${shellQuote(realPath)}`,
-    `exec ${shellQuote(process.execPath)} ${shellQuote(switchboardScriptPath())} ${shellQuote(switchboardCommand)} "$@"`,
+    `SWITCHBOARD_CLI=${shellQuote(switchboardCommandPath)}`,
+    'if [ -n "${SWITCHBOARD_CLI_PATH:-}" ]; then',
+    `  SWITCHBOARD_CLI="$SWITCHBOARD_CLI_PATH"`,
+    "fi",
+    `if [ -n "$SWITCHBOARD_CLI" ] && [ -x "$SWITCHBOARD_CLI" ]; then`,
+    `  exec "$SWITCHBOARD_CLI" ${shellQuote(switchboardCommand)} "$@"`,
+    "fi",
+    `for SWITCHBOARD_CANDIDATE in ${SWITCHBOARD_COMMAND_NAMES.join(" ")}; do`,
+    `  SWITCHBOARD_CLI=$(command -v "$SWITCHBOARD_CANDIDATE" 2>/dev/null || true)`,
+    `  if [ -n "$SWITCHBOARD_CLI" ] && [ -x "$SWITCHBOARD_CLI" ]; then`,
+    `    exec "$SWITCHBOARD_CLI" ${shellQuote(switchboardCommand)} "$@"`,
+    "  fi",
+    "done",
+    `if [ -x ${shellQuote(fallbackNodePath)} ] && [ -f ${shellQuote(fallbackScriptPath)} ]; then`,
+    `  exec ${shellQuote(fallbackNodePath)} ${shellQuote(fallbackScriptPath)} ${shellQuote(switchboardCommand)} "$@"`,
+    "fi",
+    `SWITCHBOARD_NODE=$(command -v node 2>/dev/null || true)`,
+    `if [ -n "$SWITCHBOARD_NODE" ] && [ -f ${shellQuote(fallbackScriptPath)} ]; then`,
+    `  exec "$SWITCHBOARD_NODE" ${shellQuote(fallbackScriptPath)} ${shellQuote(switchboardCommand)} "$@"`,
+    "fi",
+    `echo "Switchboard shim could not find the Switchboard CLI. Reinstall Switchboard, then run \`switchboard install ${harness}\`." >&2`,
+    "exit 127",
     "",
   ].join("\n");
 
@@ -1532,8 +1578,9 @@ function writeHarnessShim(harness, realPath) {
     command: commandName,
     shimPath: shimPath(harness),
     realPath,
-    switchboardScript: switchboardScriptPath(),
-    nodePath: process.execPath,
+    switchboardCommandPath,
+    switchboardScript: fallbackScriptPath,
+    nodePath: fallbackNodePath,
     installedAt: new Date().toISOString(),
   };
 }
@@ -2142,6 +2189,7 @@ function renderHarnessEffortChoices(harness, model, value, active = false) {
 }
 
 async function showHarnessSettingsScreen(harness) {
+  requireSwitchboardAuth();
   const config = ensureConfigFile();
   const levels = [...DIFFICULTY_LEVELS].sort((a, b) => b - a);
   const models = harnessModelOptions(harness);
@@ -2301,6 +2349,7 @@ function showDifficulty(argv = []) {
     return;
   }
   if (action !== "set") throw new Error(`Unknown difficulty command: ${action}`);
+  requireSwitchboardAuth();
   const harness = assertHarness(argv.shift());
   const level = Number(argv.shift() || "");
   const model = String(argv.shift() || "").trim();
@@ -2762,6 +2811,13 @@ function authToken() {
   return process.env.SWITCHBOARD_API_TOKEN || readAuth()?.token || "";
 }
 
+const SIGN_IN_REQUIRED_MESSAGE = "Not logged in. Run `switchboard login` first.";
+
+function requireSwitchboardAuth() {
+  if (authToken()) return;
+  throw new Error(SIGN_IN_REQUIRED_MESSAGE);
+}
+
 const ACCOUNT_CACHE_TTL_MS = 30_000;
 const HOME_ACCOUNT_REFRESH_TIMEOUT_MS = 5000;
 let _balanceCache = null;
@@ -3990,13 +4046,15 @@ function switchboardAccountCard() {
 }
 
 function homeMenuOptions(installed, install = installSnapshot()) {
+  const loggedIn = Boolean(authToken());
   const harnessCard = (key, displayName) => {
     const info = install.harnesses[key] || {};
     const present = Boolean(installed[key] || info.realAvailable);
     const installedShim = Boolean(info.installed);
     const active = activeHarnessState(key);
-    const startDisabled = active.active;
-    const observeDisabled = active.active;
+    const signInDescription = `sign in first to use ${displayName}`;
+    const startDisabled = active.active || !loggedIn;
+    const observeDisabled = active.active || !loggedIn;
 
     let tag, tagTone;
     if (active.mode === "live") {
@@ -4021,12 +4079,20 @@ function homeMenuOptions(installed, install = installSnapshot()) {
     if (installedShim) {
       opts.push({
         type: "card-row",
-        content: `  ${dim(`switchboard is ready for ${displayName}`)}`,
+        content: `  ${dim(
+          loggedIn
+            ? `switchboard is ready for ${displayName}`
+            : `sign in before using switchboard for ${displayName}`,
+        )}`,
       });
     } else if (present) {
       opts.push({
         type: "card-row",
-        content: `  ${dim(`${displayName} is on your computer but not connected to switchboard yet`)}`,
+        content: `  ${dim(
+          loggedIn
+            ? `${displayName} is on your computer but not connected to switchboard yet`
+            : `${displayName} is on your computer — sign in before connecting switchboard`,
+        )}`,
       });
     } else {
       opts.push({
@@ -4040,38 +4106,50 @@ function homeMenuOptions(installed, install = installSnapshot()) {
       opts.push({
         label: "set up",
         value: `${key}-install`,
-        disabled: !present,
-        description: present
-          ? `start saving money with ${displayName}`
-          : `install ${displayName} on your computer first`,
+        disabled: !present || !loggedIn,
+        description: !present
+          ? `install ${displayName} on your computer first`
+          : loggedIn
+            ? `connect switchboard for ${displayName}`
+            : `sign in first to set up ${displayName}`,
       });
     } else {
       opts.push(
         {
           label: "start",
           value: `${key}-start`,
-          description: active.active
-            ? `close the other window first`
-            : `turn on switchboard for ${displayName}`,
+          description: !loggedIn
+            ? signInDescription
+            : active.active
+              ? `close the other window first`
+              : `turn on switchboard for ${displayName}`,
           disabled: startDisabled,
         },
         {
           label: "observe",
           value: `${key}-observe`,
-          description: active.active
-            ? `close the other window first`
-            : `watch ${displayName} without changing anything`,
+          description: !loggedIn
+            ? signInDescription
+            : active.active
+              ? `close the other window first`
+              : `watch ${displayName} without changing anything`,
           disabled: observeDisabled,
         },
         {
           label: "settings",
           value: `${key}-settings`,
-          description: `edit ${displayName} difficulty mappings`,
+          description: loggedIn
+            ? `edit ${displayName} difficulty mappings`
+            : `sign in first to edit ${displayName} settings`,
+          disabled: !loggedIn,
         },
         {
           label: "uninstall",
           value: `${key}-uninstall`,
-          description: `remove switchboard for ${displayName}`,
+          description: loggedIn
+            ? `remove switchboard for ${displayName}`
+            : `sign in first to change ${displayName} setup`,
+          disabled: !loggedIn,
         },
       );
     }
@@ -4130,6 +4208,7 @@ async function showActiveDashboard(
   activeMode = "live",
   options = {},
 ) {
+  requireSwitchboardAuth();
   const targets = dashboardTargets(argv);
   const claim = claimActiveHarnesses(targets, activeMode);
   if (claim.conflicts.length) {
@@ -4447,6 +4526,7 @@ function showInstall(argv = []) {
       "Switchboard install currently supports macOS and Linux. Windows shims are not available in this release.",
     );
   }
+  requireSwitchboardAuth();
   const noShellRc = argv.includes("--no-shell-rc");
   const forceShellRc = argv.includes("--shell-rc");
   const verbose =
@@ -4480,8 +4560,7 @@ function showInstall(argv = []) {
     );
   }
 
-  let shellRc = null;
-  if (!noShellRc || forceShellRc) shellRc = ensureShellPathBlock();
+  if (!noShellRc || forceShellRc) ensureShellPathBlock();
 
   console.log(`✓ Switchboard installed`);
   for (const { harness } of installed) {
@@ -4490,14 +4569,6 @@ function showInstall(argv = []) {
   for (const item of skipped) {
     console.log(`  ○ ${harnessLabel(item.harness)} not found`);
   }
-  console.log("");
-  if (noShellRc && !forceShellRc) {
-    console.log("Run this once in your shell:");
-    console.log(`  export PATH=${shellQuote(shimDir())}:$PATH`);
-  } else if (shellRc) {
-    console.log("Open a new terminal, then use:");
-    console.log(`  ${installed.map(({ entry }) => entry.command).join("  ")}`);
-  }
   ensureProcessPathHasShimDir();
   if (verbose) {
     console.log("");
@@ -4538,12 +4609,6 @@ function showUninstall(argv = []) {
   for (const harness of removed) {
     console.log(`  ✓ ${harnessLabel(harness)}`);
   }
-  console.log("");
-  console.log(
-    anyInstalled
-      ? "Remaining installed tools still use Switchboard."
-      : "Your tools now run normally.",
-  );
   if (verbose) {
     console.log("");
     printInstallSummary({ verbose: true });
@@ -5234,18 +5299,7 @@ function renderStatusStrip(
       statLines = [`  ${dim("checking account route stats…")}`];
     }
   } else {
-    const snapshot = statsSnapshot();
-    const totalReq = snapshot.rows.length;
-    const hasTraffic = totalReq > 0;
-    statLines = hasTraffic
-      ? [
-          statRow("local requests", compactNumber(totalReq)),
-          statRow(
-            "local tokens processed",
-            compactNumber(snapshot.processedTokens),
-          ),
-        ]
-      : [`  ${dim("no routes yet — sign in and start routing")}`];
+    statLines = [`  ${dim("sign in to start routing with switchboard")}`];
   }
 
   let identityLine = "";
@@ -6706,11 +6760,13 @@ function routeTaskDisplay(row) {
 }
 
 async function showDashboard(argv, options = {}) {
+  requireSwitchboardAuth();
   const harness = parseHarnessScope(argv);
   console.log(renderDashboard(harness));
 }
 
 async function showDashboardSession(argv, options = {}) {
+  requireSwitchboardAuth();
   const harness = parseHarnessScope(argv);
   const exitOnClose = options.exitOnClose !== false;
   const sessionStart = new Date().toISOString();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchboard-fyi",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Local model-routing CLI for Codex and Claude Code.",
   "license": "MIT",
   "homepage": "https://www.switchboard.fyi",