free-coding-models 0.3.62 → 0.3.64

package/CHANGELOG.md

@@ -1,10 +1,10 @@
-## [0.3.58] - 2026-05-04
+## [0.3.64] - 2026-05-06
 
-### Changed
+### Fixed
 
-- **E key filter ("Working only") now also hides `noauth` and `auth_error` models** — Previously E only filtered by missing API key. Now it also filters out models whose provider returned a 401/403 auth rejection, while still keeping `timeout` and `429` (rate-limited) models visible.
-- **Google AI Studio renamed to Google AI** — Shortened to avoid column overflow in the provider column.
+- **E footer spacing and color** — Fixed the active `E` footer label so the hotkey letter keeps its distinct hotkey color and is separated from the active filter text by a readable space. This makes the active filter state easier to scan in the TUI footer.
 
-### Fixed
+### Changed
 
-- **NVIDIA NIM column label** — The provider column in the TUI table now shows `NVIDIA NIM` instead of `NIM` to match the official provider branding.
+- **Clearer E filter names** — Renamed the `E` cycle from `Working only` / `Best mode` to `Configured only` / `Usable only`. The behavior is unchanged: `Configured only` keeps configured providers visible, while `Usable only` narrows the table to models with healthy status and usable verdicts.
+- **README TUI key reference** — Updated the `E` shortcut documentation to describe the full visibility cycle: `Active only → Configured only → Usable only`.

package/README.md

@@ -319,7 +319,7 @@ When a tool mode is active (via `Z`), models incompatible with that tool are hig
 | `Z` | Cycle target tool |
 | `T` | Cycle tier filter |
 | `D` | Cycle provider filter |
-| `E` | Toggle configured-only mode |
+| `E` | Cycle visibility filter (`Active only → Configured only → Usable only`) |
 | `F` | Favorite / unfavorite model |
 | `Y` | Toggle favorites mode (`Normal filter/sort` default ↔ `Pinned + always visible`) |
 | `X` | Clear active custom text filter |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.62",
+  "version": "0.3.64",
   "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/app.js

@@ -111,7 +111,7 @@ import { resolveCloudflareUrl, buildPingRequest, ping, extractQuotaPercent, getP
 import { runFiableMode, filterByTierOrExit, fetchOpenRouterFreeModels } from '../src/analysis.js'
 import { PROVIDER_METADATA, ENV_VAR_NAMES, isWindows, isMac } from '../src/provider-metadata.js'
 import { parseTelemetryEnv, isTelemetryDebugEnabled, telemetryDebug, ensureTelemetryConfig, getTelemetryDistinctId, getTelemetrySystem, getTelemetryTerminal, isTelemetryEnabled, sendUsageTelemetry } from '../src/telemetry.js'
-import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, reorderFavorite } from '../src/favorites.js'
+import { ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, reorderFavorite, pruneOrphanedFavorites } from '../src/favorites.js'
 import { checkForUpdateDetailed, checkForUpdate, runUpdate, promptUpdateNotification, fetchLastReleaseDate } from './updater.js'
 import { promptApiKey } from '../src/setup.js'
 import { syncShellEnv, ensureShellRcSource, promptShellEnvMigration, removeShellEnv } from '../src/shell-env.js'
@@ -372,6 +372,9 @@ export async function runApp(cliArgs, config) {
       hidden: false,  // 📖 Simple flag to hide/show models
     }))
   syncFavoriteFlags(results, config)
+  // 📖 Garbage-collect favorites that reference models no longer in sources.js,
+  // 📖 so the router dashboard only shows real, launchable models.
+  pruneOrphanedFavorites(results, config)
 
   // 📖 Load usage data from token-stats.json and attach usagePercent to each result row.
   // 📖 usagePercent is the quota percent remaining (0–100). undefined = no data available.
