free-coding-models 0.3.51 → 0.3.54

package/src/opencode.js

@@ -543,6 +543,62 @@ export async function startOpenCode(model, fcmConfig) {
   await spawnOpenCode(['--model', modelRef], providerKey, fcmConfig)
 }
 
+// ─── Start OpenCode Web ───────────────────────────────────────────────────────
+
+export async function startOpenCodeWeb(model, fcmConfig) {
+  const providerKey = model.providerKey ?? 'nvidia'
+  const ocModelId = getOpenCodeModelId(providerKey, model.modelId)
+  const modelRef = `${providerKey}/${ocModelId}`
+
+  console.log(chalk.green(`  Setting ${chalk.bold(model.label)} as default...`))
+  console.log(chalk.dim(`  Model: ${modelRef}`))
+  console.log()
+
+  const config = loadOpenCodeConfig()
+  const backupPath = `${getOpenCodeConfigPath()}.backup-${Date.now()}`
+
+  if (existsSync(getOpenCodeConfigPath())) {
+    copyFileSync(getOpenCodeConfigPath(), backupPath)
+    console.log(chalk.dim(`  Backup: ${backupPath}`))
+  }
+
+  if (!config.provider) config.provider = {}
+  
+  // 📖 Provider-specific config setup (same as CLI/Desktop)
+  if (providerKey === 'nvidia' && !config.provider.nvidia) {
+    config.provider.nvidia = {
+      npm: '@ai-sdk/openai-compatible',
+      name: 'NVIDIA NIM',
+      options: { baseURL: 'https://integrate.api.nvidia.com/v1', apiKey: '{env:NVIDIA_API_KEY}' },
+      models: {}
+    }
+  } else if (providerKey === 'groq' && !config.provider.groq) {
+    config.provider.groq = { options: { apiKey: '{env:GROQ_API_KEY}' }, models: {} }
+  } else if (providerKey === 'cerebras' && !config.provider.cerebras) {
+    config.provider.cerebras = {
+      npm: '@ai-sdk/openai-compatible',
+      name: 'Cerebras',
+      options: { baseURL: 'https://api.cerebras.ai/v1', apiKey: '{env:CEREBRAS_API_KEY}' },
+      models: {}
+    }
+  }
+  // ... other providers are handled as they are selected
+  
+  if (providerKey !== 'opencode-zen' && config.provider[providerKey]) {
+    if (!config.provider[providerKey].models) config.provider[providerKey].models = {}
+    config.provider[providerKey].models[ocModelId] = { name: model.label }
+  }
+
+  config.model = providerKey === 'opencode-zen' ? `opencode/${ocModelId}` : modelRef
+  saveOpenCodeConfig(config)
+
+  console.log(chalk.dim(`  Config saved to: ${getOpenCodeConfigPath()}`))
+  console.log(chalk.dim('  Starting OpenCode Web...'))
+  console.log()
+
+  await spawnOpenCode(['web', '--model', modelRef], providerKey, fcmConfig)
+}
+
 // ─── Start OpenCode Desktop ───────────────────────────────────────────────────
 
 export async function startOpenCodeDesktop(model, fcmConfig) {

package/src/render-table.js

@@ -48,6 +48,7 @@ import {
 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 { VERDICT_CYCLE } from './constants.js'
 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'
@@ -57,6 +58,10 @@ import { detectPackageManager, getManualInstallCmd } from './updater.js'
 const require = createRequire(import.meta.url)
 const { version: LOCAL_VERSION } = require('../package.json')
 
+// 📖 HEALTH_CYCLE: cycles through health/status states (local constant for render-table.js)
+// VERDICT_CYCLE is now imported from constants.js
+const HEALTH_CYCLE = [null, 'up', 'timeout', 'down', 'auth_error', 'noauth', 'pending']
+
 // 📖 Mouse support: column boundary map updated every frame by renderTable().
 // 📖 Each entry maps a column name to its display X-start and X-end (1-based, inclusive).
 // 📖 headerRow is the 1-based terminal row of the column header line.
@@ -104,7 +109,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, lastReleaseDate = null, footerHidden = 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, favoritesPinnedAndSticky = false, customTextFilter = null, lastReleaseDate = null, footerHidden = false, verdictFilterMode = 0, healthFilterMode = 0) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -321,6 +326,77 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     '',
   ]
 
