free-coding-models 0.3.19 → 0.3.21

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ---
 
+## 0.3.21
+
+### Changed
+- **Responsive table layout**: the TUI now adapts to narrow terminals by progressively shrinking columns and hiding least-useful ones. Compact mode shortens headers (`Lat. P`, `Avg. P`, `StaB.`, `PrOD…`) and tightens Provider (10 cols), Health (13 cols), Latest Ping (10 cols), and Avg Ping (8 cols). Below compact, Rank → Up% → Tier → Stability are hidden one by one. Minimum usable width: ~116 cols.
+- **SWE% column tightened**: reduced from 9 to 6 columns wide — trims excess right padding without losing data.
+- **Provider truncation in compact mode**: provider names longer than 5 chars are truncated to 4 chars + `…` (e.g. `Cere…`).
+- **Health truncation in compact mode**: status text longer than 6 chars is truncated with `…` (e.g. `🔥 429 TR…`).
+- **Removed "Used" column from TUI**: the token usage column has been removed from the main table as it was outdated.
+- **Width guardrail threshold tightened**: the narrow-terminal warning now triggers only below 80 columns (instead of broader widths) and keeps the same 2-second auto-hide behavior.
+- **Width warning is always enforced in narrow terminals**: removed the `Small Width Warnings` Settings toggle and the `--disable-widths-warning` runtime flag so the startup guardrail stays consistent.
+
+### Fixed
+- **`--premium` filter lock-in**: premium now applies a resettable startup preset (S-tier + verdict sort) instead of hard-locking an extra hidden elite-only filter.
+
 ## 0.3.19
 
 ### Added

package/README.md

@@ -133,7 +133,7 @@ free-coding-models --goose --tier S
 # "I want NVIDIA's top models only"
 free-coding-models --origin nvidia --tier S
 
-# "Show me only elite models that are currently healthy"
+# "Start with an elite-focused preset, then adjust filters live"
 free-coding-models --premium
 
 # "I want to script this — give me JSON"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "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

@@ -105,7 +105,7 @@ import { usageForRow as _usageForRow } from '../src/usage-reader.js'
 import { buildProviderModelTokenKey, loadTokenUsageByProviderModel } from '../src/token-usage-reader.js'
 import { parseOpenRouterResponse, fetchProviderQuota as _fetchProviderQuotaFromModule } from '../src/provider-quota-fetchers.js'
 import { isKnownQuotaTelemetry } from '../src/quota-capabilities.js'
-import { ALT_ENTER, ALT_LEAVE, ALT_HOME, PING_TIMEOUT, PING_INTERVAL, FPS, COL_MODEL, COL_MS, CELL_W, FRAMES, TIER_CYCLE, SETTINGS_OVERLAY_BG, HELP_OVERLAY_BG, RECOMMEND_OVERLAY_BG, OVERLAY_PANEL_WIDTH, TABLE_HEADER_LINES, TABLE_FOOTER_LINES, TABLE_FIXED_LINES, msCell, spinCell } from '../src/constants.js'
+import { ALT_ENTER, ALT_LEAVE, ALT_HOME, PING_TIMEOUT, PING_INTERVAL, FPS, COL_MODEL, COL_MS, CELL_W, FRAMES, TIER_CYCLE, SETTINGS_OVERLAY_BG, HELP_OVERLAY_BG, RECOMMEND_OVERLAY_BG, OVERLAY_PANEL_WIDTH, TABLE_HEADER_LINES, TABLE_FOOTER_LINES, TABLE_FIXED_LINES, WIDTH_WARNING_MIN_COLS, msCell, spinCell } from '../src/constants.js'
 import { TIER_COLOR } from '../src/tier-colors.js'
 import { resolveCloudflareUrl, buildPingRequest, ping, extractQuotaPercent, getProviderQuotaPercentCached, usagePlaceholderForProvider } from '../src/ping.js'
 import { runFiableMode, filterByTierOrExit, fetchOpenRouterFreeModels } from '../src/analysis.js'
