free-coding-models 0.3.25 → 0.3.28

package/src/key-handler.js

@@ -35,6 +35,8 @@ import { getLastLayout, COLUMN_SORT_MAP } from './render-table.js'
 import { cycleThemeSetting, detectActiveTheme } from './theme.js'
 import { buildCommandPaletteTree, flattenCommandTree, filterCommandPaletteEntries } from './command-palette.js'
 import { WIDTH_WARNING_MIN_COLS } from './constants.js'
+import { scanAllToolConfigs, softDeleteModel } from './installed-models-manager.js'
+import { startExternalTool } from './tool-launchers.js'
 
 // 📖 Some providers need an explicit probe model because the first catalog entry
 // 📖 is not guaranteed to be accepted by their chat endpoint.
@@ -687,6 +689,21 @@ export function createKeyHandler(ctx) {
     state.changelogSelectedVersion = null
   }
 
+  function openInstalledModelsOverlay() {
+    state.installedModelsOpen = true
+    state.installedModelsCursor = 0
+    state.installedModelsScrollOffset = 0
+    state.installedModelsErrorMsg = 'Scanning...'
+
+    try {
+      const results = scanAllToolConfigs()
+      state.installedModelsData = results
+      state.installedModelsErrorMsg = null
+    } catch (err) {
+      state.installedModelsErrorMsg = err.message || 'Failed to scan tool configs'
+    }
+  }
+
   function cycleToolMode() {
     const modeOrder = getToolModeOrder()
     const currentIndex = modeOrder.indexOf(state.mode)
@@ -774,6 +791,7 @@ export function createKeyHandler(ctx) {
     return state.settingsOpen
       || state.installEndpointsOpen
       || state.toolInstallPromptOpen
+      || state.installedModelsOpen
       || state.recommendOpen
       || state.feedbackOpen
       || state.helpVisible
@@ -825,6 +843,21 @@ export function createKeyHandler(ctx) {
       })
     }
 
+    // 📖 Inject a high-priority update entry at the top when a newer version is known.
+    const updateVersion = state.startupLatestVersion
+    if (updateVersion && state.versionAlertsEnabled) {
+      state.commandPaletteResults.unshift({
+        id: 'action-update-now',
+        label: `⬆️ UPDATE NOW — v${updateVersion} available (recommended!)`,
+        type: 'command',
+        depth: 0,
+        hasChildren: false,
+        isExpanded: false,
+        updateVersion,
+        keywords: ['update', 'upgrade', 'version', 'install'],
+      })
+    }
+
     if (state.commandPaletteCursor >= state.commandPaletteResults.length) {
       state.commandPaletteCursor = Math.max(0, state.commandPaletteResults.length - 1)
     }