+  // 📖 Filter bar — llmfit-style horizontal filter pills (1 dedicated row above table)
+  // 📖 Each block: title with hotkey hint + active value colored by filter state
+  {
+    const filterParts = []
+    const filterSep = themeColors.dim(' │ ')
+    const blockSep = ' │ '
+
+    // 📖 Search filter block — shows active text filter or prompt
+    if (customTextFilter && customTextFilter.trim()) {
+      const badgeText = ` Search "/" ${blockSep} ${customTextFilter.trim().slice(0, 20)} `
+      filterParts.push(themeColors.badge(badgeText, [52, 120, 88], [255, 255, 255]))
+    } else {
+      filterParts.push(themeColors.dim(' Search "/" '))
+    }
+
+    // 📖 Tier filter block — T key cycles through TIER_CYCLE
+    if (tierFilterMode > 0) {
+      const tierLabel = TIER_CYCLE_NAMES[tierFilterMode]
+      const tierBg = getTierRgb(tierLabel)
+      filterParts.push(themeColors.badge(` Tier (${tierLabel}) `, tierBg, [255, 255, 255]))
+    } else {
+      filterParts.push(themeColors.dim(' Tier (T) '))
+    }
+
+    // 📖 Provider filter block — D key cycles through providers
+    if (originFilterMode > 0) {
+      const originKeys = [null, ...Object.keys(sources)]
+      const activeOriginKey = originKeys[originFilterMode]
+      const activeOriginName = activeOriginKey ? sources[activeOriginKey]?.name ?? activeOriginKey : null
+      if (activeOriginName) {
+        const normName = normalizeOriginLabel(activeOriginName, activeOriginKey)
+        const providerRgb = PROVIDER_COLOR[activeOriginKey] || [255, 255, 255]
+        filterParts.push(themeColors.badge(` Provider (${normName}) `, providerRgb, [255, 255, 255]))
+      }
+    } else {
+      filterParts.push(themeColors.dim(' Provider (D) '))
+    }
+
+    // 📖 Verdict filter block — V key cycles through verdicts
+    if (verdictFilterMode > 0) {
+      const verdictLabel = VERDICT_CYCLE[verdictFilterMode]
+      const verdictColors = {
+        'Perfect': themeColors.success,
+        'Normal': themeColors.metricGood,
+        'Slow': (t) => chalk.bold.rgb(...getTierRgb('A-'))(t),
+        'Spiky': (t) => chalk.bold.rgb(...getTierRgb('A+'))(t),
+        'Very Slow': (t) => chalk.bold.rgb(...getTierRgb('B+'))(t),
+        'Overloaded': (t) => chalk.bold.rgb(...getTierRgb('B'))(t),
+        'Unstable': themeColors.errorBold,
+        'Not Active': themeColors.dim,
+        'Pending': themeColors.dim,
+      }
+      const vc = verdictColors[verdictLabel] || themeColors.accent
+      filterParts.push(themeColors.badge(` Verdict (${verdictLabel}) `, [20, 20, 20], vc === themeColors.dim ? [130, 130, 130] : [255, 255, 255]))
+    } else {
+      filterParts.push(themeColors.dim(' Verdict (V) '))
+    }
+
+    // 📖 Health filter block — H key cycles through health states
+    if (healthFilterMode > 0) {
+      const healthLabel = HEALTH_CYCLE[healthFilterMode]
+      const healthDisplay = healthLabel === 'auth_error' ? 'Auth Err' : healthLabel === 'noauth' ? 'No Key' : healthLabel.charAt(0).toUpperCase() + healthLabel.slice(1)
+      const healthBg = healthLabel === 'up' ? [52, 120, 88] : healthLabel === 'timeout' ? [180, 130, 0] : healthLabel === 'down' ? [120, 40, 40] : [60, 60, 60]
+      filterParts.push(themeColors.badge(` Health (${healthDisplay}) `, healthBg, [255, 255, 255]))
+    } else {
+      filterParts.push(themeColors.dim(' Health (H) '))
+    }
+
+    lines.push(filterParts.join(blockSep))
+  }
+
   // 📖 Header row with sorting indicators
   // 📖 NOTE: padEnd on chalk strings counts ANSI codes, breaking alignment
   // 📖 Solution: build plain text first, then colorize