@@ -192,9 +192,8 @@ export async function runApp(cliArgs, config) {
   if (cliArgs.pingInterval) config.settings.pingInterval = cliArgs.pingInterval
   if (cliArgs.hideUnconfigured) config.settings.hideUnconfiguredModels = true
   if (cliArgs.showUnconfigured) config.settings.hideUnconfiguredModels = false
-  if (cliArgs.disableWidthsWarning) config.settings.disableWidthsWarning = true
 
-  // 📖 Apply premium mode: show only S‑tier models sorted by verdict
+  // 📖 Apply premium mode as an initial, user-resettable view preset.
   if (cliArgs.premiumMode) {
     config.settings.tierFilter = 'S'
     config.settings.sortColumn = 'verdict'
@@ -383,13 +382,11 @@ export async function runApp(cliArgs, config) {
     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)
-    premiumMode: cliArgs.premiumMode, // 📖 Special elite-only mode: S/S+ only, Health UP only, Perfect/Normal/Slow verdict only.
     hideUnconfiguredModels: config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
-    disableWidthsWarning: config.settings?.disableWidthsWarning ?? false, // 📖 Cached for runtime checks; keep it in sync with config.settings.
       scrollOffset: 0,              // 📖 First visible model index in viewport
       terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
       terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
-      widthWarningStartedAt: (process.stdout.columns || 80) < 166 && !(config.settings?.disableWidthsWarning ?? false) ? now : null, // 📖 Start immediately only when warnings are enabled in a narrow viewport.
+      widthWarningStartedAt: (process.stdout.columns || 80) < WIDTH_WARNING_MIN_COLS ? now : null, // 📖 Start immediately in very narrow viewports.
     widthWarningDismissed: false, // 📖 Esc hides the narrow-terminal warning early for the current narrow-width session.
     widthWarningShowCount: 0, // 📖 Counter for how many times the narrow-terminal warning has been shown (max 2 per session).
     // 📖 Settings screen state (P key opens it)
@@ -465,12 +462,10 @@ export async function runApp(cliArgs, config) {
   // 📖 Re-clamp viewport on terminal resize
   process.stdout.on('resize', () => {
     const prevCols = state.terminalCols
-    const widthsWarningDisabled = state.config.settings?.disableWidthsWarning === true
     state.terminalRows = process.stdout.rows || 24
     state.terminalCols = process.stdout.columns || 80
-    state.disableWidthsWarning = widthsWarningDisabled
-    if (state.terminalCols < 166 && !widthsWarningDisabled) {
-      if (prevCols >= 166 || state.widthWarningDismissed) {
+    if (state.terminalCols < WIDTH_WARNING_MIN_COLS) {
+      if (prevCols >= WIDTH_WARNING_MIN_COLS || state.widthWarningDismissed) {
         state.widthWarningStartedAt = Date.now()
         state.widthWarningDismissed = false
         state.widthWarningShowCount++ // 📖 Increment counter when showing the warning again
@@ -630,15 +625,10 @@ export async function runApp(cliArgs, config) {
       outputResults = outputResults.filter(r => ['S+', 'S', 'A+'].includes(r.tier))
     }
 
-    // 📖 Apply premium mode filter if specified: elite-only (S/S+, UP, Good Verdict)
+    // 📖 Apply premium mode as a preselected tier family in JSON mode as well.
     if (cliArgs.premiumMode) {
-      outputResults = outputResults.filter(r => {
-        const isEliteTier = r.tier === 'S' || r.tier === 'S+'
-        const isHealthUp = r.status === 'up'
-        const verdict = getVerdict(r)
-        const isGoodVerdict = ['Perfect', 'Normal', 'Slow'].includes(verdict)
-        return isEliteTier && isHealthUp && isGoodVerdict
-      })
+      const premiumTiers = TIER_LETTER_MAP.S || ['S+', 'S']
+      outputResults = outputResults.filter(r => premiumTiers.includes(r.tier))
     }
 
     // 📖 Sort by avg ping (ascending)
@@ -702,17 +692,6 @@ export async function runApp(cliArgs, config) {
       const originHide = activeOrigin !== null && r.providerKey !== activeOrigin
       r.hidden = tierHide || originHide
 
-      // 📖 Premium Mode: elite-only constraints (Health UP, Good Verdict, S/S+ only)
-      if (state.premiumMode && !r.hidden) {
-        const isEliteTier = r.tier === 'S' || r.tier === 'S+'
-        const isHealthUp = r.status === 'up'
-        const verdict = getVerdict(r)
-        const isGoodVerdict = ['Perfect', 'Normal', 'Slow'].includes(verdict)
-
-        if (!isEliteTier || !isHealthUp || !isGoodVerdict) {
-          r.hidden = true
-        }
-      }
     })
     return state.results
   }
@@ -900,8 +879,7 @@ export async function runApp(cliArgs, config) {
           state.settingsUpdateLatestVersion,
           false,
           state.startupLatestVersion,
-          state.versionAlertsEnabled,
-          state.config.settings?.disableWidthsWarning ?? false
+          state.versionAlertsEnabled
         )
       }
       tableContent = state.commandPaletteFrozenTable
@@ -933,8 +911,7 @@ export async function runApp(cliArgs, config) {
         state.settingsUpdateLatestVersion,
         false,
         state.startupLatestVersion,
-        state.versionAlertsEnabled,
-        state.config.settings?.disableWidthsWarning ?? false
+        state.versionAlertsEnabled
       )
     }
 
@@ -972,7 +949,7 @@ export async function runApp(cliArgs, config) {
   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.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.config.settings?.disableWidthsWarning ?? false))
+  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))
   if (process.stdout.isTTY) {
     process.stdout.flush && process.stdout.flush()
   }

package/src/cli-help.js

@@ -26,14 +26,13 @@ const ANALYSIS_FLAGS = [
   { flag: '--json', description: 'Output results as JSON for scripts/automation' },
   { flag: '--tier <S|A|B|C>', description: 'Filter models by tier family' },
   { flag: '--recommend', description: 'Open Smart Recommend immediately on startup' },
-  { flag: '--premium', description: 'Show only S/S+ models with perfect health and good verdict' },
+  { flag: '--premium', description: 'Start with S-tier filter + verdict sort (you can reset it in-app)' },
   { flag: '--sort <column>', description: 'Sort by column (rank, tier, origin, model, ping, avg, swe, ctx, condition, verdict, uptime, stability, usage)' },
   { flag: '--desc | --asc', description: 'Set sort direction (descending or ascending)' },
   { flag: '--origin <provider>', description: 'Filter models by provider origin' },
   { flag: '--ping-interval <ms>', description: 'Override ping interval in milliseconds' },
   { flag: '--hide-unconfigured', description: 'Hide models without configured API keys' },
   { flag: '--show-unconfigured', description: 'Show all models regardless of API key config' },
-  { flag: '--disable-widths-warning', description: 'Disable terminal width warning' },
 ]
 
 const CONFIG_FLAGS = [

package/src/config.js

@@ -209,7 +209,6 @@ function normalizeSettingsSection(settings) {
   return {
     ...safeSettings,
     hideUnconfiguredModels: typeof safeSettings.hideUnconfiguredModels === 'boolean' ? safeSettings.hideUnconfiguredModels : true,
-    disableWidthsWarning: safeSettings.disableWidthsWarning === true,
     theme: ['dark', 'light', 'auto'].includes(safeSettings.theme) ? safeSettings.theme : 'auto',
   }
 }
@@ -230,7 +229,6 @@ function normalizeProfileSettings(settings) {
   return {
     ..._emptyProfileSettings(),
     ...safeSettings,
-    disableWidthsWarning: safeSettings.disableWidthsWarning === true,
     theme: ['dark', 'light', 'auto'].includes(safeSettings.theme) ? safeSettings.theme : 'auto',
   }
 }
@@ -843,7 +841,6 @@ export function _emptyProfileSettings() {
     pingInterval: 10000,  // 📖 default ms between pings in the steady "normal" mode
     hideUnconfiguredModels: true, // 📖 true = default to providers that are actually configured
     preferredToolMode: 'opencode', // 📖 remember the last Z-selected launcher across app restarts
-    disableWidthsWarning: false, // 📖 Disable widths warning (default off)
     theme: 'auto',        // 📖 'auto' follows the terminal/OS theme, override with 'dark' or 'light' if needed
   }
 }

package/src/constants.js

@@ -17,6 +17,7 @@
  *   - `CELL_W` is derived from `COL_MS` and used by `msCell` / `spinCell`.
  *   - `TABLE_HEADER_LINES` + `TABLE_FOOTER_LINES` = `TABLE_FIXED_LINES` must stay in sync
  *     with the actual number of lines rendered by `renderTable()` in bin/.
+ *   - `WIDTH_WARNING_MIN_COLS` controls when the narrow-terminal startup warning appears.
  *   - Overlay background colours (chalk.bgRgb) make each overlay panel visually distinct.
  *
  * @functions
@@ -30,6 +31,7 @@
  *   FRAMES, TIER_CYCLE,
  *   SETTINGS_OVERLAY_BG, HELP_OVERLAY_BG, RECOMMEND_OVERLAY_BG, LOG_OVERLAY_BG,
  *   OVERLAY_PANEL_WIDTH,
+ *   WIDTH_WARNING_MIN_COLS,
  *   TABLE_HEADER_LINES, TABLE_FOOTER_LINES, TABLE_FIXED_LINES,
  *   msCell, spinCell
  *
@@ -83,6 +85,9 @@ export const LOG_OVERLAY_BG       = chalk.bgRgb(0, 0, 0)  // 📖 Dark blue-gree
 // 📖 tint fills the panel consistently regardless of content length.
 export const OVERLAY_PANEL_WIDTH = 116
 
+// 📖 Narrow-terminal warning appears only below this width.
+export const WIDTH_WARNING_MIN_COLS = 80
+
 // 📖 Table row-budget constants — must stay in sync with renderTable()'s actual output.
 // 📖 If this drifts, model rows overflow and can push the title row out of view.
 export const TABLE_HEADER_LINES = 4  // 📖 title, spacer, column headers, separator

package/src/key-handler.js

@@ -32,6 +32,7 @@ import { loadConfig, replaceConfigContents } from './config.js'
 import { cleanupLegacyProxyArtifacts } from './legacy-proxy-cleanup.js'
 import { cycleThemeSetting, detectActiveTheme } from './theme.js'
 import { buildCommandPaletteEntries, filterCommandPaletteEntries } from './command-palette.js'
+import { WIDTH_WARNING_MIN_COLS } from './constants.js'
 
 // 📖 Some providers need an explicit probe model because the first catalog entry
 // 📖 is not guaranteed to be accepted by their chat endpoint.
@@ -447,38 +448,6 @@ export function createKeyHandler(ctx) {
     }
   }
 
-  // 📖 Keep the width-warning runtime state synced with the persisted Settings toggle
-  // 📖 so the overlay reacts immediately when the user enables or disables it.
-  function syncWidthsWarningState() {
-    const widthsWarningDisabled = state.config.settings?.disableWidthsWarning === true
-    state.disableWidthsWarning = widthsWarningDisabled
-
-    if (widthsWarningDisabled) {
-      state.widthWarningStartedAt = null
-      state.widthWarningDismissed = false
-      return
-    }
-
-    state.widthWarningShowCount = 0
-    if ((state.terminalCols || 80) < 166) {
-      state.widthWarningStartedAt = Date.now()
-      state.widthWarningDismissed = false
-      return
-    }
-
-    state.widthWarningStartedAt = null
-    state.widthWarningDismissed = false
-  }
-
-  // 📖 Toggle the width-warning setting and apply the effect immediately instead
-  // 📖 of waiting for a resize or restart.
-  function toggleWidthsWarningSetting() {
-    if (!state.config.settings) state.config.settings = {}
-    state.config.settings.disableWidthsWarning = !state.config.settings.disableWidthsWarning
-    syncWidthsWarningState()
-    saveConfig(state.config)
-  }
-
   // 📖 Theme switches need to update both persisted preference and the live
   // 📖 semantic palette immediately so every screen redraw adopts the new colors.
   function applyThemeSetting(nextTheme) {
@@ -1384,8 +1353,7 @@ export function createKeyHandler(ctx) {
     if (state.settingsOpen) {
       const providerKeys = Object.keys(sources)
       const updateRowIdx = providerKeys.length
-      const widthWarningRowIdx = updateRowIdx + 1
-      const themeRowIdx = widthWarningRowIdx + 1
+      const themeRowIdx = updateRowIdx + 1
       const cleanupLegacyProxyRowIdx = themeRowIdx + 1
       const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
         // 📖 Profile system removed - API keys now persist permanently across all sessions
@@ -1530,12 +1498,6 @@ export function createKeyHandler(ctx) {
           return
         }
 
-        // 📖 Widths Warning toggle (Enter to toggle)
-        if (state.settingsCursor === widthWarningRowIdx) {
-          toggleWidthsWarningSetting()
-          return
-        }
-
         if (state.settingsCursor === themeRowIdx) {
           cycleGlobalTheme()
           return
@@ -1579,11 +1541,6 @@ export function createKeyHandler(ctx) {
           cycleGlobalTheme()
           return
         }
-        // 📖 Widths Warning toggle (disable/enable)
-        if (state.settingsCursor === widthWarningRowIdx) {
-          toggleWidthsWarningSetting()
-          return
-        }
         // 📖 Profile system removed - API keys now persist permanently across all sessions
 
         // 📖 Toggle enabled/disabled for selected provider
@@ -1598,7 +1555,6 @@ export function createKeyHandler(ctx) {
       if (key.name === 't') {
         if (
           state.settingsCursor === updateRowIdx
-          || state.settingsCursor === widthWarningRowIdx
           || state.settingsCursor === themeRowIdx
           || state.settingsCursor === cleanupLegacyProxyRowIdx
           || state.settingsCursor === changelogViewRowIdx
@@ -1805,7 +1761,7 @@ export function createKeyHandler(ctx) {
     }
 
     // 📖 Esc can dismiss the narrow-terminal warning immediately without quitting the app.
-    if (key.name === 'escape' && state.terminalCols > 0 && state.terminalCols < 166) {
+    if (key.name === 'escape' && state.terminalCols > 0 && state.terminalCols < WIDTH_WARNING_MIN_COLS) {
       state.widthWarningDismissed = true
       return
     }

package/src/overlays.js

@@ -93,8 +93,7 @@ export function createOverlayRenderers(state, deps) {
   function renderSettings() {
     const providerKeys = Object.keys(sources)
     const updateRowIdx = providerKeys.length
-    const widthWarningRowIdx = updateRowIdx + 1
-    const themeRowIdx = widthWarningRowIdx + 1
+    const themeRowIdx = updateRowIdx + 1
     const cleanupLegacyProxyRowIdx = themeRowIdx + 1
     const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
     const EL = '\x1b[K'
@@ -220,14 +219,6 @@ export function createOverlayRenderers(state, deps) {
     const updateRow = `${bullet(updateCursor)}${themeColors.textBold(updateActionLabel).padEnd(44)} ${updateStatus}`
     cursorLineByRow[updateRowIdx] = lines.length
     lines.push(updateCursor ? themeColors.bgCursor(updateRow) : updateRow)
-    // 📖 Width warning visibility row for the startup narrow-terminal overlay.
-    const disableWidthsWarning = Boolean(state.config.settings?.disableWidthsWarning)
-    const widthWarningStatus = disableWidthsWarning
-      ? themeColors.errorBold('🙈 Disabled')
-      : themeColors.successBold('👁 Enabled')
-    const widthWarningRow = `${bullet(state.settingsCursor === widthWarningRowIdx)}${themeColors.textBold('Small Width Warnings').padEnd(44)} ${widthWarningStatus}`
-    cursorLineByRow[widthWarningRowIdx] = lines.length
-    lines.push(state.settingsCursor === widthWarningRowIdx ? themeColors.bgCursor(widthWarningRow) : widthWarningRow)
     const themeStatus = getThemeStatusLabel(activeThemeSetting())
     const themeStatusColor = themeStatus.includes('Dark') ? themeColors.warningBold : themeColors.info
     const themeRow = `${bullet(state.settingsCursor === themeRowIdx)}${themeColors.textBold('Global Theme').padEnd(44)} ${themeStatusColor(themeStatus)}`

package/src/render-table.js

@@ -41,13 +41,13 @@ import {
   msCell,
   spinCell,
   PING_INTERVAL,
+  WIDTH_WARNING_MIN_COLS,
   FRAMES
 } from './constants.js'
 import { themeColors, getProviderRgb, getTierRgb, getReadableTextRgb, getTheme } from './theme.js'
 import { TIER_COLOR } from './tier-colors.js'
 import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo } from './utils.js'
 import { usagePlaceholderForProvider } from './ping.js'
-import { formatTokenTotalCompact } from './token-usage-reader.js'
 import { calculateViewport, sortResultsWithPinnedFavorites, padEndDisplay, displayWidth } from './render-helpers.js'
 import { getToolMeta } from './tool-metadata.js'
 import { PROXY_DISABLED_NOTICE } from './product-flags.js'
@@ -67,7 +67,7 @@ export const PROVIDER_COLOR = new Proxy({}, {
 })
 
 // ─── 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, terminalCols = 0, originFilterMode = 0, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true, disableWidthsWarning = false) {
+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, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -146,25 +146,68 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
 
   // 📖 Column widths (generous spacing with margins)
   const COL_SEP = getColumnSpacing()
+  const SEP_W = 3  // ' │ ' display width
+  const ROW_MARGIN = 2  // left margin '  '
   const W_RANK = 6
   const W_TIER = 6
   const W_CTX = 6
   const W_SOURCE = 14
   const W_MODEL = 26
-  const W_SWE = 9
-  const W_PING = 14
-  const W_AVG = 11
+  const W_SWE = 6
   const W_STATUS = 18
   const W_VERDICT = 14
-  const W_STAB = 11
   const W_UPTIME = 6
-  const W_TOKENS = 7
+  // const W_TOKENS = 7 // Used column removed
   // const W_USAGE = 7 // Usage column removed
-  const MIN_TABLE_WIDTH = 166
+  const MIN_TABLE_WIDTH = WIDTH_WARNING_MIN_COLS
+
+  // 📖 Responsive column visibility: progressively hide least-useful columns
+  // 📖 and shorten header labels when terminal width is insufficient.
+  // 📖 Hiding order (least useful first): Rank → Up% → Tier → Stability
+  // 📖 Compact mode shrinks: Latest Ping→Lat. P (10), Avg Ping→Avg. P (8),
+  // 📖 Stability→StaB. (8), Provider→4chars+… (10), Health→6chars+… (13)
+  let wPing = 14
+  let wAvg = 11
+  let wStab = 11
+  let wSource = W_SOURCE
+  let wStatus = W_STATUS
+  let showRank = true
+  let showUptime = true
+  let showTier = true
+  let showStability = true
+  let isCompact = false
+
+  if (terminalCols > 0) {
+    // 📖 Dynamically compute needed row width from visible columns
+    const calcWidth = () => {
+      const cols = []
+      if (showRank) cols.push(W_RANK)
+      if (showTier) cols.push(W_TIER)
+      cols.push(W_SWE, W_CTX, W_MODEL, wSource, wPing, wAvg, wStatus, W_VERDICT)
+      if (showStability) cols.push(wStab)
+      if (showUptime) cols.push(W_UPTIME)
+      return ROW_MARGIN + cols.reduce((a, b) => a + b, 0) + (cols.length - 1) * SEP_W
+    }
+
+    // 📖 Step 1: Compact mode — shorten labels and reduce column widths
+    if (calcWidth() > terminalCols) {
+      isCompact = true
+      wPing = 10     // 'Lat. P' instead of 'Latest Ping'
+      wAvg = 8       // 'Avg. P' instead of 'Avg Ping'
+      wStab = 8      // 'StaB.' instead of 'Stability'
+      wSource = 10   // Provider truncated to 4 chars + '…'
+      wStatus = 13   // Health truncated after 6 chars + '…'
+    }
+    // 📖 Steps 2–5: Progressive column hiding (least useful first)
+    if (calcWidth() > terminalCols) showRank = false
+    if (calcWidth() > terminalCols) showUptime = false
+    if (calcWidth() > terminalCols) showTier = false
+    if (calcWidth() > terminalCols) showStability = false
+  }
   const warningDurationMs = 2_000
   const elapsed = widthWarningStartedAt ? Math.max(0, Date.now() - widthWarningStartedAt) : warningDurationMs
   const remainingMs = Math.max(0, warningDurationMs - elapsed)
-  const showWidthWarning = terminalCols > 0 && terminalCols < MIN_TABLE_WIDTH && !disableWidthsWarning && !widthWarningDismissed && widthWarningShowCount < 2 && remainingMs > 0
+  const showWidthWarning = terminalCols > 0 && terminalCols < MIN_TABLE_WIDTH && !widthWarningDismissed && widthWarningShowCount < 2 && remainingMs > 0
 
   if (showWidthWarning) {
     const lines = []
@@ -217,13 +260,16 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   const modelH   = 'Model'
   const sweH     = sortColumn === 'swe' ? dir + ' SWE%' : 'SWE%'
   const ctxH     = sortColumn === 'ctx' ? dir + ' CTX' : 'CTX'
-  const pingH    = sortColumn === 'ping' ? dir + ' Latest Ping' : 'Latest Ping'
-  const avgH     = sortColumn === 'avg' ? dir + ' Avg Ping' : 'Avg Ping'
+  // 📖 Compact labels: 'Lat. P' / 'Avg. P' / 'StaB.' to save horizontal space
+  const pingLabel = isCompact ? 'Lat. P' : 'Latest Ping'
+  const avgLabel  = isCompact ? 'Avg. P' : 'Avg Ping'
+  const stabLabel = isCompact ? 'StaB.' : 'Stability'
+  const pingH    = sortColumn === 'ping' ? dir + ' ' + pingLabel : pingLabel
+  const avgH     = sortColumn === 'avg' ? dir + ' ' + avgLabel : avgLabel
   const healthH  = sortColumn === 'condition' ? dir + ' Health' : 'Health'
   const verdictH = sortColumn === 'verdict' ? dir + ' Verdict' : 'Verdict'
-  const stabH    = sortColumn === 'stability' ? dir + ' Stability' : 'Stability'
+  const stabH    = sortColumn === 'stability' ? dir + ' ' + stabLabel : stabLabel
   const uptimeH  = sortColumn === 'uptime' ? dir + ' Up%' : 'Up%'
-  const tokensH  = 'Used'
 
   // 📖 Helper to colorize first letter for keyboard shortcuts
   // 📖 IMPORTANT: Pad PLAIN TEXT first, then apply colors to avoid alignment issues
@@ -238,27 +284,31 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   // 📖 Now colorize after padding is calculated on plain text
   const rankH_c    = colorFirst(rankH, W_RANK)
   const tierH_c    = colorFirst('Tier', W_TIER)
-  const originLabel = 'Provider'
+  const originLabel = isCompact ? 'PrOD…' : 'Provider'
   const originH_c  = sortColumn === 'origin'
-    ? themeColors.accentBold(originLabel.padEnd(W_SOURCE))
-    : (originFilterMode > 0 ? themeColors.accentBold(originLabel.padEnd(W_SOURCE)) : (() => {
+    ? themeColors.accentBold(originLabel.padEnd(wSource))
+    : (originFilterMode > 0 ? themeColors.accentBold(originLabel.padEnd(wSource)) : (() => {
       // 📖 Provider keeps O for sorting and D for provider-filter cycling.
-      const plain = 'PrOviDer'
-      const padding = ' '.repeat(Math.max(0, W_SOURCE - plain.length))
+      // 📖 In compact mode, shorten to 'PrOD…' (4 chars + ellipsis) to save space.
+      const plain = isCompact ? 'PrOD…' : 'PrOviDer'
+      const padding = ' '.repeat(Math.max(0, wSource - plain.length))
+      if (isCompact) {
+        return themeColors.dim('Pr') + themeColors.hotkey('O') + themeColors.hotkey('D') + themeColors.dim('…' + padding)
+      }
       return themeColors.dim('Pr') + themeColors.hotkey('O') + themeColors.dim('vi') + themeColors.hotkey('D') + themeColors.dim('er' + padding)
     })())
   const modelH_c   = colorFirst(modelH, W_MODEL)
   const sweH_c     = sortColumn === 'swe' ? themeColors.accentBold(sweH.padEnd(W_SWE)) : colorFirst(sweH, W_SWE)
   const ctxH_c     = sortColumn === 'ctx' ? themeColors.accentBold(ctxH.padEnd(W_CTX)) : colorFirst(ctxH, W_CTX)
-  const pingH_c    = sortColumn === 'ping' ? themeColors.accentBold(pingH.padEnd(W_PING)) : colorFirst('Latest Ping', W_PING)
-  const avgH_c     = sortColumn === 'avg' ? themeColors.accentBold(avgH.padEnd(W_AVG)) : colorFirst('Avg Ping', W_AVG)
-  const healthH_c  = sortColumn === 'condition' ? themeColors.accentBold(healthH.padEnd(W_STATUS)) : colorFirst('Health', W_STATUS)
+  const pingH_c    = sortColumn === 'ping' ? themeColors.accentBold(pingH.padEnd(wPing)) : colorFirst(pingLabel, wPing)
+  const avgH_c     = sortColumn === 'avg' ? themeColors.accentBold(avgH.padEnd(wAvg)) : colorFirst(avgLabel, wAvg)
+  const healthH_c  = sortColumn === 'condition' ? themeColors.accentBold(healthH.padEnd(wStatus)) : colorFirst('Health', wStatus)
   const verdictH_c = sortColumn === 'verdict' ? themeColors.accentBold(verdictH.padEnd(W_VERDICT)) : colorFirst(verdictH, W_VERDICT)
   // 📖 Custom colorization for Stability: highlight 'B' (the sort key) since 'S' is taken by SWE
-  const stabH_c    = sortColumn === 'stability' ? themeColors.accentBold(stabH.padEnd(W_STAB)) : (() => {
-    const plain = 'Stability'
-    const padding = ' '.repeat(Math.max(0, W_STAB - plain.length))
-    return themeColors.dim('Sta') + themeColors.hotkey('B') + themeColors.dim('ility' + padding)
+  const stabH_c    = sortColumn === 'stability' ? themeColors.accentBold(stabH.padEnd(wStab)) : (() => {
+    const plain = stabLabel
+    const padding = ' '.repeat(Math.max(0, wStab - plain.length))
+    return themeColors.dim('Sta') + themeColors.hotkey('B') + themeColors.dim((isCompact ? '.' : 'ility') + padding)
   })()
   // 📖 Up% sorts on U, so keep the highlighted shortcut in the shared yellow sort-key color.
   const uptimeH_c  = sortColumn === 'uptime' ? themeColors.accentBold(uptimeH.padEnd(W_UPTIME)) : (() => {
@@ -266,10 +316,15 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const padding = ' '.repeat(Math.max(0, W_UPTIME - plain.length))
     return themeColors.hotkey('U') + themeColors.dim('p%' + padding)
   })()
-  const tokensH_c  = themeColors.dim(tokensH.padEnd(W_TOKENS))
   // 📖 Usage column removed from UI – no header or separator for it.
-  // Header without Usage column (column order: Rank, Tier, SWE%, CTX, Model, Provider, Latest Ping, Avg Ping, Health, Verdict, Stability, Up%, Used)
-  lines.push('  ' + rankH_c + COL_SEP + tierH_c + COL_SEP + sweH_c + COL_SEP + ctxH_c + COL_SEP + modelH_c + COL_SEP + originH_c + COL_SEP + pingH_c + COL_SEP + avgH_c + COL_SEP + healthH_c + COL_SEP + verdictH_c + COL_SEP + stabH_c + COL_SEP + uptimeH_c + COL_SEP + tokensH_c)
+  // 📖 Header row: conditionally include columns based on responsive visibility
+  const headerParts = []
+  if (showRank) headerParts.push(rankH_c)
+  if (showTier) headerParts.push(tierH_c)
+  headerParts.push(sweH_c, ctxH_c, modelH_c, originH_c, pingH_c, avgH_c, healthH_c, verdictH_c)
+  if (showStability) headerParts.push(stabH_c)
+  if (showUptime) headerParts.push(uptimeH_c)
+  lines.push('  ' + headerParts.join(COL_SEP))
 
 
 
@@ -311,9 +366,13 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const num = themeColors.dim(String(r.idx).padEnd(W_RANK))
     const tier = tierFn(r.tier.padEnd(W_TIER))
     // 📖 Keep terminal view provider-specific so each row is monitorable per provider
+    // 📖 In compact mode, truncate provider name to 4 chars + '…'
     const providerNameRaw = sources[r.providerKey]?.name ?? r.providerKey ?? 'NIM'
     const providerName = normalizeOriginLabel(providerNameRaw, r.providerKey)
-    const source = themeColors.provider(r.providerKey, providerName.padEnd(W_SOURCE))
+    const providerDisplay = isCompact && providerName.length > 5
+      ? providerName.slice(0, 4) + '…'
+      : providerName
+    const source = themeColors.provider(r.providerKey, providerDisplay.padEnd(wSource))
     // 📖 Favorites: always reserve 2 display columns at the start of Model column.
     // 📖 🎯 (2 cols) for recommended, ⭐ (2 cols) for favorites, '  ' (2 spaces) for non-favorites — keeps alignment stable.
     const favoritePrefix = r.isRecommended ? '🎯' : r.isFavorite ? '⭐' : '  '
@@ -345,7 +404,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     // 📖 Keep the row-local spinner small and inline so users can still read the last measured latency.
     const buildLatestPingDisplay = (value) => {
       const spinner = r.isPinging ? ` ${FRAMES[frame % FRAMES.length]}` : ''
-      return `${value}${spinner}`.padEnd(W_PING)
+      return `${value}${spinner}`.padEnd(wPing)
     }
 
     // 📖 Latest ping - pings are objects: { ms, code }
@@ -353,7 +412,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const latestPing = r.pings.length > 0 ? r.pings[r.pings.length - 1] : null
     let pingCell
     if (!latestPing) {
-      const placeholder = r.isPinging ? buildLatestPingDisplay('———') : '———'.padEnd(W_PING)
+      const placeholder = r.isPinging ? buildLatestPingDisplay('———') : '———'.padEnd(wPing)
       pingCell = themeColors.dim(placeholder)
     } else if (latestPing.code === '200') {
       // 📖 Success - show response time
@@ -364,7 +423,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       pingCell = themeColors.dim(buildLatestPingDisplay(String(latestPing.ms)))
     } else {
       // 📖 Error or timeout - show "———" (error code is already in Status column)
-      const placeholder = r.isPinging ? buildLatestPingDisplay('———') : '———'.padEnd(W_PING)
+      const placeholder = r.isPinging ? buildLatestPingDisplay('———') : '———'.padEnd(wPing)
       pingCell = themeColors.dim(placeholder)
     }
 
@@ -372,10 +431,10 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const avg = getAvg(r)
     let avgCell
     if (avg !== Infinity) {
-      const str = String(avg).padEnd(W_AVG)
+      const str = String(avg).padEnd(wAvg)
       avgCell = avg < 500 ? themeColors.metricGood(str) : avg < 1500 ? themeColors.metricWarn(str) : themeColors.metricBad(str)
     } else {
-      avgCell = themeColors.dim('———'.padEnd(W_AVG))
+      avgCell = themeColors.dim('———'.padEnd(wAvg))
     }
 
     // 📖 Status column - build plain text with emoji, pad, then colorize
@@ -423,7 +482,18 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       statusText = '?'
       statusColor = themeColors.dim
     }
-    const status = statusColor(padEndDisplay(statusText, W_STATUS))
+    // 📖 In compact mode, truncate health text after 6 visible chars + '…' to fit wStatus
+    const statusDisplayText = isCompact ? (() => {
+      // 📖 Strip emoji prefix to measure text length, then truncate if needed
+      const plainText = statusText.replace(/^[\p{Emoji_Presentation}\p{Extended_Pictographic}]\s*/u, '')
+      if (plainText.length > 6) {
+        const emojiMatch = statusText.match(/^([\p{Emoji_Presentation}\p{Extended_Pictographic}]\s*)/u)
+        const prefix = emojiMatch ? emojiMatch[1] : ''
+        return prefix + plainText.slice(0, 6) + '…'
+      }
+      return statusText
+    })() : statusText
+    const status = statusColor(padEndDisplay(statusDisplayText, wStatus))
 
     // 📖 Verdict column - use getVerdict() for stability-aware verdicts, then render with emoji
     const verdict = getVerdict(r)
@@ -479,15 +549,15 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const stabScore = getStabilityScore(r)
     let stabCell
     if (stabScore < 0) {
-      stabCell = themeColors.dim('———'.padEnd(W_STAB))
+      stabCell = themeColors.dim('———'.padEnd(wStab))
     } else if (stabScore >= 80) {
-      stabCell = themeColors.metricGood(String(stabScore).padEnd(W_STAB))
+      stabCell = themeColors.metricGood(String(stabScore).padEnd(wStab))
     } else if (stabScore >= 60) {
-      stabCell = themeColors.metricOk(String(stabScore).padEnd(W_STAB))
+      stabCell = themeColors.metricOk(String(stabScore).padEnd(wStab))
     } else if (stabScore >= 40) {
-      stabCell = themeColors.metricWarn(String(stabScore).padEnd(W_STAB))
+      stabCell = themeColors.metricWarn(String(stabScore).padEnd(wStab))
     } else {
-      stabCell = themeColors.metricBad(String(stabScore).padEnd(W_STAB))
+      stabCell = themeColors.metricBad(String(stabScore).padEnd(wStab))
     }
 
     // 📖 Uptime column - percentage of successful pings
@@ -508,22 +578,21 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     // 📖 Model text now mirrors the provider hue so provider affinity is visible
     // 📖 even before the eye reaches the Provider column.
     const nameCell = themeColors.provider(r.providerKey, name, { bold: isCursor })
-    const sourceCursorText = providerName.padEnd(W_SOURCE)
+    const sourceCursorText = providerDisplay.padEnd(wSource)
     const sourceCell = isCursor ? themeColors.provider(r.providerKey, sourceCursorText, { bold: true }) : source
 
     // 📖 Usage column removed from UI – no usage data displayed.
     // (We keep the logic but do not render it.)
     const usageCell = ''
 
-    // 📖 Used column — total historical prompt+completion tokens consumed for this
-    // 📖 exact provider/model pair, loaded from the local usage snapshot file at startup.
-    const tokenTotal = Number(r.totalTokens) || 0
-    const tokensCell = tokenTotal > 0
-      ? themeColors.metricOk(formatTokenTotalCompact(tokenTotal).padEnd(W_TOKENS))
-      : themeColors.dim('0'.padEnd(W_TOKENS))
-
-    // 📖 Build row with double space between columns (order: Rank, Tier, SWE%, CTX, Model, Provider, Latest Ping, Avg Ping, Health, Verdict, Stability, Up%, Used)
-    const row = '  ' + num + COL_SEP + tier + COL_SEP + sweCell + COL_SEP + ctxCell + COL_SEP + nameCell + COL_SEP + sourceCell + COL_SEP + pingCell + COL_SEP + avgCell + COL_SEP + status + COL_SEP + speedCell + COL_SEP + stabCell + COL_SEP + uptimeCell + COL_SEP + tokensCell
+    // 📖 Build row: conditionally include columns based on responsive visibility
+    const rowParts = []
+    if (showRank) rowParts.push(num)
+    if (showTier) rowParts.push(tier)
+    rowParts.push(sweCell, ctxCell, nameCell, sourceCell, pingCell, avgCell, status, speedCell)
+    if (showStability) rowParts.push(stabCell)
+    if (showUptime) rowParts.push(uptimeCell)
+    const row = '  ' + rowParts.join(COL_SEP)
 
     if (isCursor) {
       lines.push(themeColors.bgModelCursor(row))

package/src/testfcm.js

@@ -107,7 +107,7 @@ const TRANSCRIPT_FINDING_RULES = [
     title: 'PTY width warning blocked the TUI flow',
     severity: 'high',
     regex: /please maximize your terminal|terminal is too small|reduce font size or maximize width/i,
-    task: 'Run `/testfcm` with the width warning disabled in the isolated config or force a wider PTY before sending Enter.',
+    task: 'Run `/testfcm` with a wider PTY (at least 80 columns) before sending Enter.',
   },
   {
     id: 'tool_missing',

package/src/utils.js

@@ -464,7 +464,6 @@ export function parseArgs(argv) {
   const sortAscFlag = flags.includes('--asc')
   const hideUnconfigured = flags.includes('--hide-unconfigured')
   const showUnconfigured = flags.includes('--show-unconfigured')
-  const disableWidthsWarning = flags.includes('--disable-widths-warning')
 
   let tierFilter = tierValueIdx !== -1 ? args[tierValueIdx].toUpperCase() : null
   let sortColumn = sortValueIdx !== -1 ? args[sortValueIdx].toLowerCase() : null
@@ -501,7 +500,6 @@ export function parseArgs(argv) {
     pingInterval,
     hideUnconfigured,
     showUnconfigured,
-    disableWidthsWarning,
     premiumMode,
     // 📖 Profile system removed - API keys now persist permanently across all sessions
     recommendMode,