@@ -851,6 +884,14 @@ export function createKeyHandler(ctx) {
   function executeCommandPaletteEntry(entry) {
     if (!entry?.id) return
 
+    // 📖 Update action: stop TUI cleanly and run the npm update + relaunch.
+    if (entry.id === 'action-update-now' && entry.updateVersion) {
+      closeCommandPalette()
+      stopUi({ resetRawMode: true })
+      runUpdate(entry.updateVersion)
+      return
+    }
+
     if (entry.id.startsWith('action-set-ping-') && entry.pingMode) {
       setPingMode(entry.pingMode, 'manual')
       return
@@ -943,6 +984,7 @@ export function createKeyHandler(ctx) {
       case 'open-feedback': return openFeedbackOverlay()
       case 'open-recommend': return openRecommendOverlay()
       case 'open-install-endpoints': return openInstallEndpointsOverlay()
+      case 'open-installed-models': return openInstalledModelsOverlay()
       case 'action-cycle-theme': return cycleGlobalTheme()
       case 'action-cycle-tool-mode': return cycleToolMode()
       case 'action-cycle-ping-mode': {
@@ -963,6 +1005,10 @@ export function createKeyHandler(ctx) {
     if (!key) return
     noteUserActivity()
 
+    // 📖 Ctrl+C: always exit immediately, checked FIRST to prevent any other key binding from swallowing it.
+    // 📖 Also handles the raw \x03 byte as a fallback for terminals where readline doesn't set key.ctrl properly.
+    if ((key.ctrl && key.name === 'c') || str === '\x03') { exit(0); return }
+
     // 📖 Ctrl+P toggles the command palette from the main table only.
     if (key.ctrl && key.name === 'p') {
       if (state.commandPaletteOpen) {
@@ -1289,6 +1335,104 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // ─── Installed Models overlay keyboard handling ───────────────────────────
+    if (state.installedModelsOpen) {
+      if (key.ctrl && key.name === 'c') { exit(0); return }
+
+      const scanResults = state.installedModelsData || []
+      let maxIndex = 0
+      for (const toolResult of scanResults) {
+        maxIndex += 1
+        maxIndex += toolResult.models.length
+      }
+      if (maxIndex > 0) maxIndex--
+
+      const pageStep = Math.max(1, (state.terminalRows || 1) - 4)
+
+      if (key.name === 'up' || (key.shift && key.name === 'tab')) {
+        state.installedModelsCursor = Math.max(0, state.installedModelsCursor - 1)
+        return
+      }
+      if (key.name === 'down' || key.name === 'tab') {
+        state.installedModelsCursor = Math.min(maxIndex, state.installedModelsCursor + 1)
+        return
+      }
+      if (key.name === 'pageup') {
+        state.installedModelsCursor = Math.max(0, state.installedModelsCursor - pageStep)
+        return
+      }
+      if (key.name === 'pagedown') {
+        state.installedModelsCursor = Math.min(maxIndex, state.installedModelsCursor + pageStep)
+        return
+      }
+      if (key.name === 'home') {
+        state.installedModelsCursor = 0
+        return
+      }
+      if (key.name === 'end') {
+        state.installedModelsCursor = maxIndex
+        return
+      }
+
+      if (key.name === 'escape') {
+        state.installedModelsOpen = false
+        state.installedModelsCursor = 0
+        return
+      }
+
+      if (key.name === 'return') {
+        let currentIdx = 0
+        for (const toolResult of scanResults) {
+          if (currentIdx === state.installedModelsCursor) {
+            return
+          }
+          currentIdx++
+          for (const model of toolResult.models) {
+            if (currentIdx === state.installedModelsCursor) {
+              const selectedModel = {
+                modelId: model.modelId,
+                providerKey: model.providerKey,
+                label: model.label,
+              }
+
+              state.installedModelsOpen = false
+              await startExternalTool(toolResult.toolMode, selectedModel, state.config)
+              return
+            }
+            currentIdx++
+          }
+        }
+      }
+
+      if (key.name === 'd') {
+        let currentIdx = 0
+        for (const toolResult of scanResults) {
+          currentIdx++
+          for (const model of toolResult.models) {
+            if (currentIdx === state.installedModelsCursor) {
+              softDeleteModel(toolResult.toolMode, model.modelId)
+                .then((result) => {
+                  if (result.success) {
+                    openInstalledModelsOverlay()
+                  } else {
+                    state.installedModelsErrorMsg = `Failed to disable: ${result.error}`
+                    setTimeout(() => { state.installedModelsErrorMsg = null }, 3000)
+                  }
+                })
+                .catch((err) => {
+                  state.installedModelsErrorMsg = `Failed to disable: ${err.message}`
+                  setTimeout(() => { state.installedModelsErrorMsg = null }, 3000)
+                })
+              return
+            }
+            currentIdx++
+          }
+        }
+      }
+
+      return
+    }
+
     // 📖 Incompatible fallback overlay: ↑↓ navigate across tool + model sections, Enter confirms, Esc cancels.
     // 📖 Cursor is a flat index: 0..N-1 = compatible tools, N..N+M-1 = similar models.
     if (state.incompatibleFallbackOpen) {
@@ -1438,12 +1582,12 @@ export function createKeyHandler(ctx) {
     // 📖 Help overlay: full keyboard navigation + key swallowing while overlay is open.
     if (state.helpVisible) {
       const pageStep = Math.max(1, (state.terminalRows || 1) - 2)
-      if (key.name === 'escape' || key.name === 'k') {
+      if (key.name === 'escape' || (key.ctrl && key.name === 'h')) {
         state.helpVisible = false
         return
       }
-      if (key.name === 'up') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - 1); return }
-      if (key.name === 'down') { state.helpScrollOffset += 1; return }
+      if (key.name === 'up' || key.name === 'k') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - 1); return }
+      if (key.name === 'down' || key.name === 'j') { state.helpScrollOffset += 1; return }
       if (key.name === 'pageup') { state.helpScrollOffset = Math.max(0, state.helpScrollOffset - pageStep); return }
       if (key.name === 'pagedown') { state.helpScrollOffset += pageStep; return }
       if (key.name === 'home') { state.helpScrollOffset = 0; return }
@@ -1983,6 +2127,13 @@ export function createKeyHandler(ctx) {
       return
     }
 
+    // 📖 Shift+U: trigger immediate update when a newer version is known.
+    if (key.name === 'u' && key.shift && state.startupLatestVersion && state.versionAlertsEnabled) {
+      stopUi({ resetRawMode: true })
+      runUpdate(state.startupLatestVersion)
+      return
+    }
+
     // 📖 Sorting keys: R=rank, O=origin, M=model, L=latest ping, A=avg ping, S=SWE-bench, C=context, H=health, V=verdict, B=stability, U=uptime, G=usage
     // 📖 T is reserved for tier filter cycling. Y toggles favorites display mode.
     // 📖 X clears the active custom text filter.
@@ -2052,8 +2203,8 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Help overlay key: K = toggle help overlay
-    if (key.name === 'k') {
+    // 📖 Help overlay key: Ctrl+H = toggle help overlay
+    if (key.ctrl && key.name === 'h') {
       state.helpVisible = !state.helpVisible
       if (state.helpVisible) state.helpScrollOffset = 0
       return
@@ -2077,8 +2228,8 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    if (key.name === 'up') {
-      // 📖 Main list wrap navigation: top -> bottom on Up.
+    if (key.name === 'up' || key.name === 'k') {
+      // 📖 Main list wrap navigation: top -> bottom on Up / K (vim-style).
       const count = state.visibleSorted.length
       if (count === 0) return
       state.cursor = state.cursor > 0 ? state.cursor - 1 : count - 1
@@ -2086,8 +2237,8 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    if (key.name === 'down') {
-      // 📖 Main list wrap navigation: bottom -> top on Down.
+    if (key.name === 'down' || key.name === 'j') {
+      // 📖 Main list wrap navigation: bottom -> top on Down / J (vim-style).
       const count = state.visibleSorted.length
       if (count === 0) return
       state.cursor = state.cursor < count - 1 ? state.cursor + 1 : 0
@@ -2095,11 +2246,6 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    if (key.name === 'c' && key.ctrl) { // Ctrl+C
-      exit(0)
-      return
-    }
-
     // 📖 Esc can dismiss the narrow-terminal warning immediately without quitting the app.
     if (key.name === 'escape' && state.terminalCols > 0 && state.terminalCols < WIDTH_WARNING_MIN_COLS) {
       state.widthWarningDismissed = true
@@ -2327,6 +2473,22 @@ export function createMouseEventHandler(ctx) {
         }
         return
       }
+      if (state.installedModelsOpen) {
+        const scanResults = state.installedModelsData || []
+        let maxIndex = 0
+        for (const toolResult of scanResults) {
+          maxIndex += 1
+          maxIndex += toolResult.models.length
+        }
+        if (maxIndex > 0) maxIndex--
+
+        if (evt.type === 'scroll-up') {
+          state.installedModelsCursor = Math.max(0, (state.installedModelsCursor || 0) - 1)
+        } else {
+          state.installedModelsCursor = Math.min(maxIndex, (state.installedModelsCursor || 0) + 1)
+        }
+        return
+      }
 
       // 📖 Main table scroll: move cursor up/down with wrap-around
       const count = state.visibleSorted.length
@@ -2402,6 +2564,11 @@ export function createMouseEventHandler(ctx) {
       return
     }
 
+    if (state.installedModelsOpen) {
+      state.installedModelsOpen = false
+      return
+    }
+
     if (state.incompatibleFallbackOpen) {
       // 📖 Incompatible fallback: click closes
       state.incompatibleFallbackOpen = false
@@ -2553,6 +2720,12 @@ export function createMouseEventHandler(ctx) {
     if (layout.footerHotkeys && layout.footerHotkeys.length > 0) {
       const zone = layout.footerHotkeys.find(z => y === z.row && x >= z.xStart && x <= z.xEnd)
       if (zone) {
+        // 📖 Update banner click: stop TUI and run the npm update + relaunch.
+        if (zone.key === 'update-click' && state.startupLatestVersion && state.versionAlertsEnabled) {
+          stopUi({ resetRawMode: true })
+          runUpdate(state.startupLatestVersion)
+          return
+        }
         // 📖 Map the footer zone key to a synthetic keypress.
         // 📖 Most are single-character keys; special cases like ctrl+p need special handling.
         if (zone.key === 'ctrl+p') {

package/src/overlays.js

@@ -479,6 +479,114 @@ export function createOverlayRenderers(state, deps) {
     return cleared.join('\n')
   }
 
+  // ─── Installed Models Manager overlay renderer ─────────────────────────────
+  // 📖 renderInstalledModels displays all models configured in external tools
+  // 📖 Shows tool configs, model lists, and provides actions (Launch, Disable, Reinstall)
+  function renderInstalledModels() {
+    const EL = '\x1b[K'
+    const lines = []
+    const cursorLineByRow = {}
+
+    lines.push('')
+    lines.push(`  ${themeColors.accent('🚀')} ${themeColors.accentBold('free-coding-models')} ${themeColors.dim(`v${LOCAL_VERSION}`)}`)
+    lines.push(`  ${themeColors.textBold('🗂️  Installed Models Manager')}`)
+    lines.push('')
+    lines.push(themeColors.dim('  — models configured in your tools'))
+
+    if (state.installedModelsErrorMsg) {
+      lines.push(`  ${themeColors.warning(state.installedModelsErrorMsg)}`)
+    }
+
+    if (state.installedModelsErrorMsg === 'Scanning...') {
+      lines.push(themeColors.dim('  Scanning tool configs, please wait...'))
+      const targetLine = 5
+      state.installedModelsScrollOffset = keepOverlayTargetVisible(
+        state.installedModelsScrollOffset,
+        targetLine,
+        lines.length,
+        state.terminalRows
+      )
+      const { visible, offset } = sliceOverlayLines(lines, state.installedModelsScrollOffset, state.terminalRows)
+      state.installedModelsScrollOffset = offset
+
+      overlayLayout.installedModelsCursorToLine = cursorLineByRow
+      overlayLayout.installedModelsScrollOffset = offset
+
+      const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
+      const cleared = tintedLines.map((l) => l + EL)
+      return cleared.join('\n')
+    }
+
+    lines.push('')
+
+    const scanResults = state.installedModelsData || []
+
+    if (scanResults.length === 0) {
+      lines.push(themeColors.dim('  No tool configs found.'))
+      lines.push(themeColors.dim('  Install a tool (Goose, Crush, Aider, etc.) to get started.'))
+    } else {
+      let globalIdx = 0
+
+      for (const toolResult of scanResults) {
+        const { toolMode, toolLabel, toolEmoji, configPath, isValid, hasManagedMarker, models } = toolResult
+
+        lines.push('')
+        const isCursor = globalIdx === state.installedModelsCursor
+
+        const statusIcon = isValid ? themeColors.successBold('✅') : themeColors.errorBold('⚠️')
+        const toolHeader = `${bullet(isCursor)}${toolEmoji} ${themeColors.textBold(toolLabel)} ${statusIcon}`
+        cursorLineByRow[globalIdx++] = lines.length
+        lines.push(isCursor ? themeColors.bgCursor(toolHeader) : toolHeader)
+
+        const configShortPath = configPath.replace(process.env.HOME || homedir(), '~')
+        lines.push(`     ${themeColors.dim(configShortPath)}`)
+
+        if (!isValid) {
+          lines.push(themeColors.dim('     ⚠️  Config invalid or missing'))
+        } else if (models.length === 0) {
+          lines.push(themeColors.dim('     No models configured'))
+        } else {
+          const managedBadge = hasManagedMarker ? themeColors.info('• Managed by FCM') : themeColors.dim('• External config')
+          lines.push(`     ${themeColors.success(`${models.length} model${models.length > 1 ? 's' : ''} configured`)}  ${managedBadge}`)
+
+          for (const model of models) {
+            const isModelCursor = globalIdx === state.installedModelsCursor
+            const tierBadge = model.tier !== '-' ? themeColors.info(model.tier.padEnd(2)) : themeColors.dim('  ')
+            const externalBadge = model.isExternal ? themeColors.dim('[external]') : ''
+
+            const modelRow = `     • ${model.label} ${tierBadge} ${externalBadge}`
+            cursorLineByRow[globalIdx++] = lines.length
+            lines.push(isModelCursor ? themeColors.bgCursor(modelRow) : modelRow)
+
+            if (isModelCursor) {
+              lines.push(`        ${themeColors.dim('[Enter] Launch  [D] Disable')}`)
+            }
+          }
+        }
+      }
+    }
+
+    lines.push('')
+    lines.push(themeColors.dim('  ↑↓ Navigate  Enter=Launch  D=Disable  Esc=Close'))
+
+    const targetLine = cursorLineByRow[state.installedModelsCursor] ?? 0
+    state.installedModelsScrollOffset = keepOverlayTargetVisible(
+      state.installedModelsScrollOffset,
+      targetLine,
+      lines.length,
+      state.terminalRows
+    )
+    const { visible, offset } = sliceOverlayLines(lines, state.installedModelsScrollOffset, state.terminalRows)
+    state.installedModelsScrollOffset = offset
+
+    overlayLayout.installedModelsCursorToLine = cursorLineByRow
+    overlayLayout.installedModelsScrollOffset = offset
+
+    const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
+    const cleared = tintedLines.map((l) => l + EL)
+    return cleared.join('\n')
+  }
+
   // ─── Missing-tool install confirmation overlay ────────────────────────────
   // 📖 renderToolInstallPrompt keeps the user inside the TUI long enough to
   // 📖 confirm the auto-install, then the key handler exits the alt screen and
@@ -796,7 +904,7 @@ export function createOverlayRenderers(state, deps) {
     lines.push('')
     lines.push(`  ${heading('Main TUI')}`)
     lines.push(`  ${heading('Navigation')}`)
-    lines.push(`  ${key('↑↓')}           Navigate rows`)
+    lines.push(`  ${key('↑↓ / J/K')}     Navigate rows  ${hint('(J/K = vim-style scroll)')}`)
     lines.push(`  ${key('Enter')}        Select model and launch`)
     lines.push(`              ${hint('If the active CLI is missing, FCM offers a one-click install prompt first.')}`)
     lines.push('')
@@ -815,7 +923,7 @@ export function createOverlayRenderers(state, deps) {
       // 📖 Profile system removed - API keys now persist permanently across all sessions
     lines.push(`  ${key('Shift+R')}  Reset view settings  ${hint('(tier filter, sort, provider filter → defaults)')}`)
     lines.push(`  ${key('N')}  Changelog  ${hint('(📋 browse all versions, Enter to view details)')}`)
-    lines.push(`  ${key('K')} / ${key('Esc')}  Show/hide this help`)
+    lines.push(`  ${key('Ctrl+H')} / ${key('Esc')}  Show/hide this help`)
     lines.push(`  ${key('Ctrl+C')}  Exit`)
     lines.push('')
     lines.push(`  ${heading('Settings (P)')}`)
@@ -1381,6 +1489,7 @@ export function createOverlayRenderers(state, deps) {
     renderRecommend,
     renderFeedback,
     renderChangelog,
+    renderInstalledModels,
     renderIncompatibleFallback,
     startRecommendAnalysis,
     stopRecommendAnalysis,

package/src/render-table.js

@@ -52,6 +52,7 @@ import { usagePlaceholderForProvider } from './ping.js'
 import { calculateViewport, sortResultsWithPinnedFavorites, padEndDisplay, displayWidth } from './render-helpers.js'
 import { getToolMeta, TOOL_METADATA, TOOL_MODE_ORDER, isModelCompatibleWithTool } from './tool-metadata.js'
 import { getColumnSpacing } from './ui-config.js'
+import { detectPackageManager, getManualInstallCmd } from './updater.js'
 
 const require = createRequire(import.meta.url)
 const { version: LOCAL_VERSION } = require('../package.json')
@@ -71,6 +72,7 @@ let _lastLayout = {
   hasAboveIndicator: false, // 📖 whether "... N more above ..." is shown
   hasBelowIndicator: false, // 📖 whether "... N more below ..." is shown
   footerHotkeys: [],  // 📖 Array of { key, row, xStart, xEnd } for footer click zones
+  updateBannerRow: 0, // 📖 1-based terminal row of the fluorescent update banner (0 = none)
 }
 export function getLastLayout() { return _lastLayout }
 
@@ -102,7 +104,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, favoritesPinnedAndSticky = false, customTextFilter = null) {
+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, favoritesPinnedAndSticky = false, customTextFilter = null, lastReleaseDate = null) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -741,7 +743,9 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       { text: '  •  ', key: null },
       { text: 'P Settings', key: 'p' },
       { text: '  •  ', key: null },
-      { text: 'K Help', key: 'k' },
+      { text: 'J/K Navigate', key: null },
+      { text: '  •  ', key: null },
+      { text: 'Ctrl+H Help', key: 'ctrl+h' },
     ]
     const footerRow1 = lines.length + 1 // 📖 1-based terminal row (line hasn't been pushed yet)
     let xPos = 1
@@ -769,7 +773,9 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     themeColors.dim(`  •  `) +
     hotkey('P', ' Settings') +
     themeColors.dim(`  •  `) +
-    hotkey('K', ' Help')
+    themeColors.dim('J/K Navigate') +
+    themeColors.dim(`  •  `) +
+    themeColors.dim('Ctrl+H Help')
   )
 
   // 📖 Line 2: command palette, recommend, feedback, theme
@@ -803,7 +809,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     hotkey('G', ' Theme') + themeColors.dim(`  •  `) +
     hotkey('I', ' Feedback, bugs & requests')
   )
-  // 📖 Proxy status is now shown via the J badge in line 2 above — no need for a dedicated line
+  // 📖 Proxy status is now shown via the badge in line 2 above — no need for a dedicated line
   const footerLine =
     themeColors.footerLove('  Made with 💖 & ☕ by \x1b]8;;https://github.com/vava-nessa\x1b\\vava-nessa\x1b]8;;\x1b\\') +
     themeColors.dim('  •  ') +
@@ -823,12 +829,17 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   lines.push(footerLine)
 
   if (versionStatus.isOutdated) {
-    const outdatedMessage = `  ⚠ Update available: v${LOCAL_VERSION} -> v${versionStatus.latestVersion}. If auto-update did not complete, run: npm install -g free-coding-models@latest`
+    const updateMsg = `  🚀⬆️ UPDATE AVAILABLE — v${LOCAL_VERSION} → v${versionStatus.latestVersion}  •  Click here or press Shift+U to update  🚀⬆️  `
     const paddedBanner = terminalCols > 0
-      ? outdatedMessage + ' '.repeat(Math.max(0, terminalCols - displayWidth(outdatedMessage)))
-      : outdatedMessage
-    // 📖 Reserve a dedicated full-width red row so the warning cannot blend into the footer links.
-    lines.push(chalk.bgRed.white.bold(paddedBanner))
+      ? updateMsg + ' '.repeat(Math.max(0, terminalCols - displayWidth(updateMsg)))
+      : updateMsg
+    const fluoGreenBanner = chalk.bgRgb(57, 255, 20).rgb(0, 0, 0).bold(paddedBanner)
+    const updateBannerRow = lines.length + 1
+    _lastLayout.updateBannerRow = updateBannerRow
+    footerHotkeys.push({ key: 'update-click', row: updateBannerRow, xStart: 1, xEnd: Math.max(terminalCols, displayWidth(updateMsg)) })
+    lines.push(fluoGreenBanner)
+  } else {
+    _lastLayout.updateBannerRow = 0
   }
 
   // 📖 Final footer line: changelog + optional active text-filter badge + exit hint.
@@ -872,13 +883,18 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
 
   _lastLayout.footerHotkeys = footerHotkeys
 
+  const releaseLabel = lastReleaseDate
+    ? chalk.rgb(255, 182, 193)(`Last release: ${lastReleaseDate}`)
+    : ''
+
   lines.push(
     '  ' + themeColors.hotkey('N') + themeColors.dim(' Changelog') +
     (filterBadge
       ? themeColors.dim('  •  ') + filterBadge
       : '') +
     themeColors.dim('  •  ') +
-    themeColors.dim('Ctrl+C Exit')
+    themeColors.dim('Ctrl+C Exit') +
+    (releaseLabel ? themeColors.dim('  •  ') + releaseLabel : '')
   )
 
   // 📖 Append \x1b[K (erase to EOL) to each line so leftover chars from previous