@@ -756,135 +832,128 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     }
   }
 
-  lines.push(
-    '  ' + hotkey('F', ' Toggle Favorite') +
-    themeColors.dim(`  •  `) +
-    activeHotkey('Y', favoritesModeLabel, favoritesModeBg) +
-    themeColors.dim(`  •  `) +
-    (tierFilterMode > 0
-      ? activeHotkey('T', ` Tier (${activeTierLabel})`, getTierRgb(activeTierLabel))
-      : hotkey('T', ' Tier')) +
-    themeColors.dim(`  •  `) +
-    (originFilterMode > 0
-      ? activeHotkey('D', ` Provider (${activeOriginLabel})`, PROVIDER_COLOR[[null, ...Object.keys(sources)][originFilterMode]] || [255, 255, 255])
-      : hotkey('D', ' Provider')) +
-    themeColors.dim(`  •  `) +
-    (hideUnconfiguredModels ? activeHotkey('E', ' Show only configured models', configuredBadgeBg) : hotkey('E', ' Show only configured models')) +
-    themeColors.dim(`  •  `) +
-    hotkey('P', ' Settings') +
-    themeColors.dim(`  •  `) +
-    themeColors.dim('J/K Navigate') +
-    themeColors.dim(`  •  `) +
-    themeColors.dim('Ctrl+H Help')
-  )
-
-  // 📖 Line 2: command palette, recommend, feedback, theme
-  {
-    const cpText = ' CTRL+P ⚡️ Command Palette '
-    const parts = [
-      { text: '  ', key: null },
-      { text: cpText, key: 'ctrl+p' },
-      { text: '  •  ', key: null },
-      { text: 'Q Smart Recommend', key: 'q' },
-      { text: '  •  ', key: null },
-      { text: 'G Theme', key: 'g' },
-      { text: '  •  ', key: null },
-      { text: 'I Feedback, bugs & requests', key: 'i' },
-    ]
-    const footerRow2 = lines.length + 1
-    let xPos = 1
-    for (const part of parts) {
-      const w = displayWidth(part.text)
-      if (part.key) footerHotkeys.push({ key: part.key, row: footerRow2, xStart: xPos, xEnd: xPos + w - 1 })
-      xPos += w
-    }
-  }
+  if (!footerHidden) {
+    // 📖 Full footer — all hint lines hidden when footerHidden=true to maximize table space
+    lines.push(
+      '  ' + hotkey('F', ' Toggle Favorite') +
+      themeColors.dim(`  •  `) +
+      activeHotkey('Y', favoritesModeLabel, favoritesModeBg) +
+      themeColors.dim(`  •  `) +
+      (tierFilterMode > 0
+        ? activeHotkey('T', ` Tier (${activeTierLabel})`, getTierRgb(activeTierLabel))
+        : hotkey('T', ' Tier')) +
+      themeColors.dim(`  •  `) +
+      (originFilterMode > 0
+        ? activeHotkey('D', ` Provider (${activeOriginLabel})`, PROVIDER_COLOR[[null, ...Object.keys(sources)][originFilterMode]] || [255, 255, 255])
+        : hotkey('D', ' Provider')) +
+      themeColors.dim(`  •  `) +
+      (hideUnconfiguredModels ? activeHotkey('E', ' Show only configured models', configuredBadgeBg) : hotkey('E', ' Show only configured models')) +
+      themeColors.dim(`  •  `) +
+      hotkey('P', ' Settings') +
+      themeColors.dim(`  •  `) +
+      themeColors.dim('J/K Navigate') +
+      themeColors.dim(`  •  `) +
+      themeColors.dim('Ctrl+H Help')
+    )
 
-  // 📖 Line 2: command palette (highlighted as new), recommend, feedback, and extended hints.
-  // 📖 CTRL+P ⚡️ Command Palette uses neon-green-on-dark-green background to highlight the feature.
-  const paletteLabel = chalk.bgRgb(0, 60, 0).rgb(57, 255, 20).bold(' CTRL+P ⚡️ Command Palette ')
-  lines.push(
-    '  ' + paletteLabel + themeColors.dim(`  •  `) +
-    hotkey('Q', ' Smart Recommend') + themeColors.dim(`  •  `) +
-    hotkey('G', ' Theme') + themeColors.dim(`  •  `) +
-    hotkey('I', ' Feedback, bugs & requests')
-  )
-  // 📖 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('  •  ') +
-    '⭐ ' +
-    themeColors.link('\x1b]8;;https://github.com/vava-nessa/free-coding-models\x1b\\Star on GitHub\x1b]8;;\x1b\\') +
-    themeColors.dim('  •  ') +
-    '🤝 ' +
-    themeColors.warning('\x1b]8;;https://github.com/vava-nessa/free-coding-models/graphs/contributors\x1b\\Contributors\x1b]8;;\x1b\\') +
-    themeColors.dim('  •  ') +
-    '☕ ' +
-    themeColors.footerCoffee('\x1b]8;;https://buymeacoffee.com/vavanessadev\x1b\\Buy me a coffee\x1b]8;;\x1b\\')
-  lines.push(footerLine)
-
-  if (versionStatus.isOutdated) {
-    const updateMsg = `  🚀⬆️ UPDATE AVAILABLE — v${LOCAL_VERSION} → v${versionStatus.latestVersion}  •  Click here or press Shift+U to update  🚀⬆️  `
-    const paddedBanner = terminalCols > 0
-      ? 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
-  }
+    // 📖 Line 2: command palette, recommend, feedback, theme
+    {
+      const cpText = ' CTRL+P ⚡️ Command Palette '
+      const parts = [
+        { text: '  ', key: null },
+        { text: cpText, key: 'ctrl+p' },
+        { text: '  •  ', key: null },
+        { text: 'Q Smart Recommend', key: 'q' },
+        { text: '  •  ', key: null },
+        { text: 'G Theme', key: 'g' },
+        { text: '  •  ', key: null },
+        { text: 'I Feedback, bugs & requests', key: 'i' },
+      ]
+      const footerRow2 = lines.length + 1
+      let xPos = 1
+      for (const part of parts) {
+        const w = displayWidth(part.text)
+        if (part.key) footerHotkeys.push({ key: part.key, row: footerRow2, xStart: xPos, xEnd: xPos + w - 1 })
+        xPos += w
+      }
+    }
 
-  // 📖 Final footer line: changelog + optional active text-filter badge + exit hint.
-  let filterBadge = ''
-  if (hasCustomFilter) {
-    const normalizedFilter = customTextFilter.trim().replace(/\s+/g, ' ')
-    const filterPrefix = 'X Disable filter: "'
-    const filterSuffix = '"'
-    const separatorPlain = '  •  '
-    const baseFooterPlain = '  N Changelog' + separatorPlain + 'Ctrl+C Exit'
-    const baseBadgeWidth = displayWidth(` ${filterPrefix}${filterSuffix} `)
-    const availableFilterWidth = terminalCols > 0
-      ? Math.max(8, terminalCols - displayWidth(baseFooterPlain) - displayWidth(separatorPlain) - baseBadgeWidth)
-      : normalizedFilter.length
-    const visibleFilter = normalizedFilter.length > availableFilterWidth
-      ? `${normalizedFilter.slice(0, Math.max(3, availableFilterWidth - 3))}...`
-      : normalizedFilter
-    filterBadge = chalk.bgYellow.black.bold(` ${filterPrefix}${visibleFilter}${filterSuffix} `)
-  }
+    // 📖 Line 2: command palette (highlighted as new), recommend, feedback, and extended hints.
+    // 📖 CTRL+P ⚡️ Command Palette uses neon-green-on-dark-green background to highlight the feature.
+    const paletteLabel = chalk.bgRgb(0, 60, 0).rgb(57, 255, 20).bold(' CTRL+P ⚡️ Command Palette ')
+    lines.push(
+      '  ' + paletteLabel + themeColors.dim(`  •  `) +
+      hotkey('Q', ' Smart Recommend') + themeColors.dim(`  •  `) +
+      hotkey('G', ' Theme') + themeColors.dim(`  •  `) +
+      hotkey('I', ' Feedback, bugs & requests')
+    )
+    // 📖 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('  •  ') +
+      '⭐ ' +
+      themeColors.link('\x1b]8;;https://github.com/vava-nessa/free-coding-models\x1b\\Star on GitHub\x1b]8;;\x1b\\') +
+      themeColors.dim('  •  ') +
+      '🤝 ' +
+      themeColors.warning('\x1b]8;;https://github.com/vava-nessa/free-coding-models/graphs/contributors\x1b\\Contributors\x1b]8;;\x1b\\') +
+      themeColors.dim('  •  ') +
+      '☕ ' +
+      themeColors.footerCoffee('\x1b]8;;https://buymeacoffee.com/vavanessadev\x1b\\Buy me a coffee\x1b]8;;\x1b\\')
+    lines.push(footerLine)
+
+    if (versionStatus.isOutdated) {
+      const updateMsg = `  🚀⬆️ UPDATE AVAILABLE — v${LOCAL_VERSION} → v${versionStatus.latestVersion}  •  Click here or press Shift+U to update  🚀⬆️  `
+      const paddedBanner = terminalCols > 0
+        ? 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
+    }
 
-  // 📖 Mouse support: track last footer line hotkey zones
-  {
-    const lastFooterRow = lines.length + 1 // 📖 1-based terminal row (line about to be pushed)
-    const parts = [
-      { text: '  ', key: null },
-      { text: 'N Changelog', key: 'n' },
-    ]
+    // 📖 Final footer line: changelog + optional active text-filter badge + exit hint.
+    let filterBadge = ''
     if (hasCustomFilter) {
-      parts.push({ text: '  •  ', key: null })
-      // 📖 X key clears filter — compute width from rendered badge text
-      const badgePlain = `X Disable filter: "${customTextFilter.trim().replace(/\s+/g, ' ')}"`
-      parts.push({ text: ` ${badgePlain} `, key: 'x' })
-    }
-    let xPos = 1
-    for (const part of parts) {
-      const w = displayWidth(part.text)
-      if (part.key) footerHotkeys.push({ key: part.key, row: lastFooterRow, xStart: xPos, xEnd: xPos + w - 1 })
-      xPos += w
+      const normalizedFilter = customTextFilter.trim().replace(/\s+/g, ' ')
+      const filterPrefix = 'X Disable filter: "'
+      const filterSuffix = '"'
+      const separatorPlain = '  •  '
+      const baseFooterPlain = '  N Changelog' + separatorPlain + 'Ctrl+C Exit'
+      const baseBadgeWidth = displayWidth(` ${filterPrefix}${filterSuffix} `)
+      const availableFilterWidth = terminalCols > 0
+        ? Math.max(8, terminalCols - displayWidth(baseFooterPlain) - displayWidth(separatorPlain) - baseBadgeWidth)
+        : normalizedFilter.length
+      const visibleFilter = normalizedFilter.length > availableFilterWidth
+        ? `${normalizedFilter.slice(0, Math.max(3, availableFilterWidth - 3))}...`
+        : normalizedFilter
+      filterBadge = chalk.bgYellow.black.bold(` ${filterPrefix}${visibleFilter}${filterSuffix} `)
     }
-  }
 
-  _lastLayout.footerHotkeys = footerHotkeys
+    // 📖 Mouse support: track last footer line hotkey zones
+    {
+      const lastFooterRow = lines.length + 1 // 📖 1-based terminal row (line about to be pushed)
+      const parts = [
+        { text: '  ', key: null },
+        { text: 'N Changelog', key: 'n' },
+      ]
+      if (hasCustomFilter) {
+        parts.push({ text: '  •  ', key: null })
+        // 📖 X key clears filter — compute width from rendered badge text
+        const badgePlain = `X Disable filter: "${customTextFilter.trim().replace(/\s+/g, ' ')}"`
+        parts.push({ text: ` ${badgePlain} `, key: 'x' })
+      }
+      let xPos = 1
+      for (const part of parts) {
+        const w = displayWidth(part.text)
+        if (part.key) footerHotkeys.push({ key: part.key, row: lastFooterRow, xStart: xPos, xEnd: xPos + w - 1 })
+        xPos += w
+      }
+    }
 
-  if (footerHidden) {
-    // 📖 Collapsed footer: single line with toggle hint
-    lines.push(
-      '  ' + themeColors.hotkey('Ctrl+O') + themeColors.dim(' Toggle Footer') +
-      themeColors.dim('  •  Ctrl+C Exit')
-    )
-  } else {
     const releaseLabel = lastReleaseDate
       ? chalk.rgb(255, 182, 193)(`Last release: ${lastReleaseDate}`)
       : ''
@@ -906,14 +975,27 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       themeColors.dim(' → ') +
       themeColors.footerDiscord('https://discord.gg/ZTNFHvvCkU')
     )
+  } else {
+    // 📖 Collapsed footer: single line with toggle hint
+    lines.push(
+      '  ' + themeColors.hotkey('Ctrl+O') + themeColors.dim(' Toggle Footer') +
+      themeColors.dim('  •  Ctrl+C Exit')
+    )
   }
 
