free-coding-models 0.1.85 → 0.1.86

package/README.md

@@ -2,7 +2,7 @@
   <img src="https://img.shields.io/npm/v/free-coding-models?color=76b900&label=npm&logo=npm" alt="npm version">
   <img src="https://img.shields.io/node/v/free-coding-models?color=76b900&logo=node.js" alt="node version">
   <img src="https://img.shields.io/npm/l/free-coding-models?color=76b900" alt="license">
-  <img src="https://img.shields.io/badge/models-158-76b900?logo=nvidia" alt="models count">
+  <img src="https://img.shields.io/badge/models-159-76b900?logo=nvidia" alt="models count">
   <img src="https://img.shields.io/badge/providers-20-blue" alt="providers count">
 </p>
 
@@ -90,7 +90,9 @@
  - **📶 Status indicators** — UP ✅ · No Key 🔑 · Timeout ⏳ · Overloaded 🔥 · Not Found 🚫
  - **🔍 Keyless latency** — Models are pinged even without an API key
  - **🏷 Tier filtering** — Filter models by tier letter (S, A, B, C)
- - **⭐ Persistent favorites** — Press `F` on a selected row to pin/unpin it
+- **⭐ Persistent favorites** — Press `F` on a selected row to pin/unpin it
+- **🙈 Configured-only by default** — Press `E` to toggle showing only providers with configured API keys; the choice persists across sessions and profiles
+- **🪟 Width guardrail** — If your terminal is too narrow, the TUI shows a centered warning instead of rendering a broken table
 
 ---
 
@@ -235,7 +237,7 @@ Use `↑↓` arrows to select, `Enter` to confirm. Then the TUI launches with yo
   You can add or change keys anytime with the P key in the TUI.
 ```
 
-You don't need all seventeen — skip any provider by pressing Enter. At least one key is required.
+You don't need all twenty providers — skip any provider by pressing Enter. At least one key is required.
 
 ### Adding or changing keys later
 
@@ -269,6 +271,7 @@ Press **`P`** to open the Settings screen at any time:
 
  Manual update is in the same Settings screen (`P`) under **Maintenance** (Enter to check, Enter again to install when an update is available).
  Favorites are also persisted in the same config file and survive restarts.
+ The main table now starts in `Configured Only` mode, so if nothing is set up yet you can press `P` and add your first API key immediately.
 
 ### Environment variable overrides
 
@@ -376,7 +379,7 @@ TOGETHER_API_KEY=together_xxx free-coding-models
 
 ## 🤖 Coding Models
 
-**158 coding models** across 20 providers and 8 tiers, ranked by [SWE-bench Verified](https://www.swebench.com) — the industry-standard benchmark measuring real GitHub issue resolution. Scores are self-reported by providers unless noted.
+**159 coding models** across 20 providers and 8 tiers, ranked by [SWE-bench Verified](https://www.swebench.com) — the industry-standard benchmark measuring real GitHub issue resolution. Scores are self-reported by providers unless noted.
 
 ### Alibaba Cloud (DashScope) (8 models)
 
@@ -733,7 +736,7 @@ This script:
 └──────────────────────────────────────────────────────────────────┘
 ```
 
-**Result:** Continuous monitoring interface that stays open until you select a model or press Ctrl+C. Rolling averages give you accurate long-term latency data, the stability score reveals which models are truly consistent vs. deceptively spikey, and you can configure your tool of choice with one keystroke.
+**Result:** Continuous monitoring interface that stays open until you select a model or press Ctrl+C. Rolling averages give you accurate long-term latency data, the stability score reveals which models are truly consistent vs. deceptively spikey, and you can configure your tool of choice with one keystroke. If the terminal is too narrow, the app shows a centered warning instead of a truncated table.
 
 ---
 
@@ -795,6 +798,9 @@ This script:
     "perplexity": { "enabled": true },
     "zai":      { "enabled": true }
    },
+   "settings": {
+     "hideUnconfiguredModels": true
+   },
    "favorites": [
      "nvidia/deepseek-ai/deepseek-v3.2"
    ]
@@ -830,6 +836,7 @@ This script:
 - **F** — Toggle favorite on selected model (⭐ in Model column, pinned at top)
 - **T** — Cycle tier filter (All → S+ → S → A+ → A → A- → B+ → B → C → All)
 - **D** — Cycle provider filter (All → NIM → Groq → ...)
+- **E** — Toggle configured-only mode (on by default, persisted across sessions and profiles)
 - **Z** — Cycle mode (OpenCode CLI → OpenCode Desktop → OpenClaw)
 - **X** — **Toggle Token Logs** (view recent request/token usage logs)
 - **P** — Open Settings (manage API keys, toggles, updates, profiles)

package/bin/free-coding-models.js