@@ -434,6 +437,7 @@ export async function runApp(cliArgs, config) {
     verdictFilterMode: 0,        // 📖 Index into VERDICT_CYCLE (0=All, then verdicts)
     healthFilterMode: 0,          // 📖 Index into HEALTH_CYCLE (0=All, then health states)
     hideUnconfiguredModels: config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
+    bestModeOnly: false,          // 📖 E cycles Normal → Configured only → Usable only (Health UP + Verdict ≤ Slow)
     favoritesPinnedAndSticky: config.settings?.favoritesPinnedAndSticky === true, // 📖 false by default: favorites follow normal sort/filter rules until Y enables pinned+sticky mode.
       scrollOffset: 0,              // 📖 First visible model index in viewport
       terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
@@ -579,7 +583,8 @@ export async function runApp(cliArgs, config) {
   const scheduleNextPing = () => {
     clearTimeout(state.pingIntervalObj)
     const elapsed = Date.now() - state.lastPingTime
-    const delay = Math.max(0, state.pingInterval - elapsed)
+    const interval = state.routerDashboardOpen ? 1000 : state.pingInterval
+    const delay = Math.max(0, interval - elapsed)
     state.pingIntervalObj = setTimeout(runPingCycle, delay)
   }
 
@@ -787,6 +792,16 @@ const unconfiguredHide = state.hideUnconfiguredModels && !noKeyNeeded && (!getAp
 if (unconfiguredHide) {
   r.hidden = true
   return
+}
+// 📖 Usable only: only show models with Health UP and Verdict Perfect/Normal/Slow
+if (state.bestModeOnly) {
+  const bmVerdict = getVerdict(r)
+  const bmVerdictOk = ['Perfect', 'Normal', 'Slow'].includes(bmVerdict)
+  const bmHealthOk = r.status === 'up'
+  if (!bmHealthOk || !bmVerdictOk) {
+    r.hidden = true
+    return
+  }
 }
       // 📖 Apply tier, origin, verdict, and health filters — model is hidden if it fails any
       const allowedTiers = (activeTier && TIER_LETTER_MAP[activeTier]) ? TIER_LETTER_MAP[activeTier] : [activeTier]
@@ -1087,8 +1102,9 @@ if (unconfiguredHide) {
           state.customTextFilter,
           state.lastReleaseDate,
           false,
-          state.verdictFilterMode,
-          state.healthFilterMode
+           state.verdictFilterMode,
+          state.healthFilterMode,
+          state.bestModeOnly
         )
       }
       tableContent = state.commandPaletteFrozenTable
@@ -1125,8 +1141,9 @@ if (unconfiguredHide) {
         state.customTextFilter,
         state.lastReleaseDate,
         false,
-        state.verdictFilterMode,
-        state.healthFilterMode
+         state.verdictFilterMode,
+        state.healthFilterMode,
+        state.bestModeOnly
       )
     }
 
@@ -1174,7 +1191,7 @@ if (unconfiguredHide) {
     pinFavorites: state.favoritesPinnedAndSticky,
   })
 
-      process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled, state.favoritesPinnedAndSticky, state.customTextFilter, state.lastReleaseDate, false, state.verdictFilterMode, state.healthFilterMode))
+      process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled, state.favoritesPinnedAndSticky, state.customTextFilter, state.lastReleaseDate, false, state.verdictFilterMode, state.healthFilterMode, state.bestModeOnly))
   if (process.stdout.isTTY) {
     process.stdout.flush && process.stdout.flush()
   }
@@ -1224,6 +1241,13 @@ if (unconfiguredHide) {
     }
 
     state.results.forEach(r => {
+      // 📖 When router dashboard is open, ONLY ping favorites every second
+      // 📖 to prevent massive rate limiting across the entire 90+ model catalog.
+      if (state.routerDashboardOpen) {
+        const favKey = `${r.providerKey}/${r.modelId}`
+        if (!state.config.favorites.includes(favKey)) return
+      }
+
       pingModel(r).catch(() => {
         // Individual ping failures don't crash the loop
       })

package/src/command-palette.js

@@ -201,13 +201,13 @@ 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', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+      { id: 'action-reset-view', label: 'Reset view', shortcut: 'N', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
     ],
   },
   // 📖 Pages - directly at root level, not in submenu
   { id: 'open-settings', label: 'Settings', shortcut: 'P', icon: '⚙️', type: 'page', description: 'API keys and preferences', keywords: ['settings', 'config', 'api key'] },
   { id: 'open-help', label: 'Help', shortcut: 'K', icon: '❓', type: 'page', description: 'Show all shortcuts', keywords: ['help', 'shortcuts', 'hotkeys'] },