+  _lastLayout.footerHotkeys = footerHotkeys
+
   // 📖 Append \x1b[K (erase to EOL) to each line so leftover chars from previous
-  // 📖 frames are cleared. Then pad with blank cleared lines to fill the terminal,
-  // 📖 preventing stale content from lingering at the bottom after resize.
+  // 📖 frames are cleared. \x1b[J (erase from cursor to end of screen) clears any
+  // 📖 stale content below when footer is hidden.
   const EL = '\x1b[K'
   const cleared = lines.map(l => l + EL)
-  const remaining = terminalRows > 0 ? Math.max(0, terminalRows - cleared.length) : 0
-  for (let i = 0; i < remaining; i++) cleared.push(EL)
+  if (footerHidden) {
+    // 📖 When footer is hidden, \x1b[J erases stale footer content below the cursor
+    cleared.push('\x1b[J')
+  } else {
+    const remaining = terminalRows > 0 ? Math.max(0, terminalRows - cleared.length) : 0
+    for (let i = 0; i < remaining; i++) cleared.push(EL)
+  }
   return cleared.join('\n')
 }

package/src/shell-env.js

@@ -41,6 +41,7 @@ import { join } from 'node:path'
 import * as readline from 'node:readline'
 import chalk from 'chalk'
 import { ENV_VAR_NAMES } from './provider-metadata.js'
