free-coding-models 0.5.27 → 0.5.28

package/changelog/v0.5.27.md

@@ -13,3 +13,5 @@
 
 ### Fixed
 - Fixed first-run usability for keyless providers by allowing Kilo and LLM7 to count as usable providers without forcing the API key wizard.
+- Fixed Docker dashboard 404s by serving the Web Router Dashboard aliases (`/api/router/status`, `/api/router/stats`, `/api/router/sets`, `/api/router/tokens`, `/api/router/quick-setup`) and `/api/changelog` directly from the router daemon.
+- Fixed confusing "pending" status for models not in the active router set. Models outside the set now show a distinct "NOT IN SET" label with a dim dot and faded row, instead of the animated yellow "wait" indicator. Applies to Web Dashboard (both Docker daemon and local dev mode).

package/changelog/v0.5.28.md

@@ -0,0 +1,5 @@
+# Changelog v0.5.28 - 2026-06-11
+
+### Fixed
+- Fixed Docker dashboard 404s — the router daemon now serves 10 web dashboard API aliases (`/api/router/status`, `/api/router/stats`, `/api/router/sets`, `/api/router/tokens`, `/api/router/quick-setup`, `/api/router/start`, `/api/router/stop`, `/api/router/probe-mode`, `/api/router/sets/:name/*`, `/api/changelog`) directly, so the React frontend works identically in Docker mode and local dev. Cross-origin guards protect mutating endpoints. (Fixes #116, reported by @stgreenb)
+- Fixed confusing "pending" status for models not in the active router set — models outside the set now show a distinct "NOT IN SET" label with a dim gray dot and faded row opacity, instead of the animated yellow "wait" indicator. The `inRouterSet` field is now exposed by both the Docker daemon and the local web server. (Fixes #117, reported by @stgreenb)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.5.27",
+  "version": "0.5.28",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/src/core/config.js

@@ -210,6 +210,18 @@ function normalizeFavoriteList(favorites) {
   return normalized
 }
 
+// 📖 normalizeStringSet: Convert an array (from JSON) or existing Set into a Set<string>.
+// 📖 Used for hiddenModels and similar set-shaped config fields.
+function normalizeStringSet(value) {
+  if (value instanceof Set) return value
+  if (!Array.isArray(value)) return new Set()
+  const result = new Set()
+  for (const entry of value) {
+    if (typeof entry === 'string' && entry.trim()) result.add(entry.trim())
+  }
+  return result
+}
+
 function normalizeApiKeyValue(value) {
   if (Array.isArray(value)) {
     const normalized = []
@@ -263,6 +275,7 @@ function normalizeSettingsSection(settings) {
     hideUnconfiguredModels: typeof safeSettings.hideUnconfiguredModels === 'boolean' ? safeSettings.hideUnconfiguredModels : true,
     favoritesPinnedAndSticky: typeof safeSettings.favoritesPinnedAndSticky === 'boolean' ? safeSettings.favoritesPinnedAndSticky : false,
     runAiSpeedTestOnStartup: typeof safeSettings.runAiSpeedTestOnStartup === 'boolean' ? safeSettings.runAiSpeedTestOnStartup : false,
+    autoHideBrokenModels: typeof safeSettings.autoHideBrokenModels === 'boolean' ? safeSettings.autoHideBrokenModels : true,
     theme: ['dark', 'light', 'auto'].includes(safeSettings.theme) ? safeSettings.theme : 'auto',
   }
 }
@@ -471,8 +484,9 @@ function normalizeConfigShape(config) {
     favorites: normalizeFavoriteList(safeConfig.favorites),
     telemetry: normalizeTelemetrySection(safeConfig.telemetry),
     endpointInstalls: normalizeEndpointInstalls(safeConfig.endpointInstalls),
-
-
+    // 📖 hiddenModels: Set of "provider/modelId" keys auto-hidden by the 404 probe (Ctrl+Shift+P).
+    // 📖 Only populated when settings.autoHideBrokenModels is true (default).
+    hiddenModels: normalizeStringSet(safeConfig.hiddenModels),
   }
   const normalizedRouter = normalizeRouterConfig(safeConfig.router)
   if (normalizedRouter) normalized.router = normalizedRouter
@@ -684,8 +698,12 @@ export function saveConfig(config, options = {}) {
 
   try {
     const persistedConfig = buildPersistedConfig(config, readStoredConfigSnapshot(), options)
-    const json = JSON.stringify(persistedConfig, null, 2)
-    writeFileSync(tempPath, json, { mode: 0o600 })
+    // 📖 Serialize Sets to arrays for JSON compatibility (e.g. hiddenModels)
+    const jsonSafe = JSON.stringify(persistedConfig, (key, value) => {
+      if (value instanceof Set) return [...value]
+      return value
+    }, 2)
+    writeFileSync(tempPath, jsonSafe, { mode: 0o600 })
     renameSync(tempPath, CONFIG_PATH)
 
     // 📖 Verify the write succeeded by reading back and validating
@@ -1082,6 +1100,7 @@ export function _emptyProfileSettings() {
     hideUnconfiguredModels: true, // 📖 true = default to providers that are actually configured
     favoritesPinnedAndSticky: false, // 📖 default mode keeps favorites as normal starred rows; press Y to pin+stick them.
     runAiSpeedTestOnStartup: false, // 📖 opt-in: automatically fire the Ctrl+U global AI Speed Test after startup.
+    autoHideBrokenModels: true, // 📖 opt-out: auto-hide models that return 404/410 from probe (Ctrl+Shift+P).
     preferredToolMode: 'opencode', // 📖 remember the last Z-selected launcher across app restarts
     theme: 'auto',        // 📖 'auto' follows the terminal/OS theme, override with 'dark' or 'light' if needed
   }
@@ -1131,5 +1150,6 @@ function _emptyConfig() {
     telemetry: { enabled: null, consentVersion: 0, anonymousId: null },
     endpointInstalls: [],
     settings: _emptyProfileSettings(),
+    hiddenModels: new Set(),
   }
 }

package/src/core/router-daemon.js

@@ -49,6 +49,7 @@ import {
 } from './config.js'
 import { buildChatCompletionPingBody, ping, resolveCloudflareUrl, shouldUseDisabledThinkingForProvider } from './ping.js'
 import { benchmarkModel, BENCHMARK_TIMEOUT_MS } from './benchmark.js'
+import { loadChangelog } from './changelog-loader.js'
 import { sendUsageTelemetry } from './telemetry.js'
 
 export const ROUTER_DEFAULT_PORT = 19280
@@ -2397,8 +2398,8 @@ class RouterRuntime {
    * 📖 with only the ones that come back 2xx. Returns the new set + a
    * 📖 sample of probe results so the UI can show "what changed".
    */
-  async handleSyncSetRequest(req, res, requestId) {
-    const url = req.url ? new URL(req.url, 'http://localhost') : null
+  async handleSyncSetRequest(req, res, requestId, routeUrl = null) {
+    const url = routeUrl || (req.url ? new URL(req.url, 'http://localhost') : null)
     const pathname = url ? url.pathname : ''
     const setSyncMatch = pathname.match(/^\/sets\/([^/]+)\/sync$/)
     if (!setSyncMatch) {
@@ -2524,6 +2525,87 @@ class RouterRuntime {
         await this.handleProbeModeRequest(req, res, requestId)
         return
       }
+
+      // 📖 Docker mode serves the built Web Dashboard directly from the daemon
+      // 📖 on :19280. The React app uses the same `/api/router/*` routes as
+      // 📖 local dev (`web/server.js`), so the daemon must expose aliases for
+      // 📖 its canonical `/health`, `/stats`, and `/sets` APIs instead of
+      // 📖 forcing the frontend to special-case Docker.
+      if (req.method === 'GET' && url.pathname === '/api/router/status') {
+        sendJson(res, 200, this.statusPayload(), { 'x-request-id': requestId })
+        return
+      }
+      if (req.method === 'GET' && url.pathname === '/api/router/stats') {
+        sendJson(res, 200, this.statsPayload(), { 'x-request-id': requestId })
+        return
+      }
+      if (req.method === 'GET' && url.pathname === '/api/router/tokens') {
+        sendJson(res, 200, this.tokenTracker.summary(), { 'x-request-id': requestId })
+        return
+      }
+      if (req.method === 'GET' && url.pathname === '/api/router/quick-setup') {
+        const router = this.routerConfig()
+        sendJson(res, 200, {
+          running: true,
+          port: this.port,
+          baseUrl: `http://127.0.0.1:${this.port}/v1`,
+          model: 'fcm',
+          activeSet: router.activeSet || DEFAULT_ROUTER_SETTINGS.activeSet,
+          apiKey: 'not-needed',
+        }, { 'x-request-id': requestId })
+        return
+      }
+      if (url.pathname === '/api/router/start') {
+        if (req.method !== 'POST') {
+          sendError(res, 405, 'Method not allowed', 'invalid_request_error', 'method_not_allowed', requestId, { allowed: ['POST'] })
+          return
+        }
+        if (!isSameOriginOrLocal(req)) {
+          sendError(res, 403, 'Forbidden cross-origin request', 'invalid_request_error', 'forbidden_origin', requestId)
+          return
+        }
+        sendJson(res, 200, { ...this.statusPayload(), alreadyRunning: true }, { 'x-request-id': requestId })
+        return
+      }
+      if (url.pathname === '/api/router/stop') {
+        if (req.method !== 'POST') {
+          sendError(res, 405, 'Method not allowed', 'invalid_request_error', 'method_not_allowed', requestId, { allowed: ['POST'] })
+          return
+        }
+        if (!isSameOriginOrLocal(req)) {
+          sendError(res, 403, 'Forbidden cross-origin request', 'invalid_request_error', 'forbidden_origin', requestId)
+          return
+        }
+        sendJson(res, 200, { ok: true, stopped: true, message: 'Daemon shutting down' }, { 'x-request-id': requestId })
+        setTimeout(() => this.shutdown(0), 50)
+        return
+      }
+      if (url.pathname === '/api/router/probe-mode' && req.method === 'POST') {
+        if (!isSameOriginOrLocal(req)) {
+          sendError(res, 403, 'Forbidden cross-origin request', 'invalid_request_error', 'forbidden_origin', requestId)
+          return
+        }
+        await this.handleProbeModeRequest(req, res, requestId)
+        return
+      }
+      if (req.method === 'GET' && url.pathname === '/api/changelog') {
+        sendJson(res, 200, loadChangelog(), { 'x-request-id': requestId })
+        return
+      }
+      if (url.pathname === '/api/router/sets' || url.pathname.startsWith('/api/router/sets/')) {
+        if (req.method !== 'GET' && !isSameOriginOrLocal(req)) {
+          sendError(res, 403, 'Forbidden cross-origin request', 'invalid_request_error', 'forbidden_origin', requestId)
+          return
+        }
+        const aliasedUrl = new URL(req.url, `http://localhost:${this.port}`)
+        aliasedUrl.pathname = aliasedUrl.pathname.replace(/^\/api\/router/, '')
+        if (/^\/sets\/[^/]+\/sync$/.test(aliasedUrl.pathname) && req.method === 'POST') {
+          await this.handleSyncSetRequest(req, res, requestId, aliasedUrl)
+          return
+        }
+        await this.handleSetsRequest(req, res, aliasedUrl, requestId)
+        return
+      }
       if (url.pathname === '/sets' || url.pathname.startsWith('/sets/')) {
         // 📖 /sets/:name/sync has a different return type (rebuilds the
         // 📖 set from probes) so it gets its own handler.

package/src/tui/app.js

@@ -315,6 +315,18 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
       isPinging: false, // 📖 Per-row live flag so Last Ping can keep last value and show a spinner during refresh.
       hidden: false,  // 📖 Simple flag to hide/show models
     }))
+
+  // 📖 Auto-hide models that were previously marked broken by the 404 probe.
+  // 📖 Only applies when autoHideBrokenModels setting is enabled (default).
+  if (config.settings?.autoHideBrokenModels !== false && config.hiddenModels instanceof Set) {
+    for (const r of results) {
+      const modelKey = `${r.providerKey}/${r.modelId}`
+      if (config.hiddenModels.has(modelKey)) {
+        r.hidden = true
+      }
+    }
+  }
+
   syncFavoriteFlags(results, config)
   // 📖 Garbage-collect favorites that reference models no longer in sources.js,
   // 📖 so the router dashboard only shows real, launchable models.
@@ -826,6 +838,10 @@ export async function runApp(cliArgs, config, startupOptions = {}) {
       benchmarkResults: state.benchmarkResults,
       benchmarkRunning: state.benchmarkRunning,
       headerFlashColumn: state.headerFlashColumn,
+      probeRunning: state.probeRunning,
+      probeTotal: state.probeTotal,
+      probeCompleted: state.probeCompleted,
+      probeHiddenCount: state.probeHiddenCount,
     }
     if (state.commandPaletteOpen) {
       if (!state.commandPaletteFrozenTable) {

package/src/tui/command-palette.js

@@ -200,7 +200,8 @@ const BASE_COMMAND_TREE = [
         ],
       },
       { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
-      { id: 'action-reset-view', label: 'Reset view', shortcut: 'N', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+      { id: 'action-reset-view', label: 'Reset view', shortcut: 'N', icon: '\u{1F504}', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+      { id: 'action-probe-404', label: 'Probe 404 Models', shortcut: 'Ctrl+Shift+P', icon: '\u{1F50D}', description: 'Test all configured models for 404/410 errors. Auto-hides broken models.', keywords: ['probe', '404', 'broken', 'dead', 'health', 'check', 'test', 'verify'] },
     ],
   },
   // 📖 Pages - directly at root level, not in submenu

package/src/tui/key-handler.js

@@ -792,6 +792,42 @@ export function createKeyHandler(ctx) {
     })
   }
 
+  // 📖 toggleAutoHideBrokenModels: Toggle auto-hiding of 404/410 models from probe.
+  // 📖 When disabling, unhide all previously hidden models so they become visible again.
+  function toggleAutoHideBrokenModels() {
+    if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+    const wasEnabled = state.config.settings.autoHideBrokenModels !== false
+    state.config.settings.autoHideBrokenModels = !wasEnabled
+
+    if (!wasEnabled) {
+      // 📖 Just enabled — models that were hidden before enabling will be picked up on next probe
+    } else {
+      // 📖 Just disabled — unhide all probe-hidden models so user can see them again
+      if (state.config.hiddenModels instanceof Set && state.config.hiddenModels.size > 0) {
+        const keysToUnhide = [...state.config.hiddenModels]
+        state.config.hiddenModels.clear()
+        for (const key of keysToUnhide) {
+          const [pk, ...rest] = key.split('/')
+          const modelId = rest.join('/')
+          const result = state.results.find(r => r.providerKey === pk && r.modelId === modelId)
+          if (result) result.hidden = false
+        }
+      }
+    }
+
+    saveConfig(state.config)
+    const hiddenCount = state.config.hiddenModels instanceof Set ? state.config.hiddenModels.size : 0
+    state.settingsSyncStatus = {
+      type: 'success',
+      msg: state.config.settings.autoHideBrokenModels
+        ? `✅ Auto-hide enabled — broken models (404/410) from Ctrl+Shift+P probe are hidden automatically.${hiddenCount ? ` (${hiddenCount} currently hidden)` : ''}`
+        : '✅ Auto-hide disabled — all models are visible. Previously hidden models have been unhidden.',
+    }
+    trackAppAction('auto_hide_broken_models_toggled', {
+      enabled: state.config.settings.autoHideBrokenModels !== false,
+    })
+  }
+
   function toggleShellEnv() {
     if (!state.config.settings) state.config.settings = {}
     const currentlyEnabled = state.config.settings.shellEnvEnabled === true
@@ -1132,6 +1168,96 @@ export function createKeyHandler(ctx) {
     return Promise.all(workers).then(() => results)
   }
 
+  // 📖 runBrokenModelProbe: Probe all configured models for 404/broken endpoints.
+  // 📖 Sends a real chat-completion request to each model with an API key.
+  // 📖 Models returning 404 or 410 are auto-hidden when setting is enabled.
+  // 📖 Results flash live in the TUI table — models flip status in real time.
+  async function runBrokenModelProbe(state) {
+    if (state.probeRunning) return
+
+    // 📖 Only probe models where the user has an API key configured
+    const probeable = state.results.filter(r => {
+      const apiKey = getApiKey(state.config, r.providerKey)
+      return !!apiKey
+    })
+
+    if (probeable.length === 0) return
+
+    state.probeRunning = true
+    state.probeTotal = probeable.length
+    state.probeCompleted = 0
+    state.probeHiddenCount = 0
+
+    const autoHide = state.config.settings?.autoHideBrokenModels !== false
+    const HTTP_CODES_404 = new Set([404, '404'])
+    const HTTP_CODES_GONE = new Set([410, '410'])
+
+    const tasks = probeable.map(r => async () => {
+      const apiKey = getApiKey(state.config, r.providerKey) ?? null
+      const providerUrl = sources[r.providerKey]?.url ?? null
+      if (!apiKey || !providerUrl) {
+        state.probeCompleted++
+        return { model: r, ok: false, reason: 'no_key' }
+      }
+
+      try {
+        const { code } = await ping(apiKey, r.modelId, r.providerKey, providerUrl)
+        state.probeCompleted++
+
+        if (HTTP_CODES_404.has(code) || HTTP_CODES_GONE.has(code)) {
+          // 📖 Model is broken (404/410) — mark it
+          r.status = 'down'
+          r.httpCode = String(code)
+
+          if (autoHide) {
+            const modelKey = `${r.providerKey}/${r.modelId}`
+            if (!state.config.hiddenModels) state.config.hiddenModels = new Set()
+            state.config.hiddenModels.add(modelKey)
+            r.hidden = true
+            state.probeHiddenCount++
+          }
+
+          return { model: r, ok: false, code, reason: 'broken' }
+        } else if (code === '200') {
+          // 📖 Model is alive — unhide if it was previously hidden by probe
+          const modelKey = `${r.providerKey}/${r.modelId}`
+          if (state.config.hiddenModels?.has(modelKey)) {
+            state.config.hiddenModels.delete(modelKey)
+            r.hidden = false
+          }
+          r.status = 'up'
+          return { model: r, ok: true, code }
+        } else {
+          // 📖 Other codes (401, 429, etc.) — leave status unchanged, don't hide
+          return { model: r, ok: false, code, reason: 'other' }
+        }
+      } catch (err) {
+        state.probeCompleted++
+        return { model: r, ok: false, reason: 'error', error: err?.message }
+      }
+    })
+
+    await runWithConcurrency(tasks, 5)
+
+    // 📖 Persist hidden models set to config
+    if (autoHide && state.probeHiddenCount > 0) {
+      saveConfig(state.config)
+    }
+
+    state.probeRunning = false
+    // 📖 Keep totals visible for a few seconds so user can see results
+    setTimeout(() => {
+      if (!state.probeRunning) {
+        state.probeTotal = 0
+        state.probeCompleted = 0
+        // 📖 Don't reset probeHiddenCount immediately — user needs to see how many were hidden
+        setTimeout(() => {
+          state.probeHiddenCount = 0
+        }, 5000)
+      }
+    }, 3000)
+  }
+
   // 📖 runGlobalBenchmark: Benchmark all visible models with up to 5 concurrent requests.
   // 📖 Results are stored in state.benchmarkResults (same format as individual benchmarks).
   async function runGlobalBenchmark(state) {
@@ -1486,6 +1612,7 @@ export function createKeyHandler(ctx) {
       case 'action-toggle-favorite': return toggleFavoriteOnSelectedRow()
       case 'action-toggle-favorite-mode': return toggleFavoritesDisplayMode()
       case 'action-reset-view': return resetViewSettings()
+      case 'action-probe-404': return runBrokenModelProbe(state)
       default:
         return
     }
@@ -1512,13 +1639,22 @@ export function createKeyHandler(ctx) {
     }
 
     // 📖 Ctrl+U: Global AI Speed Benchmark (benchmark all visible models, 5 concurrent)
-    // 📖 Also handles the raw \x15 byte as a fallback for terminals where readline doesn't
-    // 📖 set key.ctrl properly (same pattern as Ctrl+C → \x03 fallback).
+    // Also handles the raw \x15 byte as a fallback for terminals where readline doesn't
+    // set key.ctrl properly (same pattern as Ctrl+C → \x03 fallback).
     if ((key.ctrl && key.name === 'u') || str === '\x15') {
       await runGlobalBenchmark(state)
       return
     }
 
+    // 📖 Ctrl+Shift+P: Probe all configured models for 404/broken endpoints.
+    // 📖 Sends a real chat-completion request to every model that has an API key.
+    // 📖 Models returning 404/410 are auto-hidden (when setting is enabled).
+    // 📖 Results flash live in the table — models flip from down→up in real time.
+    if (key.ctrl && key.shift && key.name === 'p') {
+      await runBrokenModelProbe(state)
+      return
+    }
+
     // 📖 Command palette captures the keyboard while active.
     if (state.commandPaletteOpen) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
@@ -2534,7 +2670,8 @@ export function createKeyHandler(ctx) {
       const themeRowIdx = updateRowIdx + 1
       const favoritesModeRowIdx = themeRowIdx + 1
       const startupAiSpeedScanRowIdx = favoritesModeRowIdx + 1
-      const cleanupLegacyProxyRowIdx = startupAiSpeedScanRowIdx + 1
+      const autoHideBrokenModelsRowIdx = startupAiSpeedScanRowIdx + 1
+      const cleanupLegacyProxyRowIdx = autoHideBrokenModelsRowIdx + 1
       const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
       const shellEnvRowIdx = changelogViewRowIdx + 1
         // 📖 Profile system removed - API keys now persist permanently across all sessions
@@ -2696,6 +2833,12 @@ export function createKeyHandler(ctx) {
           return
         }
 
+        // 📖 Auto-hide broken models toggle
+        if (state.settingsCursor === autoHideBrokenModelsRowIdx) {
+          toggleAutoHideBrokenModels()
+          return
+        }
+
         if (state.settingsCursor === cleanupLegacyProxyRowIdx) {
           runLegacyProxyCleanup()
           return
@@ -2753,6 +2896,11 @@ export function createKeyHandler(ctx) {
           toggleStartupAiSpeedScan()
           return
         }
+        // 📖 Auto-hide broken models toggle (space)
+        if (state.settingsCursor === autoHideBrokenModelsRowIdx) {
+          toggleAutoHideBrokenModels()
+          return
+        }
         // 📖 Profile system removed - API keys now persist permanently across all sessions
 
         // 📖 Toggle enabled/disabled for selected provider
@@ -2770,6 +2918,7 @@ export function createKeyHandler(ctx) {
           || state.settingsCursor === themeRowIdx
           || state.settingsCursor === favoritesModeRowIdx
           || state.settingsCursor === startupAiSpeedScanRowIdx
+          || state.settingsCursor === autoHideBrokenModelsRowIdx
           || state.settingsCursor === cleanupLegacyProxyRowIdx
           || state.settingsCursor === changelogViewRowIdx
         ) return

package/src/tui/overlays.js

@@ -121,7 +121,8 @@ export function createOverlayRenderers(state, deps) {
     const themeRowIdx = updateRowIdx + 1
     const favoritesModeRowIdx = themeRowIdx + 1
     const startupAiSpeedScanRowIdx = favoritesModeRowIdx + 1
-    const cleanupLegacyProxyRowIdx = startupAiSpeedScanRowIdx + 1
+    const autoHideBrokenModelsRowIdx = startupAiSpeedScanRowIdx + 1
+    const cleanupLegacyProxyRowIdx = autoHideBrokenModelsRowIdx + 1
     const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
     const shellEnvRowIdx = changelogViewRowIdx + 1
     const EL = '\x1b[K'
@@ -277,6 +278,16 @@ export function createOverlayRenderers(state, deps) {
     cursorLineByRow[startupAiSpeedScanRowIdx] = lines.length
     lines.push(state.settingsCursor === startupAiSpeedScanRowIdx ? themeColors.bgCursorSettingsList(startupAiSpeedScanRow) : startupAiSpeedScanRow)
 
+    // 📖 Auto-hide broken models row: toggles auto-hiding of 404/410 models from probe.
+    const autoHideEnabled = state.config.settings?.autoHideBrokenModels !== false
+    const hiddenCount = state.config.hiddenModels instanceof Set ? state.config.hiddenModels.size : 0
+    const autoHideStatus = autoHideEnabled
+      ? themeColors.successBold(`✅ Enabled (${hiddenCount} hidden)`)
+      : themeColors.errorBold('❌ Disabled')
+    const autoHideRow = `${bullet(state.settingsCursor === autoHideBrokenModelsRowIdx)}${themeColors.textBold('Auto-hide Broken Models').padEnd(44)} ${autoHideStatus}`
+    cursorLineByRow[autoHideBrokenModelsRowIdx] = lines.length
+    lines.push(state.settingsCursor === autoHideBrokenModelsRowIdx ? themeColors.bgCursorSettingsList(autoHideRow) : autoHideRow)
+
     if (updateState === 'error' && state.settingsUpdateError) {
       lines.push(themeColors.error(`      ${state.settingsUpdateError}`))
     }
@@ -950,6 +961,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('Ctrl+P')}  Open ⚡️ command palette  ${hint('(search and run actions quickly)')}`)
     lines.push(`  ${key('Ctrl+A')}  AI Speed Test  ${hint('(benchmark selected model → time + TPS)')}`)
     lines.push(`  ${key('Ctrl+U')}  Global AI Speed Test  ${hint('(benchmark all models; Settings can auto-run it on startup)')}`)
+    lines.push(`  ${key('Ctrl+Shift+P')}  Probe 404 Models  ${hint('(test all configured models; auto-hide broken 404/410)')}`)
     lines.push(`  ${key('E')}  Cycle filter mode  ${hint('(Normal → Configured only → Usable only)')}`)
     lines.push(`  ${key('Z')}  Cycle tool mode  ${hint('(📦 OpenCode → π Pi → 🪼 jcode → 📦 Desktop → 🦞 OpenClaw → 💘 Crush → 🪿 Goose → 🛠 Aider → 🐉 Qwen → 🤲 OpenHands → ⚡ Amp)')}`)
     lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(1️⃣2️⃣3️⃣ = router fallback order, capped at 🔟)')}`)

package/src/tui/render-table.js

@@ -192,6 +192,10 @@ export function renderTable({
   benchmarkResults = {},
   benchmarkRunning = new Set(),
   headerFlashColumn = null,
+  probeRunning = false,
+  probeTotal = 0,
+  probeCompleted = 0,
+  probeHiddenCount = 0,
 } = _) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
@@ -1157,13 +1161,25 @@ export function renderTable({
   const speedTestLabel = chalk.bgRgb(...currentPalette().badgeSpeedTestBg).rgb(...currentPalette().badgeSpeedTestFg).bold(' NEW ⭐️ Ctrl+A 🤖 AI Speed Test ')
   const globalBenchmarkLabel = chalk.bgRgb(...currentPalette().badgeBenchmarkBg).rgb(...currentPalette().badgeBenchmarkFg).bold(' NEW Ctrl+U : Global AI Speed Test (Uses a lot of requests!) ')
 
-  // 📖 Line 3: Speed Test (Ctrl+A) + Global Benchmark (Ctrl+U) + Last release
-  if (releaseLabel || speedTestLabel || globalBenchmarkLabel) {
+  // 📖 Probe badge: show progress when 404 probe is running or recently completed
+  let probeLabel = ''
+  if (probeRunning) {
+    const pct = probeTotal > 0 ? Math.round((probeCompleted / probeTotal) * 100) : 0
+    const bar = '█'.repeat(Math.floor(pct / 5)) + '░'.repeat(20 - Math.floor(pct / 5))
+    probeLabel = chalk.bgRgb(180, 40, 40).rgb(255, 255, 255).bold(` 🔍 Probe ${bar} ${probeCompleted}/${probeTotal} `)
+  } else if (probeHiddenCount > 0 && probeTotal > 0) {
+    probeLabel = chalk.bgRgb(120, 60, 60).rgb(255, 200, 200).bold(` 🔍 Probe done: ${probeHiddenCount} broken model${probeHiddenCount > 1 ? 's' : ''} hidden `)
+  }
+
+  // 📖 Line 3: Speed Test + Global Benchmark + Probe + Last release
+  if (releaseLabel || speedTestLabel || globalBenchmarkLabel || probeLabel) {
     const parts = [
       { text: '  ', key: null },
       { text: speedTestLabel, key: 'a' },
       { text: '  ', key: null },
       { text: globalBenchmarkLabel, key: 'u' },
+      { text: probeLabel ? '  ' : '', key: null },
+      { text: probeLabel, key: null },
       { text: '  ', key: null },
       { text: releaseLabel, key: null },
     ]

package/src/tui/tui-state.js

@@ -280,6 +280,12 @@ export function createTuiState({
     globalBenchmarkTotal: 0,
     globalBenchmarkCompleted: 0,
 
+    // 📖 404 Probe state (Ctrl+Shift+P)
+    probeRunning: false,
+    probeTotal: 0,
+    probeCompleted: 0,
+    probeHiddenCount: 0,
+
     // 📖 Header click flash animation: briefly highlights the clicked column header
     // 📖 with an inverse/bright style for ~250ms (3 frames at 12 FPS).
     headerFlashColumn: null,       // 📖 Column name being flashed (null = no flash active)