-  { id: 'open-changelog', label: 'Changelog', shortcut: 'N', icon: '📋', type: 'page', description: 'Version history', keywords: ['changelog', 'release'] },
+  { id: 'open-changelog', label: 'Changelog', icon: '📋', type: 'page', description: 'Version history', keywords: ['changelog', 'release'] },
 
   { id: 'open-recommend', label: 'Smart recommend', shortcut: 'Q', icon: '🎯', type: 'page', description: 'Find best model for task', keywords: ['recommend', 'best model'] },
   { id: 'open-install-endpoints', label: 'Install endpoints', icon: '🔌', type: 'page', description: 'Install provider catalogs', keywords: ['install', 'endpoints', 'providers'] },

package/src/endpoint-installer.js

@@ -136,10 +136,12 @@ function getManagedProviderId(providerKey) {
 }
 
 function getProviderLabel(providerKey) {
+  if (providerKey === 'fcm_router') return 'Smart Router Daemon'
   return PROVIDER_METADATA[providerKey]?.label || sources[providerKey]?.name || providerKey
 }
 
 function getManagedProviderLabel(providerKey) {
+  if (providerKey === 'fcm_router') return 'FCM Smart Router'
   return `FCM ${getProviderLabel(providerKey)}`
 }
 
@@ -157,6 +159,10 @@ function getDefaultMaxTokens(contextWindow) {
 }
 
 function resolveProviderBaseUrl(providerKey) {
+  if (providerKey === 'fcm_router') {
+    return `http://localhost:${process.env.FCM_ROUTER_PORT || '19280'}/v1`
+  }
+
   const providerUrl = sources[providerKey]?.url
   if (!providerUrl) return null
 
@@ -173,6 +179,9 @@ function resolveProviderBaseUrl(providerKey) {
 }
 
 function resolveGooseBaseUrl(providerKey) {
+  if (providerKey === 'fcm_router') {
+    return `http://localhost:${process.env.FCM_ROUTER_PORT || '19280'}/v1`
+  }
   const providerUrl = sources[providerKey]?.url
   if (!providerUrl) return null
   if (providerKey === 'cloudflare') {
@@ -184,6 +193,7 @@ function resolveGooseBaseUrl(providerKey) {
 }
 
 function getDirectInstallSupport(providerKey) {
+  if (providerKey === 'fcm_router') return { supported: true, reason: null }
   if (!sources[providerKey]) {
     return { supported: false, reason: 'Unknown provider' }
   }
@@ -220,6 +230,12 @@ function buildCatalogModel(modelId, label, tier, sweScore, ctx) {
 }
 
 export function getProviderCatalogModels(providerKey) {
+  if (providerKey === 'fcm_router') {
+    return [
+      buildCatalogModel('fcm', 'FCM Smart Router', 'S+', 100, '200k')
+    ]
+  }
+
   const seen = new Set()
   return MODELS
     .filter((entry) => entry[5] === providerKey)
@@ -252,6 +268,7 @@ export function getInstallTargetModes() {
 }
 
 function requireConfiguredProviderKey(config, providerKey) {
+  if (providerKey === 'fcm_router') return 'fcm-local'
   const apiKey = getApiKey(config, providerKey)
   if (!apiKey) {
     throw new Error(`No configured API key found for ${getProviderLabel(providerKey)}`)

package/src/favorites.js

@@ -21,9 +21,10 @@
  *   → toFavoriteKey(providerKey, modelId)        — Build the canonical "providerKey/modelId" string
  *   → syncFavoriteFlags(results, config)         — Attach isFavorite/favoriteRank to result rows
  *   → toggleFavoriteModel(config, providerKey, modelId) — Add/remove favorite and persist
+ *   → pruneOrphanedFavorites(results, config)    — Remove favorites referencing models no longer in sources
  *
  * @exports
- *   ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel
+ *   ensureFavoritesConfig, toFavoriteKey, syncFavoriteFlags, toggleFavoriteModel, pruneOrphanedFavorites
  *
  * @see src/config.js  — load/save helpers keep favorite persistence atomic and merge-safe
  * @see bin/free-coding-models.js — calls syncFavoriteFlags on startup and toggleFavoriteModel on F key
@@ -125,3 +126,23 @@ export function reorderFavorite(config, providerKey, modelId, direction) {
   if (saveResult.success) replaceConfigContents(config, latestConfig)
   return true
 }
+
+/**
+ * 📖 Remove favorites that reference models no longer present in the active sources.
+ * 📖 Called once at startup so the router dashboard does not show stale/removed models.
+ * 📖 Persists immediately if any orphaned entries are found.
+ * @param {Array<Record<string, unknown>>} results — the full result rows from sources
+ * @param {Record<string, unknown>} config
+ * @returns {number} count of removed orphaned entries
+ */
+export function pruneOrphanedFavorites(results, config) {
+  ensureFavoritesConfig(config)
+  const validKeys = new Set(results.map(r => toFavoriteKey(r.providerKey, r.modelId)))
+  const before = config.favorites.length
+  config.favorites = config.favorites.filter(key => validKeys.has(key))
+  const removed = before - config.favorites.length
+  if (removed > 0) {
+    saveConfig(config, { replaceFavorites: true })
+  }
+  return removed
+}

package/src/key-handler.js

@@ -269,6 +269,7 @@ export function createKeyHandler(ctx) {
     installProviderEndpoints,
     syncFavoriteFlags,
     toggleFavoriteModel,
+    reorderFavorite,
     sortResultsWithPinnedFavorites,
     adjustScrollOffset,
     applyTierFilter,
@@ -1068,14 +1069,22 @@ export function createKeyHandler(ctx) {
   function resetViewSettings() {
     state.tierFilterMode = 0
     state.originFilterMode = 0
+    state.verdictFilterMode = 0
+    state.healthFilterMode = 0
     state.customTextFilter = null  // 📖 Clear ephemeral text filter on view reset
-    state.sortColumn = 'avg'
+    state.hideUnconfiguredModels = false
+    state.bestModeOnly = false
+    state.sortColumn = 'condition'  // 📖 Default sort: Health
     state.sortDirection = 'asc'
+    state.favoritesPinnedAndSticky = false
+    state.cursor = 0
+    state.scrollOffset = 0
     if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
     delete state.config.settings.tierFilter
     delete state.config.settings.originFilter
     delete state.config.settings.sortColumn
     delete state.config.settings.sortAsc
+    state.config.settings.hideUnconfiguredModels = false
     saveConfig(state.config)
     applyTierFilter()
     refreshVisibleSorted({ resetCursor: true })
@@ -1439,7 +1448,8 @@ export function createKeyHandler(ctx) {
     if (state.routerDashboardOpen) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
       const favorites = Array.isArray(state.config?.favorites) ? state.config.favorites : []
-      const maxCursor = Math.max(0, favorites.length - 1)
+      // 📖 maxCursor accounts for the favorites list + 2 buttons (Start/Stop Daemon and Install Endpoint)
+      const maxCursor = Math.max(0, favorites.length + 1)
       const pageStep = Math.max(1, (state.terminalRows || 1) - 4)
 
       if (key.name === 'escape') {
@@ -1447,10 +1457,10 @@ export function createKeyHandler(ctx) {
         return
       }
 
-      // 📖 Ctrl+↑: move the selected favorite UP in fallback priority
-      if (key.ctrl && key.name === 'up') {
-        if (favorites.length > 0) {
-          const cursorIdx = state.routerDashboardCursorIndex ?? 0
+      // 📖 Shift+↑: move the selected favorite UP in fallback priority
+      if (key.shift && key.name === 'up') {
+        const cursorIdx = state.routerDashboardCursorIndex ?? 0
+        if (favorites.length > 0 && cursorIdx < favorites.length) {
           const favKey = favorites[cursorIdx]
           if (favKey) {
             const slashIdx = favKey.indexOf('/')
@@ -1466,10 +1476,10 @@ export function createKeyHandler(ctx) {
         return
       }
 
-      // 📖 Ctrl+↓: move the selected favorite DOWN in fallback priority
-      if (key.ctrl && key.name === 'down') {
-        if (favorites.length > 0) {
-          const cursorIdx = state.routerDashboardCursorIndex ?? 0
+      // 📖 Shift+↓: move the selected favorite DOWN in fallback priority
+      if (key.shift && key.name === 'down') {
+        const cursorIdx = state.routerDashboardCursorIndex ?? 0
+        if (favorites.length > 0 && cursorIdx < favorites.length) {
           const favKey = favorites[cursorIdx]
           if (favKey) {
             const slashIdx = favKey.indexOf('/')
@@ -1477,7 +1487,7 @@ export function createKeyHandler(ctx) {
             const modelId = slashIdx >= 0 ? favKey.slice(slashIdx + 1) : favKey
             const moved = reorderFavorite(state.config, providerKey, modelId, 'down')
             if (moved) {
-              state.routerDashboardCursorIndex = Math.min(maxCursor, cursorIdx + 1)
+              state.routerDashboardCursorIndex = Math.min(favorites.length - 1, cursorIdx + 1)
               syncFavoriteFlags(state.results, state.config)
             }
           }
@@ -1485,17 +1495,56 @@ export function createKeyHandler(ctx) {
         return
       }
 
+      // 📖 S: Toggle daemon start/stop
+      if (key.name === 's') {
+        const isRunning = state.routerDashboardStatus === 'ready' || state.routerDashboardStatus === 'partial'
+        const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
+        const args = isRunning ? ['--daemon-stop'] : ['--daemon-bg']
+        
+        state.routerDashboardStatus = 'loading'
+        const child = spawn('node', [binPath, ...args], {
+          detached: true,
+          stdio: 'ignore',
+        })
+        child.unref()
+        return
+      }
+
+      // 📖 Enter/Return: Toggle daemon or open Install Endpoints if cursor is on a button
+      if (key.name === 'return' || key.name === 'enter') {
+        const btnCursor = favorites.length
+        const installBtnCursor = favorites.length + 1
+
+        if ((state.routerDashboardCursorIndex ?? 0) === btnCursor) {
+          const isRunning = state.routerDashboardStatus === 'ready' || state.routerDashboardStatus === 'partial'
+          const binPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin', 'free-coding-models.js')
+          const args = isRunning ? ['--daemon-stop'] : ['--daemon-bg']
+          
+          state.routerDashboardStatus = 'loading'
+          const child = spawn('node', [binPath, ...args], {
+            detached: true,
+            stdio: 'ignore',
+          })
+          child.unref()
+        } else if ((state.routerDashboardCursorIndex ?? 0) === installBtnCursor) {
+          state.routerDashboardOpen = false
+          state.installEndpointsOpen = true
+          state.installEndpointsPhase = 'tools' // skip the provider selection phase
+          state.installEndpointsCursor = 0
+          state.installEndpointsProviderKey = 'fcm_router' // special provider key handled by endpoint-installer
+          state.installEndpointsScrollOffset = 0
+          state.installEndpointsErrorMsg = null
+        }
+        return
+      }
+
       // 📖 ↑/↓: navigate the favorites list cursor
       if (key.name === 'up' || key.name === 'k') {
-        if (favorites.length > 0) {
-          state.routerDashboardCursorIndex = Math.max(0, (state.routerDashboardCursorIndex ?? 0) - 1)
-        }
+        state.routerDashboardCursorIndex = Math.max(0, (state.routerDashboardCursorIndex ?? 0) - 1)
         return
       }
       if (key.name === 'down' || key.name === 'j') {
-        if (favorites.length > 0) {
-          state.routerDashboardCursorIndex = Math.min(maxCursor, (state.routerDashboardCursorIndex ?? 0) + 1)
-        }
+        state.routerDashboardCursorIndex = Math.min(maxCursor, (state.routerDashboardCursorIndex ?? 0) + 1)
         return
       }
       if (key.name === 'pageup') {
@@ -1527,7 +1576,7 @@ export function createKeyHandler(ctx) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
 
       const providerChoices = getConfiguredInstallableProviders(state.config)
-      const toolChoices = getInstallTargetModes()
+      const toolChoices = getInstallTargetModes().filter(t => !(state.installEndpointsProviderKey === 'fcm_router' && t === 'fcm_router'))
       const modelChoices = state.installEndpointsProviderKey
         ? getProviderCatalogModels(state.installEndpointsProviderKey)
         : []
@@ -1569,10 +1618,19 @@ export function createKeyHandler(ctx) {
       if (key.name === 'escape') {
         state.installEndpointsErrorMsg = null
         if (state.installEndpointsPhase === 'providers' || state.installEndpointsPhase === 'result') {
+          const wasFcmRouter = state.installEndpointsProviderKey === 'fcm_router'
           resetInstallEndpointsOverlay()
+          if (wasFcmRouter) {
+            state.routerDashboardOpen = true
+          }
           return
         }
         if (state.installEndpointsPhase === 'tools') {
+          if (state.installEndpointsProviderKey === 'fcm_router') {
+             resetInstallEndpointsOverlay()
+             state.routerDashboardOpen = true
+             return
+          }
           state.installEndpointsPhase = 'providers'
           state.installEndpointsCursor = 0
           state.installEndpointsScrollOffset = 0
@@ -1617,10 +1675,25 @@ export function createKeyHandler(ctx) {
           if (!selectedToolMode) return
           state.installEndpointsToolMode = selectedToolMode
           state.installEndpointsConnectionMode = 'direct'
-          state.installEndpointsPhase = 'scope'
-          state.installEndpointsCursor = 0
-          state.installEndpointsScrollOffset = 0
-          state.installEndpointsErrorMsg = null
+          
+          if (state.installEndpointsProviderKey === 'fcm_router') {
+            state.installEndpointsScope = 'all'
+            try {
+              await runInstallEndpointsFlow()
+            } catch (error) {
+              state.installEndpointsResult = {
+                type: 'error',
+                title: 'Install failed',
+                lines: [error instanceof Error ? error.message : String(error)],
+              }
+              state.installEndpointsPhase = 'result'
+            }
+          } else {
+            state.installEndpointsPhase = 'scope'
+            state.installEndpointsCursor = 0
+            state.installEndpointsScrollOffset = 0
+            state.installEndpointsErrorMsg = null
+          }
         }
         return
       }
@@ -1695,7 +1768,11 @@ export function createKeyHandler(ctx) {
 
       if (state.installEndpointsPhase === 'result') {
         if (key.name === 'return' || key.name === 'y') {
+          const wasFcmRouter = state.installEndpointsProviderKey === 'fcm_router'
           resetInstallEndpointsOverlay()
+          if (wasFcmRouter) {
+            state.routerDashboardOpen = true
+          }
         }
         return
       }
@@ -2593,10 +2670,26 @@ export function createKeyHandler(ctx) {
 
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
-    // 📖 Shift+R intentionally stays unadvertised in the main UI, but remains
-    // 📖 available as a tester entry point for the Router Dashboard.
+    // 📖 Shift+R: Open Router Dashboard AND launch OpenCode with the selected model.
+    // 📖 If the dashboard is already open, just bring it to front.
     if (key.name === 'r' && key.shift && !key.ctrl && !key.meta) {
+      if (state.routerDashboardOpen) {
+        state.routerDashboardScrollOffset = 0
+        return
+      }
       openRouterDashboardOverlay(state)
+      // 📖 If a model is selected in the main table, launch OpenCode with it after opening dashboard
+      const selected = state.visibleSorted?.[state.cursor]
+      if (selected && selected.providerKey && selected.modelId) {
+        const launchModel = {
+          modelId: selected.modelId,
+          label: selected.label,
+          tier: selected.tier,
+          providerKey: selected.providerKey,
+        }
+        // 📖 Launch asynchronously — don't await, dashboard renders while OpenCode starts
+        void startOpenCode(launchModel, state.config)
+      }
       return
     }
 
@@ -2647,10 +2740,23 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 E toggles "Show only configured & working models": hides models whose provider has no configured API key, or whose health status is noauth/auth_error (but keeps timeout and 429).
-    // 📖 The preference is saved globally.
+    // 📖 E cycles: Normal → Configured only → Usable only → Normal
+    // 📖 Configured only: hides models with no key or noauth/auth_error health
+    // 📖 Usable only: only shows models with Health UP and Verdict ≤ Slow (Perfect/Normal/Slow)
     if (key.name === 'e') {
-      state.hideUnconfiguredModels = !state.hideUnconfiguredModels
+      if (!state.hideUnconfiguredModels && !state.bestModeOnly) {
+        // Normal → Configured only
+        state.hideUnconfiguredModels = true
+        state.bestModeOnly = false
+      } else if (state.hideUnconfiguredModels && !state.bestModeOnly) {
+        // Configured only → Usable only
+        state.hideUnconfiguredModels = false
+        state.bestModeOnly = true
+      } else {
+        // Usable only → Normal
+        state.hideUnconfiguredModels = false
+        state.bestModeOnly = false
+      }
       if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
       state.config.settings.hideUnconfiguredModels = state.hideUnconfiguredModels
       saveConfig(state.config)
@@ -2704,15 +2810,9 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Changelog overlay key: N = toggle changelog overlay
+    // 📖 Reset view key: N = reset all filters and sort back to default (Health)
     if (key.name === 'n') {
-      state.changelogOpen = !state.changelogOpen
-      if (state.changelogOpen) {
-        state.changelogScrollOffset = 0
-        state.changelogPhase = 'index'
-        state.changelogCursor = 0
-        state.changelogSelectedVersion = null
-      }
+      resetViewSettings()
       return
     }
 

package/src/overlays.js

@@ -343,7 +343,7 @@ export function createOverlayRenderers(state, deps) {
     const lines = []
     const cursorLineByRow = {}
     const providerChoices = getConfiguredInstallableProviders(state.config)
-    const toolChoices = getInstallTargetModes()
+    const toolChoices = getInstallTargetModes().filter(t => !(state.installEndpointsProviderKey === 'fcm_router' && t === 'fcm_router'))
     const totalSteps = 4
     const scopeChoices = [
       {
@@ -357,9 +357,11 @@ export function createOverlayRenderers(state, deps) {
         hint: 'Choose a smaller curated subset for a cleaner model picker.',
       },
     ]
-    const selectedProviderLabel = state.installEndpointsProviderKey
-      ? (sources[state.installEndpointsProviderKey]?.name || state.installEndpointsProviderKey)
-      : '—'
+    const selectedProviderLabel = state.installEndpointsProviderKey === 'fcm_router' 
+      ? 'Smart Router Daemon' 
+      : state.installEndpointsProviderKey
+        ? (sources[state.installEndpointsProviderKey]?.name || state.installEndpointsProviderKey)
+        : '—'
 
     // 📖 Resolve tool label from metadata instead of hard-coded switch
     const selectedToolLabel = state.installEndpointsToolMode
@@ -926,7 +928,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${heading('Controls')}`)
     lines.push(`  ${key('W')}  Toggle ping mode  ${hint('(speed 2s → normal 10s → slow 30s → forced 4s)')}`)
     lines.push(`  ${key('Ctrl+P')}  Open ⚡️ command palette  ${hint('(search and run actions quickly)')}`)
-    lines.push(`  ${key('E')}  Toggle configured models only  ${hint('(enabled by default)')}`)
+    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 → 🦘 Rovo → ♊ Gemini)')}`)
     lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(1️⃣2️⃣3️⃣ = router fallback order, capped at 🔟)')}`)
     lines.push(`  ${key('⇧↑/⇧↓')}  Reorder selected favorite up/down  ${hint('(changes router priority)')}`)
@@ -938,7 +940,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('P')}  Open settings  ${hint('(manage API keys, provider toggles, updates, legacy cleanup)')}`)
       // 📖 Profile system removed - API keys now persist permanently across all sessions
     lines.push(`  ${key('Ctrl+P')}  Reset view settings  ${hint('(search "Reset view" in the command palette)')}`)
-    lines.push(`  ${key('N')}  Changelog  ${hint('(📋 browse all versions, Enter to view details)')}`)
+    lines.push(`  ${key('N')}  Reset view  ${hint('(🔄 reset all filters & sort back to default)')}`)
     lines.push(`  ${key('I')} / ${key('Esc')}  Show/hide this help`)
     lines.push(`  ${key('Ctrl+C')}  Exit`)
     lines.push('')