+import { saveConfig } from './config.js'
 
 // 📖 Unique marker used to identify the source line we inject into shell rc files.
 // 📖 This allows idempotent add/remove without relying on exact path matching.
@@ -361,6 +362,8 @@ export async function promptShellEnvMigration(config) {
     render()
 
     readline.emitKeypressEvents(process.stdin)
+    // 📖 Ensure stdin is flowing — a prior prompt may have paused it
+    process.stdin.resume()
     if (process.stdin.isTTY) process.stdin.setRawMode(true)
 
     const onKey = (_str, key) => {

package/src/tool-bootstrap.js

@@ -173,6 +173,16 @@ export const TOOL_BOOTSTRAP_METADATA = {
       },
     },
   },
+  kilo: {
+    binary: 'kilo',
+    docsUrl: 'https://kilo.ai/docs/cli',
+    install: {
+      default: {
+        shellCommand: 'npm install -g @kilocode/cli',
+        summary: 'Install Kilo CLI globally via npm.',
+      },
+    },
+  },
   qwen: {
     binary: 'qwen',
     docsUrl: 'https://qwenlm.github.io/qwen-code-docs/en/users/quickstart/',

package/src/tool-metadata.js

@@ -28,11 +28,13 @@
 export const TOOL_METADATA = {
   opencode:          { label: 'OpenCode CLI',     emoji: '📦', flag: '--opencode',         color: [110, 214, 255] },
   'opencode-desktop': { label: 'OpenCode Desktop', emoji: '📦', flag: '--opencode-desktop', color: [149, 205, 255] },
+  'opencode-web':     { label: 'OpenCode Web',     emoji: '📦', flag: '--opencode-web',     color: [180, 220, 255] },
   openclaw:          { label: 'OpenClaw',          emoji: '🦞', flag: '--openclaw',         color: [255, 129, 129] },
   crush:             { label: 'Crush',             emoji: '💘', flag: '--crush',            color: [255, 168, 209] },
   goose:             { label: 'Goose',             emoji: '🪿', flag: '--goose',            color: [132, 235, 168] },
   pi:                { label: 'Pi',                emoji: 'π',  flag: '--pi',               color: [173, 216, 230] },
   aider:             { label: 'Aider',             emoji: '🛠', flag: '--aider',            color: [255, 208, 102] },
+  kilo:              { label: 'Kilo CLI',          emoji: '⚡️', flag: '--kilo',             color: [255, 107, 107] },
   qwen:              { label: 'Qwen Code',         emoji: '🐉', flag: '--qwen',             color: [255, 213, 128] },
   openhands:         { label: 'OpenHands',         emoji: '🤲', flag: '--openhands',        color: [228, 191, 239] },
   amp:               { label: 'Amp',               emoji: '⚡', flag: '--amp',              color: [255, 232, 98] },
@@ -49,12 +51,13 @@ export const TOOL_METADATA = {
 // 📖 OpenCode CLI + Desktop are merged into a single 📦 slot since they share compatibility.
 // 📖 Each slot maps to one or more toolKeys for compatibility checking.
 export const COMPAT_COLUMN_SLOTS = [
-  { emoji: '📦', toolKeys: ['opencode', 'opencode-desktop'], color: [110, 214, 255] },
+  { emoji: '📦', toolKeys: ['opencode', 'opencode-desktop', 'opencode-web'], color: [110, 214, 255] },
   { emoji: '🦞', toolKeys: ['openclaw'],                     color: [255, 129, 129] },
   { emoji: '💘', toolKeys: ['crush'],                        color: [255, 168, 209] },
   { emoji: '🪿', toolKeys: ['goose'],                        color: [132, 235, 168] },
   { emoji: 'π',  toolKeys: ['pi'],                           color: [173, 216, 230] },
   { emoji: '🛠', toolKeys: ['aider'],                        color: [255, 208, 102] },
+  { emoji: '⚡️', toolKeys: ['kilo'],                         color: [255, 107, 107] },
   { emoji: '🐉', toolKeys: ['qwen'],                         color: [255, 213, 128] },
   { emoji: '🤲', toolKeys: ['openhands'],                    color: [228, 191, 239] },
   { emoji: '⚡', toolKeys: ['amp'],                          color: [255, 232, 98] },
@@ -72,10 +75,12 @@ export const TOOL_MODE_ORDER = [
   'pi',
   'jcode',
   'opencode-desktop',
+  'opencode-web',
   'openclaw',
   'crush',
   'goose',
   'aider',
+  'kilo',
   'qwen',
   'openhands',
   'amp',
@@ -100,7 +105,7 @@ export function getToolModeOrder() {
 const REGULAR_TOOLS = Object.keys(TOOL_METADATA).filter(k => !TOOL_METADATA[k].cliOnly)
 
 // 📖 Zen-only tools: OpenCode Zen models can ONLY run on OpenCode CLI / OpenCode Desktop.
-const ZEN_COMPATIBLE_TOOLS = ['opencode', 'opencode-desktop']
+const ZEN_COMPATIBLE_TOOLS = ['opencode', 'opencode-desktop', 'opencode-web']
 
 /**
  * 📖 Returns the list of tool keys a model is compatible with.

package/src/updater.js

@@ -394,6 +394,8 @@ export async function promptUpdateNotification(latestVersion) {
     render()
 
     readline.emitKeypressEvents(process.stdin)
+    // 📖 Ensure stdin is flowing — the shell-env prompt may have paused it
+    process.stdin.resume()
     if (process.stdin.isTTY) process.stdin.setRawMode(true)
 
     const onKey = (_str, key) => {

package/src/utils.js

@@ -387,13 +387,13 @@ export function findBestModel(results) {
 //
 // 📖 Argument types:
 //   - API key: first positional arg that does not look like a CLI flag (e.g., "nvapi-xxx")
-//   - Boolean flags: --best, --fiable, --opencode, --opencode-desktop, --openclaw,
-//     --aider, --crush, --goose, --qwen,
+//   - Boolean flags: --best, --fiable, --opencode, --opencode-desktop, --opencode-web, --openclaw,
+//     --aider, --crush, --goose, --qwen, --kilo,
 //     --openhands, --amp, --pi, --no-telemetry, --json, --help/-h (case-insensitive)
 //   - Value flag: --tier <letter> (the next non-flag arg is the tier value)
 //
 // Returns:
-//   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openClawMode,
+//   { apiKey, bestMode, fiableMode, openCodeMode, openCodeDesktopMode, openCodeWebMode, openClawMode,
 //     aiderMode, crushMode, gooseMode, qwenMode, openHandsMode, ampMode,
 //     piMode, jcodeMode, noTelemetry, jsonMode, helpMode, tierFilter }
 //
@@ -446,11 +446,13 @@ export function parseArgs(argv) {
   const fiableMode = flags.includes('--fiable')
   const openCodeMode = flags.includes('--opencode')
   const openCodeDesktopMode = flags.includes('--opencode-desktop')
+  const openCodeWebMode = flags.includes('--opencode-web')
   const openClawMode = flags.includes('--openclaw')
   const aiderMode = flags.includes('--aider')
   const crushMode = flags.includes('--crush')
   const gooseMode = flags.includes('--goose')
   const qwenMode = flags.includes('--qwen')
+  const kiloMode = flags.includes('--kilo')
   const openHandsMode = flags.includes('--openhands')
   const ampMode = flags.includes('--amp')
   const piMode = flags.includes('--pi')
@@ -492,11 +494,13 @@ export function parseArgs(argv) {
     fiableMode,
     openCodeMode,
     openCodeDesktopMode,
+    openCodeWebMode,
     openClawMode,
     aiderMode,
     crushMode,
     gooseMode,
     qwenMode,
+    kiloMode,
     openHandsMode,
     ampMode,
     piMode,