@@ -177,9 +177,10 @@ async function main() {
   ensureFavoritesConfig(config)
 
   // 📖 If --profile <name> was passed, load that profile into the live config
+  let startupProfileSettings = null
   if (cliArgs.profileName) {
-    const profileSettings = loadProfile(config, cliArgs.profileName)
-    if (!profileSettings) {
+    startupProfileSettings = loadProfile(config, cliArgs.profileName)
+    if (!startupProfileSettings) {
       console.error(chalk.red(`  Unknown profile "${cliArgs.profileName}". Available: ${listProfiles(config).join(', ') || '(none)'}`))
       process.exit(1)
     }
@@ -336,8 +337,8 @@ async function main() {
     frame: 0,
     cursor: 0,
     selectedModel: null,
-    sortColumn: 'avg',
-    sortDirection: 'asc',
+    sortColumn: startupProfileSettings?.sortColumn || 'avg',
+    sortDirection: startupProfileSettings?.sortAsc === false ? 'desc' : 'asc',
     pingInterval: PING_MODE_INTERVALS.speed, // 📖 Effective live interval derived from the active ping mode.
     pingMode: 'speed',            // 📖 Current ping mode: speed | normal | slow | forced.
     pingModeSource: 'startup',    // 📖 Why this mode is active: startup | manual | auto | idle | activity.
@@ -348,8 +349,10 @@ async function main() {
     mode,                         // 📖 'opencode' or 'openclaw' — controls Enter action
     tierFilterMode: 0,            // 📖 Index into TIER_CYCLE (0=All, 1=S+, 2=S, ...)
     originFilterMode: 0,          // 📖 Index into ORIGIN_CYCLE (0=All, then providers)
+    hideUnconfiguredModels: startupProfileSettings?.hideUnconfiguredModels === true || config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
     scrollOffset: 0,              // 📖 First visible model index in viewport
     terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
+    terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
     // 📖 Settings screen state (P key opens it)
     settingsOpen: false,          // 📖 Whether settings overlay is active
     settingsCursor: 0,            // 📖 Which provider row is selected in settings
@@ -408,6 +411,7 @@ async function main() {
   // 📖 Re-clamp viewport on terminal resize
   process.stdout.on('resize', () => {
     state.terminalRows = process.stdout.rows || 24
+    state.terminalCols = process.stdout.columns || 80
     adjustScrollOffset(state)
   })
 
@@ -479,13 +483,18 @@ async function main() {
 
   // 📖 originFilterMode: index into ORIGIN_CYCLE, 0=All, then each provider key in order
   const ORIGIN_CYCLE = [null, ...Object.keys(sources)]
-  state.tierFilterMode = 0
+  state.tierFilterMode = startupProfileSettings?.tierFilter ? Math.max(0, TIER_CYCLE.indexOf(startupProfileSettings.tierFilter)) : 0
   state.originFilterMode = 0
 
   function applyTierFilter() {
     const activeTier = TIER_CYCLE[state.tierFilterMode]
     const activeOrigin = ORIGIN_CYCLE[state.originFilterMode]
     state.results.forEach(r => {
+      const unconfiguredHide = state.hideUnconfiguredModels && !getApiKey(state.config, r.providerKey)
+      if (unconfiguredHide) {
+        r.hidden = true
+        return
+      }
       // 📖 Favorites stay visible regardless of tier/origin filters.
       if (r.isFavorite) {
         r.hidden = false
@@ -643,7 +652,7 @@ async function main() {
                 ? overlays.renderHelp()
               : state.logVisible
                 ? overlays.renderLog()
-                : 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.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource)
+                : 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, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels)
     process.stdout.write(ALT_HOME + content)
   }, Math.round(1000 / FPS))
 
@@ -651,7 +660,7 @@ async function main() {
   const initialVisible = state.results.filter(r => !r.hidden)
   state.visibleSorted = sortResultsWithPinnedFavorites(initialVisible, state.sortColumn, state.sortDirection)
 
-  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.originFilterMode, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource))
+  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, state.activeProfile, state.profileSaveMode, state.profileSaveBuffer, state.proxyStartupStatus, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels))
 
   // 📖 If --recommend was passed, auto-open the Smart Recommend overlay on start
   if (cliArgs.recommendMode) {

package/package.json

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

@@ -12,6 +12,8 @@
  *   - ctx: Context window size in tokens (e.g., "128k", "32k")
  *
  *   Add new sources here to support additional providers beyond NIM.
+ *   Public provider catalogs drift often, so these IDs are periodically
+ *   refreshed against official docs and live model endpoints when available.
  *
  *   🎯 Tier scale (based on SWE-bench Verified):
  *   - S+: 70%+ (elite frontier coders)
@@ -114,9 +116,9 @@ export const cerebras = [
   ['llama-4-scout-17b-16e-instruct',       'Llama 4 Scout',      'A',  '44.0%', '10M'],
   ['qwen-3-32b',                           'Qwen3 32B',          'A+', '50.0%', '128k'],
   ['gpt-oss-120b',                         'GPT OSS 120B',       'S',  '60.0%', '128k'],
-  ['qwen-3-235b-a22b',                     'Qwen3 235B',         'S+', '70.0%', '128k'],
+  ['qwen-3-235b-a22b-instruct-2507',       'Qwen3 235B',         'S+', '70.0%', '128k'],
   ['llama3.1-8b',                          'Llama 3.1 8B',       'B',  '28.8%', '128k'],
-  ['glm-4.6',                              'GLM 4.6',            'A-', '38.0%', '128k'],
+  ['zai-glm-4.7',                          'GLM 4.7',            'S+', '73.8%', '200k'],
 ]
 
 // 📖 SambaNova source - https://cloud.sambanova.ai
@@ -124,14 +126,15 @@ export const cerebras = [
 // 📖 OpenAI-compatible API, supports all major coding models including DeepSeek V3/R1, Qwen3, Llama 4
 export const sambanova = [
   // ── S+ tier ──
-  ['Qwen3-235B-A22B-Instruct-2507',        'Qwen3 235B',         'S+', '70.0%', '128k'],
+  ['MiniMax-M2.5',                         'MiniMax M2.5',       'S+', '74.0%', '160k'],
   // ── S tier ──
   ['DeepSeek-R1-0528',                     'DeepSeek R1 0528',   'S',  '61.0%', '128k'],
   ['DeepSeek-V3.1',                        'DeepSeek V3.1',      'S',  '62.0%', '128k'],
   ['DeepSeek-V3-0324',                     'DeepSeek V3 0324',   'S',  '62.0%', '128k'],
+  ['DeepSeek-V3.2',                        'DeepSeek V3.2',      'S+', '73.1%', '8k'],
   ['Llama-4-Maverick-17B-128E-Instruct',   'Llama 4 Maverick',   'S',  '62.0%', '1M'],
   ['gpt-oss-120b',                         'GPT OSS 120B',       'S',  '60.0%', '128k'],
-  ['deepseek-ai/DeepSeek-V3.1-Terminus',   'DeepSeek V3.1 Term', 'S',  '68.4%', '128k'],
+  ['DeepSeek-V3.1-Terminus',               'DeepSeek V3.1 Term', 'S',  '68.4%', '128k'],
   // ── A+ tier ──
   ['Qwen3-32B',                            'Qwen3 32B',          'A+', '50.0%', '128k'],
   // ── A tier ──
@@ -140,24 +143,23 @@ export const sambanova = [
   ['Meta-Llama-3.3-70B-Instruct',          'Llama 3.3 70B',      'A-', '39.5%', '128k'],
   // ── B tier ──
   ['Meta-Llama-3.1-8B-Instruct',           'Llama 3.1 8B',       'B',  '28.8%', '128k'],
-  // ── A tier — requested Llama3-Groq coding tuned family ──
-  ['Llama-3-Groq-70B-Tool-Use',            'Llama3-Groq 70B',    'A',  '43.0%', '128k'],
 ]
 
 // 📖 OpenRouter source - https://openrouter.ai
 // 📖 Free :free models with shared quota — 50 free req/day
 // 📖 API keys at https://openrouter.ai/keys
 export const openrouter = [
-  ['qwen/qwen3-coder:480b-free',               'Qwen3 Coder 480B',   'S+', '70.6%', '256k'],
-  ['mistralai/devstral-2-free',                'Devstral 2',         'S+', '72.2%', '256k'],
-  ['mimo-v2-flash-free',                       'Mimo V2 Flash',      'A',  '45.0%', '128k'],
+  ['qwen/qwen3-coder:free',                    'Qwen3 Coder 480B',   'S+', '70.6%', '262k'],
+  ['z-ai/glm-4.5-air:free',                    'GLM 4.5 Air',        'S+', '72.0%', '128k'],
+  ['google/gemma-3-27b-it:free',               'Gemma 3 27B',        'B',  '22.0%', '128k'],
   ['stepfun/step-3.5-flash:free',              'Step 3.5 Flash',     'S+', '74.4%', '256k'],
-  ['deepseek/deepseek-r1-0528:free',           'DeepSeek R1 0528',   'S',  '61.0%', '128k'],
   ['qwen/qwen3-next-80b-a3b-instruct:free',    'Qwen3 80B Instruct', 'S',  '65.0%', '128k'],
   ['openai/gpt-oss-120b:free',                 'GPT OSS 120B',       'S',  '60.0%', '128k'],
   ['openai/gpt-oss-20b:free',                  'GPT OSS 20B',        'A',  '42.0%', '128k'],
   ['nvidia/nemotron-3-nano-30b-a3b:free',      'Nemotron Nano 30B',  'A',  '43.0%', '128k'],
   ['meta-llama/llama-3.3-70b-instruct:free',   'Llama 3.3 70B',      'A-', '39.5%', '128k'],
+  ['mistralai/mistral-small-3.1-24b-instruct:free', 'Mistral Small 3.1', 'B+', '30.0%', '128k'],
+  ['google/gemma-3-12b-it:free',               'Gemma 3 12B',        'C',  '15.0%', '128k'],
 ]
 
 // 📖 Hugging Face Inference source - https://huggingface.co

package/src/config.js

@@ -71,7 +71,7 @@
  *   - apiKeys: API keys per provider (can differ between work/personal setups)
  *   - providers: enabled/disabled state per provider
  *   - favorites: list of pinned favorite models
- *   - settings: extra TUI preferences (tierFilter, sortColumn, sortAsc, pingInterval)
+ *   - settings: extra TUI preferences (tierFilter, sortColumn, sortAsc, pingInterval, hideUnconfiguredModels)
  *
  * 📖 When a profile is loaded via --profile <name> or Shift+P, the main config's
  *    apiKeys/providers/favorites are replaced with the profile's values. The profile
@@ -164,6 +164,8 @@ export function loadConfig() {
       // 📖 Ensure the shape is always complete — fill missing sections with defaults
       if (!parsed.apiKeys) parsed.apiKeys = {}
       if (!parsed.providers) parsed.providers = {}
+      if (!parsed.settings || typeof parsed.settings !== 'object') parsed.settings = {}
+      if (typeof parsed.settings.hideUnconfiguredModels !== 'boolean') parsed.settings.hideUnconfiguredModels = true
       // 📖 Favorites: list of "providerKey/modelId" pinned rows.
       if (!Array.isArray(parsed.favorites)) parsed.favorites = []
       parsed.favorites = parsed.favorites.filter((fav) => typeof fav === 'string' && fav.trim().length > 0)
@@ -173,6 +175,10 @@ export function loadConfig() {
       if (typeof parsed.telemetry.anonymousId !== 'string' || !parsed.telemetry.anonymousId.trim()) parsed.telemetry.anonymousId = null
       // 📖 Ensure profiles section exists (added in profile system)
       if (!parsed.profiles || typeof parsed.profiles !== 'object') parsed.profiles = {}
+      for (const profile of Object.values(parsed.profiles)) {
+        if (!profile || typeof profile !== 'object') continue
+        profile.settings = profile.settings ? { ..._emptyProfileSettings(), ...profile.settings } : _emptyProfileSettings()
+      }
       if (parsed.activeProfile && typeof parsed.activeProfile !== 'string') parsed.activeProfile = null
       return parsed
     } catch {
@@ -385,7 +391,7 @@ export function isProviderEnabled(config, providerKey) {
  * 📖 These settings are saved/restored when switching profiles so each profile
  *    can have different sort, filter, and ping preferences.
  *
- * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number }}
+ * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number, hideUnconfiguredModels: boolean }}
  */
 export function _emptyProfileSettings() {
   return {
@@ -393,6 +399,7 @@ export function _emptyProfileSettings() {
     sortColumn: 'avg',    // 📖 default sort column
     sortAsc: true,        // 📖 true = ascending (fastest first for latency)
     pingInterval: 10000,  // 📖 default ms between pings in the steady "normal" mode
+    hideUnconfiguredModels: true, // 📖 true = default to providers that are actually configured
   }
 }
 
@@ -505,6 +512,10 @@ function _emptyConfig() {
   return {
     apiKeys: {},
     providers: {},
+    // 📖 Global TUI preferences that should persist even without a named profile.
+    settings: {
+      hideUnconfiguredModels: true,
+    },
     // 📖 Pinned favorites rendered at top of the table ("providerKey/modelId").
     favorites: [],
     // 📖 Telemetry consent is explicit. null = not decided yet.

package/src/key-handler.js

@@ -1,6 +1,6 @@
 /**
  * @file key-handler.js
- * @description Factory for the main TUI keypress handler.
+ * @description Factory for the main TUI keypress handler and provider key-test model selection.
  *
  * @details
  *   This module encapsulates the full onKeyPress switch used by the TUI,
@@ -8,11 +8,93 @@
  *   OpenCode/OpenClaw launch actions. It also keeps the live key bindings
  *   aligned with the highlighted letters shown in the table headers.
  *
+ *   It also owns the "test key" model selection used by the Settings overlay.
+ *   Some providers expose models in `/v1/models` that are not actually callable
+ *   on the chat-completions endpoint. To avoid false negatives when a user
+ *   presses `T` in Settings, the helpers below discover candidate model IDs,
+ *   merge them with repo defaults, then probe several until one is accepted.
+ *
  *   → Functions:
+ *   - `buildProviderModelsUrl` — derive the matching `/models` endpoint when available
+ *   - `parseProviderModelIds` — extract model ids from an OpenAI-style `/models` payload
+ *   - `listProviderTestModels` — build an ordered candidate list for provider key verification
+ *   - `classifyProviderTestOutcome` — convert attempted HTTP codes into a settings badge state
  *   - `createKeyHandler` — returns the async keypress handler
  *
- * @exports { createKeyHandler }
+ * @exports { buildProviderModelsUrl, parseProviderModelIds, listProviderTestModels, classifyProviderTestOutcome, createKeyHandler }
+ */
+
+// 📖 Some providers need an explicit probe model because the first catalog entry
+// 📖 is not guaranteed to be accepted by their chat endpoint.
+const PROVIDER_TEST_MODEL_OVERRIDES = {
+  sambanova: ['DeepSeek-V3-0324'],
+  nvidia: ['deepseek-ai/deepseek-v3.1-terminus', 'openai/gpt-oss-120b'],
+}
+
+/**
+ * 📖 buildProviderModelsUrl derives the matching `/models` endpoint for providers
+ * 📖 that expose an OpenAI-compatible model list next to `/chat/completions`.
+ * @param {string} url
+ * @returns {string|null}
  */
+export function buildProviderModelsUrl(url) {
+  if (typeof url !== 'string' || !url.includes('/chat/completions')) return null
+  return url.replace(/\/chat\/completions$/, '/models')
+}
+
+/**
+ * 📖 parseProviderModelIds extracts ids from a standard OpenAI-style `/models` response.
+ * 📖 Invalid payloads return an empty list so the key-test flow can safely fall back.
+ * @param {unknown} data
+ * @returns {string[]}
+ */
+export function parseProviderModelIds(data) {
+  if (!data || typeof data !== 'object' || !Array.isArray(data.data)) return []
+  return data.data
+    .map(entry => (entry && typeof entry.id === 'string') ? entry.id.trim() : '')
+    .filter(Boolean)
+}
+
+/**
+ * 📖 listProviderTestModels builds the ordered probe list used by the Settings `T` key.
+ * 📖 Order matters:
+ * 📖 1. provider-specific known-good overrides
+ * 📖 2. discovered `/models` ids that also exist in this repo
+ * 📖 3. all discovered `/models` ids
+ * 📖 4. repo static model ids as final fallback
+ * @param {string} providerKey
+ * @param {{ models?: Array<[string, string, string, string, string]> } | undefined} src
+ * @param {string[]} [discoveredModelIds=[]]
+ * @returns {string[]}
+ */
+export function listProviderTestModels(providerKey, src, discoveredModelIds = []) {
+  const staticModelIds = Array.isArray(src?.models) ? src.models.map(model => model[0]).filter(Boolean) : []
+  const staticModelSet = new Set(staticModelIds)
+  const preferredDiscoveredIds = discoveredModelIds.filter(modelId => staticModelSet.has(modelId))
+  const orderedCandidates = [
+    ...(PROVIDER_TEST_MODEL_OVERRIDES[providerKey] ?? []),
+    ...preferredDiscoveredIds,
+    ...discoveredModelIds,
+    ...staticModelIds,
+  ]
+  return [...new Set(orderedCandidates)]
+}
+
+/**
+ * 📖 classifyProviderTestOutcome maps attempted probe codes to a user-facing test result.
+ * 📖 This keeps Settings more honest than a binary success/fail badge:
+ * 📖 - `rate_limited` means the key is valid but the provider is currently throttling
+ * 📖 - `no_callable_model` means the provider responded, but none of the attempted models were callable
+ * @param {string[]} codes
+ * @returns {'ok'|'fail'|'rate_limited'|'no_callable_model'}
+ */
+export function classifyProviderTestOutcome(codes) {
+  if (codes.includes('200')) return 'ok'
+  if (codes.includes('401') || codes.includes('403')) return 'fail'
+  if (codes.length > 0 && codes.every(code => code === '429')) return 'rate_limited'
+  if (codes.length > 0 && codes.every(code => code === '404' || code === '410')) return 'no_callable_model'
+  return 'fail'
+}
 
 export function createKeyHandler(ctx) {
   const {
@@ -83,13 +165,45 @@ export function createKeyHandler(ctx) {
     const testKey = getApiKey(state.config, providerKey)
     if (!testKey) { state.settingsTestResults[providerKey] = 'fail'; return }
 
-    // 📖 Use the first model in the provider's list for the test ping
-    const testModel = src.models[0]?.[0]
-    if (!testModel) { state.settingsTestResults[providerKey] = 'fail'; return }
-
     state.settingsTestResults[providerKey] = 'pending'
-    const { code } = await ping(testKey, testModel, providerKey, src.url)
-    state.settingsTestResults[providerKey] = code === '200' ? 'ok' : 'fail'
+    const discoveredModelIds = []
+    const modelsUrl = buildProviderModelsUrl(src.url)
+
+    if (modelsUrl) {
+      try {
+        const headers = { Authorization: `Bearer ${testKey}` }
+        if (providerKey === 'openrouter') {
+          headers['HTTP-Referer'] = 'https://github.com/vava-nessa/free-coding-models'
+          headers['X-Title'] = 'free-coding-models'
+        }
+        const modelsResp = await fetch(modelsUrl, { headers })
+        if (modelsResp.ok) {
+          const data = await modelsResp.json()
+          discoveredModelIds.push(...parseProviderModelIds(data))
+        }
+      } catch {
+        // 📖 Discovery failure is non-fatal; we still have repo-defined fallbacks.
+      }
+    }
+
+    const candidateModels = listProviderTestModels(providerKey, src, discoveredModelIds)
+    if (candidateModels.length === 0) { state.settingsTestResults[providerKey] = 'fail'; return }
+    const attemptedCodes = []
+
+    for (const testModel of candidateModels.slice(0, 8)) {
+      const { code } = await ping(testKey, testModel, providerKey, src.url)
+      attemptedCodes.push(code)
+      if (code === '200') {
+        state.settingsTestResults[providerKey] = 'ok'
+        return
+      }
+      if (code === '401' || code === '403') {
+        state.settingsTestResults[providerKey] = 'fail'
+        return
+      }
+    }
+
+    state.settingsTestResults[providerKey] = classifyProviderTestOutcome(attemptedCodes)
   }
 
   // 📖 Manual update checker from settings; keeps status visible in maintenance row.
@@ -146,6 +260,7 @@ export function createKeyHandler(ctx) {
             sortColumn: state.sortColumn,
             sortAsc: state.sortDirection === 'asc',
             pingInterval: state.pingInterval,
+            hideUnconfiguredModels: state.hideUnconfiguredModels,
           })
           setActiveProfile(state.config, name)
           state.activeProfile = name
@@ -759,6 +874,7 @@ export function createKeyHandler(ctx) {
           sortColumn: state.sortColumn,
           sortAsc: state.sortDirection === 'asc',
           pingInterval: state.pingInterval,
+          hideUnconfiguredModels: state.hideUnconfiguredModels,
         })
         setActiveProfile(state.config, 'default')
         state.activeProfile = 'default'
@@ -786,6 +902,7 @@ export function createKeyHandler(ctx) {
             } else {
               state.tierFilterMode = 0
             }
+            state.hideUnconfiguredModels = settings.hideUnconfiguredModels === true
             state.activeProfile = nextProfile
             // 📖 Rebuild favorites from profile data
             syncFavoriteFlags(state.results, state.config)
@@ -886,6 +1003,26 @@ export function createKeyHandler(ctx) {
       setPingMode(PING_MODE_CYCLE[nextIdx], 'manual')
     }
 
+    // 📖 E toggles hiding models whose provider has no configured API key.
+    // 📖 The preference is saved globally and mirrored into the active profile.
+    if (key.name === 'e') {
+      state.hideUnconfiguredModels = !state.hideUnconfiguredModels
+      if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+      state.config.settings.hideUnconfiguredModels = state.hideUnconfiguredModels
+      if (state.activeProfile && state.config.profiles?.[state.activeProfile]) {
+        const profile = state.config.profiles[state.activeProfile]
+        if (!profile.settings || typeof profile.settings !== 'object') profile.settings = {}
+        profile.settings.hideUnconfiguredModels = state.hideUnconfiguredModels
+      }
+      saveConfig(state.config)
+      applyTierFilter()
+      const visible = state.results.filter(r => !r.hidden)
+      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
+      state.cursor = 0
+      state.scrollOffset = 0
+      return
+    }
+
     // 📖 Tier toggle key: T = cycle through each individual tier (All → S+ → S → A+ → A → A- → B+ → B → C → All)
     if (key.name === 't') {
       state.tierFilterMode = (state.tierFilterMode + 1) % TIER_CYCLE.length

package/src/overlays.js

@@ -105,6 +105,8 @@ export function createOverlayRenderers(state, deps) {
       let testBadge = chalk.dim('[Test —]')
       if (testResult === 'pending') testBadge = chalk.yellow('[Testing…]')
       else if (testResult === 'ok')   testBadge = chalk.greenBright('[Test ✅]')
+      else if (testResult === 'rate_limited') testBadge = chalk.yellow('[Rate limit ⏳]')
+      else if (testResult === 'no_callable_model') testBadge = chalk.magenta('[No model ⚠]')
       else if (testResult === 'fail') testBadge = chalk.red('[Test ❌]')
       const rateSummary = chalk.dim((meta.rateLimits || 'No limit info').slice(0, 36))
 
@@ -279,6 +281,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push('')
     lines.push(`  ${chalk.bold('Controls')}`)
     lines.push(`  ${chalk.yellow('W')}  Toggle ping mode  ${chalk.dim('(speed 2s → normal 10s → slow 30s → forced 4s)')}`)
+    lines.push(`  ${chalk.yellow('E')}  Toggle configured models only  ${chalk.dim('(enabled by default, persisted globally + in profiles)')}`)
     lines.push(`  ${chalk.yellow('X')}  Toggle token log page  ${chalk.dim('(shows recent request usage from request-log.jsonl)')}`)
     lines.push(`  ${chalk.yellow('Z')}  Cycle tool mode  ${chalk.dim('(OpenCode CLI → OpenCode Desktop → OpenClaw)')}`)
     lines.push(`  ${chalk.yellow('F')}  Toggle favorite on selected row  ${chalk.dim('(⭐ pinned at top, persisted)')}`)
@@ -288,7 +291,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${chalk.yellow('P')}  Open settings  ${chalk.dim('(manage API keys, provider toggles, manual update)')}`)
     lines.push(`  ${chalk.yellow('Shift+P')}  Cycle config profile  ${chalk.dim('(switch between saved profiles live)')}`)
     lines.push(`  ${chalk.yellow('Shift+S')}  Save current config as a named profile  ${chalk.dim('(inline prompt — type name + Enter)')}`)
-    lines.push(`             ${chalk.dim('Profiles store: favorites, sort, tier filter, ping interval, API keys.')}`)
+    lines.push(`             ${chalk.dim('Profiles store: favorites, sort, tier filter, ping interval, configured-only filter, API keys.')}`)
     lines.push(`             ${chalk.dim('Use --profile <name> to load a profile on startup.')}`)
     lines.push(`  ${chalk.yellow('K')} / ${chalk.yellow('Esc')}  Show/hide this help`)
     lines.push(`  ${chalk.yellow('Ctrl+C')}  Exit`)

package/src/provider-metadata.js

@@ -77,140 +77,140 @@ export const OPENCODE_MODEL_MAP = {
 export const PROVIDER_METADATA = {
   nvidia: {
     label: 'NVIDIA NIM',
-    color: chalk.rgb(118, 185, 0),
+    color: chalk.rgb(178, 235, 190),
     signupUrl: 'https://build.nvidia.com',
     signupHint: 'Profile → API Keys → Generate',
     rateLimits: 'Free tier (provider quota by model)',
   },
   groq: {
     label: 'Groq',
-    color: chalk.rgb(249, 103, 20),
+    color: chalk.rgb(255, 204, 188),
     signupUrl: 'https://console.groq.com/keys',
     signupHint: 'API Keys → Create API Key',
     rateLimits: 'Free dev tier (provider quota)',
   },
   cerebras: {
     label: 'Cerebras',
-    color: chalk.rgb(0, 180, 255),
+    color: chalk.rgb(179, 229, 252),
     signupUrl: 'https://cloud.cerebras.ai',
     signupHint: 'API Keys → Create',
     rateLimits: 'Free dev tier (provider quota)',
   },
   sambanova: {
     label: 'SambaNova',
-    color: chalk.rgb(255, 165, 0),
+    color: chalk.rgb(255, 224, 178),
     signupUrl: 'https://cloud.sambanova.ai/apis',
     signupHint: 'SambaCloud portal → Create API key',
     rateLimits: 'Dev tier generous quota',
   },
   openrouter: {
     label: 'OpenRouter',
-    color: chalk.rgb(120, 80, 255),
+    color: chalk.rgb(225, 190, 231),
     signupUrl: 'https://openrouter.ai/keys',
     signupHint: 'API Keys → Create',
     rateLimits: '50 req/day, 20/min (:free shared quota)',
   },
   huggingface: {
     label: 'Hugging Face Inference',
-    color: chalk.rgb(255, 182, 0),
+    color: chalk.rgb(255, 245, 157),
     signupUrl: 'https://huggingface.co/settings/tokens',
     signupHint: 'Settings → Access Tokens',
     rateLimits: 'Free monthly credits (~$0.10)',
   },
   replicate: {
     label: 'Replicate',
-    color: chalk.rgb(120, 160, 255),
+    color: chalk.rgb(187, 222, 251),
     signupUrl: 'https://replicate.com/account/api-tokens',
     signupHint: 'Account → API Tokens',
     rateLimits: 'Developer free quota',
   },
   deepinfra: {
     label: 'DeepInfra',
-    color: chalk.rgb(0, 180, 140),
+    color: chalk.rgb(178, 223, 219),
     signupUrl: 'https://deepinfra.com/login',
     signupHint: 'Login → API keys',
     rateLimits: 'Free dev tier (low-latency quota)',
   },
   fireworks: {
     label: 'Fireworks AI',
-    color: chalk.rgb(255, 80, 50),
+    color: chalk.rgb(255, 205, 210),
     signupUrl: 'https://fireworks.ai',
     signupHint: 'Create account → Generate API key',
     rateLimits: '$1 free credits (new dev accounts)',
   },
   codestral: {
     label: 'Mistral Codestral',
-    color: chalk.rgb(255, 100, 100),
+    color: chalk.rgb(248, 187, 208),
     signupUrl: 'https://codestral.mistral.ai',
     signupHint: 'API Keys → Create',
     rateLimits: '30 req/min, 2000/day',
   },
   hyperbolic: {
     label: 'Hyperbolic',
-    color: chalk.rgb(0, 200, 150),
+    color: chalk.rgb(200, 230, 201),
     signupUrl: 'https://app.hyperbolic.ai/settings',
     signupHint: 'Settings → API Keys',
     rateLimits: '$1 free trial credits',
   },
   scaleway: {
     label: 'Scaleway',
-    color: chalk.rgb(130, 0, 250),
+    color: chalk.rgb(129, 212, 250),
     signupUrl: 'https://console.scaleway.com/iam/api-keys',
     signupHint: 'IAM → API Keys',
     rateLimits: '1M free tokens',
   },
   googleai: {
     label: 'Google AI Studio',
-    color: chalk.rgb(66, 133, 244),
+    color: chalk.rgb(187, 222, 251),
     signupUrl: 'https://aistudio.google.com/apikey',
     signupHint: 'Get API key',
     rateLimits: '14.4K req/day, 30/min',
   },
   siliconflow: {
     label: 'SiliconFlow',
-    color: chalk.rgb(255, 120, 30),
+    color: chalk.rgb(178, 235, 242),
     signupUrl: 'https://cloud.siliconflow.cn/account/ak',
     signupHint: 'API Keys → Create',
     rateLimits: 'Free models: usually 100 RPM, varies by model',
   },
   together: {
     label: 'Together AI',
-    color: chalk.rgb(0, 180, 255),
+    color: chalk.rgb(197, 225, 165),
     signupUrl: 'https://api.together.ai/settings/api-keys',
     signupHint: 'Settings → API keys',
     rateLimits: 'Credits/promos vary by account (check console)',
   },
   cloudflare: {
     label: 'Cloudflare Workers AI',
-    color: chalk.rgb(242, 119, 36),
+    color: chalk.rgb(255, 204, 128),
     signupUrl: 'https://dash.cloudflare.com',
     signupHint: 'Create AI API token + set CLOUDFLARE_ACCOUNT_ID',
     rateLimits: 'Free: 10k neurons/day, text-gen 300 RPM',
   },
   perplexity: {
     label: 'Perplexity API',
-    color: chalk.rgb(0, 210, 190),
+    color: chalk.rgb(159, 234, 201),
     signupUrl: 'https://www.perplexity.ai/settings/api',
     signupHint: 'Generate API key (billing may be required)',
     rateLimits: 'Tiered limits by spend (default ~50 RPM)',
   },
   qwen: {
     label: 'Alibaba Cloud (DashScope)',
-    color: chalk.rgb(255, 140, 0),
+    color: chalk.rgb(255, 224, 130),
     signupUrl: 'https://modelstudio.console.alibabacloud.com',
     signupHint: 'Model Studio → API Key → Create (1M free tokens, 90 days)',
     rateLimits: '1M free tokens per model (Singapore region, 90 days)',
   },
   zai: {
     label: 'ZAI (z.ai)',
-    color: chalk.rgb(0, 150, 255),
+    color: chalk.rgb(174, 213, 255),
     signupUrl: 'https://z.ai',
     signupHint: 'Sign up and generate an API key',
     rateLimits: 'Free tier (generous quota)',
   },
   iflow: {
     label: 'iFlow',
-    color: chalk.rgb(100, 200, 255),
+    color: chalk.rgb(220, 231, 117),
     signupUrl: 'https://platform.iflow.cn',
     signupHint: 'Register → Personal Information → Generate API Key (7-day expiry)',
     rateLimits: 'Free for individuals (no request limits)',

package/src/render-table.js

@@ -43,29 +43,29 @@ import { calculateViewport, sortResultsWithPinnedFavorites, renderProxyStatusLin
 const require = createRequire(import.meta.url)
 const { version: LOCAL_VERSION } = require('../package.json')
 
-// 📖 Provider column palette: keep all Origins in the same visual family
-// 📖 (blue/cyan tones) while making each provider easy to distinguish at a glance.
+// 📖 Provider column palette: soft pastel rainbow so each provider stays easy
+// 📖 to spot without turning the table into a harsh neon wall.
 const PROVIDER_COLOR = {
-  nvidia: [120, 205, 255],
-  groq: [95, 185, 255],
-  cerebras: [70, 165, 255],
-  sambanova: [45, 145, 245],
-  openrouter: [135, 220, 255],
-  huggingface: [110, 190, 235],
-  replicate: [85, 175, 230],
-  deepinfra: [60, 160, 225],
-  fireworks: [125, 215, 245],
-  codestral: [100, 180, 240],
-  hyperbolic: [75, 170, 240],
-  scaleway: [55, 150, 235],
-  googleai: [130, 210, 255],
-  siliconflow: [90, 195, 245],
-  together: [65, 155, 245],
-  cloudflare: [115, 200, 240],
-  perplexity: [140, 225, 255],
-  qwen: [80, 185, 235],
-  zai: [50, 140, 225],
-  iflow: [145, 230, 255],
+  nvidia: [178, 235, 190],
+  groq: [255, 204, 188],
+  cerebras: [179, 229, 252],
+  sambanova: [255, 224, 178],
+  openrouter: [225, 190, 231],
+  huggingface: [255, 245, 157],
+  replicate: [187, 222, 251],
+  deepinfra: [178, 223, 219],
+  fireworks: [255, 205, 210],
+  codestral: [248, 187, 208],
+  hyperbolic: [200, 230, 201],
+  scaleway: [129, 212, 250],
+  googleai: [187, 222, 251],
+  siliconflow: [178, 235, 242],
+  together: [197, 225, 165],
+  cloudflare: [255, 204, 128],
+  perplexity: [159, 234, 201],
+  qwen: [255, 224, 130],
+  zai: [174, 213, 255],
+  iflow: [220, 231, 117],
 }
 
 // 📖 Active proxy reference for footer status line (set by bin/free-coding-models.js).
@@ -77,7 +77,7 @@ export function setActiveProxy(proxyInstance) {
 }
 
 // ─── renderTable: mode param controls footer hint text (opencode vs openclaw) ─────────
-export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto') {
+export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, activeProfile = null, profileSaveMode = false, profileSaveBuffer = '', proxyStartupStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -85,48 +85,48 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   const down    = visibleResults.filter(r => r.status === 'down').length
   const timeout = visibleResults.filter(r => r.status === 'timeout').length
   const pending = visibleResults.filter(r => r.status === 'pending').length
+  const totalVisible = visibleResults.length
+  const completedPings = Math.max(0, totalVisible - pending)
 
   // 📖 Calculate seconds until next ping
   const timeSinceLastPing = Date.now() - lastPingTime
   const timeUntilNextPing = Math.max(0, pingInterval - timeSinceLastPing)
-  const secondsUntilNext = Math.ceil(timeUntilNextPing / 1000)
-
-  const phase = pending > 0
-    ? chalk.dim(`discovering — ${pending} remaining…`)
-    : pendingPings > 0
-      ? chalk.dim(`pinging — ${pendingPings} in flight…`)
-      : chalk.dim(`next ping ${secondsUntilNext}s`)
+  const secondsUntilNext = timeUntilNextPing / 1000
+  const secondsUntilNextLabel = secondsUntilNext.toFixed(1)
 
   const intervalSec = Math.round(pingInterval / 1000)
   const pingModeMeta = {
-    speed: { label: `${intervalSec}s speed`, color: chalk.bold.rgb(255, 210, 80) },
-    normal: { label: `${intervalSec}s normal`, color: chalk.bold.rgb(120, 210, 255) },
-    slow: { label: `${intervalSec}s slow`, color: chalk.bold.rgb(255, 170, 90) },
-    forced: { label: `${intervalSec}s forced`, color: chalk.bold.rgb(255, 120, 120) },
+    speed: { label: 'fast', color: chalk.bold.rgb(255, 210, 80) },
+    normal: { label: 'normal', color: chalk.bold.rgb(120, 210, 255) },
+    slow: { label: 'slow', color: chalk.bold.rgb(255, 170, 90) },
+    forced: { label: 'forced', color: chalk.bold.rgb(255, 120, 120) },
   }
   const activePingMode = pingModeMeta[pingMode] ?? pingModeMeta.normal
-  const pingModeBadge = activePingMode.color(` [${activePingMode.label}]`)
-  const pingModeHint = pingModeSource === 'idle'
-    ? chalk.dim(' idle')
-    : pingModeSource === 'activity'
-      ? chalk.dim(' resumed')
-      : pingModeSource === 'startup'
-        ? chalk.dim(' startup')
-        : ''
-
-  // 📖 Mode badge shown in header so user knows what Enter will do
-  // 📖 Now includes key hint for mode toggle
+  const pingProgressText = `${completedPings}/${totalVisible}`
+  const nextCountdownColor = secondsUntilNext > 8
+    ? chalk.red.bold
+    : secondsUntilNext >= 4
+      ? chalk.yellow.bold
+      : secondsUntilNext < 1
+        ? chalk.greenBright.bold
+        : chalk.green.bold
+  const pingControlBadge =
+    activePingMode.color(' [ ') +
+    chalk.yellow.bold('W') +
+    activePingMode.color(` Ping Interval : ${intervalSec}s (${activePingMode.label}) - ${pingProgressText} - next : `) +
+    nextCountdownColor(`${secondsUntilNextLabel}s`) +
+    activePingMode.color(' ]')
+
+  // 📖 Tool badge keeps the active launch target visible in the header, so the
+  // 📖 footer no longer needs a redundant Enter action or mode toggle reminder.
   let modeBadge
   if (mode === 'openclaw') {
-    modeBadge = chalk.bold.rgb(255, 100, 50)(' [🦞 OpenClaw]')
+    modeBadge = chalk.bold.rgb(255, 100, 50)(' [ ') + chalk.yellow.bold('Z') + chalk.bold.rgb(255, 100, 50)(' Tool : OpenClaw ]')
   } else if (mode === 'opencode-desktop') {
-    modeBadge = chalk.bold.rgb(0, 200, 255)(' [🖥  Desktop]')
+    modeBadge = chalk.bold.rgb(0, 200, 255)(' [ ') + chalk.yellow.bold('Z') + chalk.bold.rgb(0, 200, 255)(' Tool : OpenCode Desktop ]')
   } else {
-    modeBadge = chalk.bold.rgb(0, 200, 255)(' [💻 CLI]')
+    modeBadge = chalk.bold.rgb(0, 200, 255)(' [ ') + chalk.yellow.bold('Z') + chalk.bold.rgb(0, 200, 255)(' Tool : OpenCode CLI ]')
   }
-  
-  // 📖 Add mode toggle hint
-  const modeHint = chalk.dim.yellow(' (Z to toggle)')
 
   // 📖 Tier filter badge shown when filtering is active (shows exact tier name)
   const TIER_CYCLE_NAMES = [null, 'S+', 'S', 'A+', 'A', 'A-', 'B+', 'B', 'C']
@@ -172,16 +172,29 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   const W_UPTIME = 6
   const W_TOKENS = 7
   const W_USAGE = 7
+  const MIN_TABLE_WIDTH = 166
+
+  if (terminalCols > 0 && terminalCols < MIN_TABLE_WIDTH) {
+    const lines = []
+    const blankLines = Math.max(0, Math.floor(((terminalRows || 24) - 3) / 2))
+    const warning = 'Please maximize your terminal for optimal use. The current terminal width is too small for the full table.'
+    const padLeft = Math.max(0, Math.floor((terminalCols - warning.length) / 2))
+    for (let i = 0; i < blankLines; i++) lines.push('')
+    lines.push(' '.repeat(padLeft) + chalk.red.bold(warning))
+    while (terminalRows > 0 && lines.length < terminalRows) lines.push('')
+    const EL = '\x1b[K'
+    return lines.map(line => line + EL).join('\n')
+  }
 
   // 📖 Sort models using the shared helper
   const sorted = sortResultsWithPinnedFavorites(visibleResults, sortColumn, sortDirection)
 
   const lines = [
-    `  ${chalk.greenBright.bold('✅ FCM')}${modeBadge}${pingModeBadge}${modeHint}${tierBadge}${originBadge}${profileBadge}   ` +
+    `  ${chalk.greenBright.bold(`✅ Free-Coding-Models v${LOCAL_VERSION}`)}${modeBadge}${pingControlBadge}${tierBadge}${originBadge}${profileBadge}${chalk.reset('')}   ` +
       chalk.greenBright(`✅ ${up}`) + chalk.dim(' up  ') +
       chalk.yellow(`⏳ ${timeout}`) + chalk.dim(' timeout  ') +
       chalk.red(`❌ ${down}`) + chalk.dim(' down  ') +
-      phase,
+      '',
     '',
   ]
 
@@ -276,6 +289,16 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     chalk.dim('─'.repeat(W_USAGE))
   )
 
+  if (sorted.length === 0) {
+    lines.push('')
+    if (hideUnconfiguredModels) {
+      lines.push(`  ${chalk.redBright.bold('Press P to configure your API key.')}`)
+      lines.push(`  ${chalk.dim('No configured provider currently exposes visible models in the table.')}`)
+    } else {
+      lines.push(`  ${chalk.yellow.bold('No models match the current filters.')}`)
+    }
+  }
+
   // 📖 Viewport clipping: only render models that fit on screen
   const vp = calculateViewport(terminalRows, scrollOffset, sorted.length)
 
@@ -303,6 +326,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const prefixDisplayWidth = 2
     const nameWidth = Math.max(0, W_MODEL - prefixDisplayWidth)
     const name = favoritePrefix + r.label.slice(0, nameWidth).padEnd(nameWidth)
+    const modelColor = chalk.rgb(...providerRgb)
     const sweScore = r.sweScore ?? '—'
     // 📖 SWE% colorized on the same gradient as Tier:
     //   ≥70% bright neon green (S+), ≥60% green (S), ≥50% yellow-green (A+),
@@ -490,10 +514,11 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       uptimeCell = chalk.red(uptimeStr.padEnd(W_UPTIME))
     }
 
-    // 📖 When cursor is on this row, render Model and Provider in bright white for readability
-    const nameCell = isCursor ? chalk.white.bold(favoritePrefix + r.label.slice(0, nameWidth).padEnd(nameWidth)) : name
+    // 📖 Model text now mirrors the provider hue so provider affinity is visible
+    // 📖 even before the eye reaches the Provider column.
+    const nameCell = isCursor ? modelColor.bold(name) : modelColor(name)
     const sourceCursorText = providerName.padEnd(W_SOURCE)
-    const sourceCell = isCursor ? chalk.white.bold(sourceCursorText) : source
+    const sourceCell = isCursor ? chalk.rgb(...providerRgb).bold(sourceCursorText) : source
 
     // 📖 Usage column — provider-scoped remaining quota when measurable,
     // 📖 otherwise a green dot to show "usable but not meaningfully quantifiable".
@@ -527,12 +552,12 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const row = '  ' + num + '  ' + tier + '  ' + sweCell + '  ' + ctxCell + '  ' + nameCell + '  ' + sourceCell + '  ' + pingCell + '  ' + avgCell + '  ' + status + '  ' + speedCell + '  ' + stabCell + '  ' + uptimeCell + '  ' + tokensCell + '  ' + usageCell
 
     if (isCursor) {
-      lines.push(chalk.bgRgb(50, 0, 60)(row))
+      lines.push(chalk.bgRgb(155, 55, 135)(row))
     } else if (r.isRecommended) {
       // 📖 Medium green background for recommended models (distinguishable from favorites)
       lines.push(chalk.bgRgb(15, 40, 15)(row))
     } else if (r.isFavorite) {
-      lines.push(chalk.bgRgb(35, 20, 0)(row))
+      lines.push(chalk.bgRgb(88, 64, 10)(row))
     } else {
       lines.push(row)
     }
@@ -548,15 +573,11 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
    } else {
      lines.push('')
    }
-  // 📖 Footer hints adapt based on active mode.
+  // 📖 Footer hints keep only navigation and secondary actions now that the
+  // 📖 active tool target is already visible in the header badge.
   const hotkey = (keyLabel, text) => chalk.yellow(keyLabel) + chalk.dim(text)
-  const actionHint = mode === 'openclaw'
-    ? hotkey('Enter', '→SetOpenClaw')
-    : mode === 'opencode-desktop'
-      ? hotkey('Enter', '→OpenDesktop')
-      : hotkey('Enter', '→OpenCode')
-  // 📖 Line 1: core navigation + sorting shortcuts
-  lines.push(chalk.dim(`  ↑↓ Navigate  •  `) + actionHint + chalk.dim(`  •  `) + hotkey('F', ' Toggle Favorite') + chalk.dim(`  •  Press Highlighted letters in column named to sort & filter  •  `) + hotkey('T', ' Tier') + chalk.dim(`  •  `) + hotkey('D', ' Provider') + chalk.dim(`  •  `) + hotkey('W', ' Ping Mode : FAST/NORMAL/SLOW/FORCED') + chalk.dim(`  •  `) + hotkey('Z', ' Tool Mode') + chalk.dim(`  •  `) + hotkey('X', ' Token Logs') + chalk.dim(`  •  `) + hotkey('P', ' Settings') + chalk.dim(`  •  `) + hotkey('K', ' Help'))
+  // 📖 Line 1: core navigation + filtering shortcuts
+  lines.push(chalk.dim(`  ↑↓ Navigate  •  `) + hotkey('F', ' Toggle Favorite') + chalk.dim(`  •  `) + hotkey('T', ' Tier') + chalk.dim(`  •  `) + hotkey('D', ' Provider') + chalk.dim(`  •  `) + hotkey('E', ' Configured Only') + chalk.dim(`  •  `) + hotkey('X', ' Token Logs') + chalk.dim(`  •  `) + hotkey('P', ' Settings') + chalk.dim(`  •  `) + hotkey('K', ' Help'))
   // 📖 Line 2: profiles, recommend, feature request, bug report, and extended hints — gives visibility to less-obvious features
   lines.push(chalk.dim(`  `) + hotkey('⇧P', ' Cycle profile') + chalk.dim(`  •  `) + hotkey('⇧S', ' Save profile') + chalk.dim(`  •  `) + hotkey('Q', ' Smart Recommend') + chalk.dim(`  •  `) + hotkey('J', ' Request feature') + chalk.dim(`  •  `) + hotkey('I', ' Report bug'))
   // 📖 Proxy status line — always rendered with explicit state (starting/running/failed/stopped)
@@ -575,8 +596,6 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     chalk.dim(' → ') +
     chalk.rgb(200, 150, 255)('https://discord.gg/5MbTnDC3Md') +
     chalk.dim('  •  ') +
-    chalk.dim(`v${LOCAL_VERSION}`) +
-    chalk.dim('  •  ') +
     chalk.dim('Ctrl+C Exit')
   )