free-coding-models 0.3.22 → 0.3.24

package/src/overlays.js

@@ -94,7 +94,8 @@ export function createOverlayRenderers(state, deps) {
     const providerKeys = Object.keys(sources)
     const updateRowIdx = providerKeys.length
     const themeRowIdx = updateRowIdx + 1
-    const cleanupLegacyProxyRowIdx = themeRowIdx + 1
+    const favoritesModeRowIdx = themeRowIdx + 1
+    const cleanupLegacyProxyRowIdx = favoritesModeRowIdx + 1
     const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
     const EL = '\x1b[K'
     const lines = []
@@ -224,6 +225,16 @@ export function createOverlayRenderers(state, deps) {
     const themeRow = `${bullet(state.settingsCursor === themeRowIdx)}${themeColors.textBold('Global Theme').padEnd(44)} ${themeStatusColor(themeStatus)}`
     cursorLineByRow[themeRowIdx] = lines.length
     lines.push(state.settingsCursor === themeRowIdx ? themeColors.bgCursor(themeRow) : themeRow)
+
+    // 📖 Favorites mode row mirrors Y-key behavior from the main table.
+    const favoritesModeEnabled = state.favoritesPinnedAndSticky === true
+    const favoritesModeStatus = favoritesModeEnabled
+      ? themeColors.warningBold('Pinned + always visible')
+      : themeColors.info('Normal rows (filter/sort)')
+    const favoritesModeRow = `${bullet(state.settingsCursor === favoritesModeRowIdx)}${themeColors.textBold('Favorites Display Mode').padEnd(44)} ${favoritesModeStatus}`
+    cursorLineByRow[favoritesModeRowIdx] = lines.length
+    lines.push(state.settingsCursor === favoritesModeRowIdx ? themeColors.bgCursorSettingsList(favoritesModeRow) : favoritesModeRow)
+
     if (updateState === 'error' && state.settingsUpdateError) {
       lines.push(themeColors.error(`      ${state.settingsUpdateError}`))
     }
@@ -244,7 +255,7 @@ export function createOverlayRenderers(state, deps) {
     if (state.settingsEditMode) {
       lines.push(themeColors.dim('  Type API key  •  Enter Save  •  Esc Cancel'))
     } else {
-      lines.push(themeColors.dim('  ↑↓ Navigate  •  Enter Edit/Run/Cycle  •  + Add key  •  - Remove key  •  Space Toggle/Cycle  •  T Test key  •  U Updates  •  G Global theme  •  Esc Close'))
+      lines.push(themeColors.dim('  ↑↓ Navigate  •  Enter Edit/Run/Cycle  •  + Add key  •  - Remove key  •  Space Toggle/Cycle  •  T Test key  •  U Updates  •  G Global theme  •  Y Favorites mode  •  Esc Close'))
     }
     // 📖 Show sync/restore status message if set
     if (state.settingsSyncStatus) {
@@ -283,7 +294,7 @@ export function createOverlayRenderers(state, deps) {
 
   // ─── Install Endpoints overlay renderer ───────────────────────────────────
   // 📖 renderInstallEndpoints drives the provider → tool → scope → model flow
-  // 📖 behind the `Y` hotkey. It deliberately reuses the same overlay viewport
+  // 📖 opened from Settings/Command Palette. It deliberately reuses the same overlay viewport
   // 📖 helpers as Settings so long provider/model lists stay navigable.
   function renderInstallEndpoints() {
     const EL = '\x1b[K'
@@ -713,8 +724,8 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${label('CTX')}         Context window size (128k, 200k, 256k, 1m, etc.)  ${hint('Sort:')} ${key('C')}`)
     lines.push(`              ${hint('Bigger context = the model can read more of your codebase at once without forgetting.')}`)
     lines.push('')
-    lines.push(`  ${label('Model')}       Model name (⭐ = favorited, pinned at top)  ${hint('Sort:')} ${key('M')}  ${hint('Favorite:')} ${key('F')}`)
-    lines.push(`              ${hint('Star the ones you like — they stay pinned at the top across restarts.')}`)
+    lines.push(`  ${label('Model')}       Model name (⭐ = favorited)  ${hint('Sort:')} ${key('M')}  ${hint('Favorite:')} ${key('F')}`)
+    lines.push(`              ${hint('Star the ones you like. Press Y to switch between pinned mode and normal filter/sort mode.')}`)
     lines.push('')
     lines.push(`  ${label('Provider')}    Provider source (NIM, Groq, Cerebras, etc.)  ${hint('Sort:')} ${key('O')}  ${hint('Cycle:')} ${key('D')}`)
     lines.push(`              ${hint('Same model on different providers can have very different speed and uptime.')}`)
@@ -753,8 +764,10 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('W')}  Toggle ping mode  ${hint('(speed 2s → normal 10s → slow 30s → forced 4s)')}`)
     lines.push(`  ${key('Ctrl+P')}  Open ⚡️ command palette  ${hint('(search and run actions quickly)')}`)
     lines.push(`  ${key('E')}  Toggle configured models only  ${hint('(enabled by default)')}`)
-    lines.push(`  ${key('Z')}  Cycle tool mode  ${hint('(OpenCode → Desktop → OpenClaw → Crush → Goose → Pi → Aider → Qwen → OpenHands → Amp)')}`)
-    lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(⭐ pinned at top, persisted)')}`)
+    lines.push(`  ${key('Z')}  Cycle tool mode  ${hint('(📦 OpenCode → 📦 Desktop → 🦞 OpenClaw → 💘 Crush → 🪿 Goose → π Pi → 🛠 Aider → 🐉 Qwen → 🤲 OpenHands → ⚡ Amp → 🦘 Rovo → ♊ Gemini)')}`)
+    lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(⭐ persisted across sessions)')}`)
+    lines.push(`  ${key('Y')}  Toggle favorites mode  ${hint('(Pinned + always visible ↔ Normal filter/sort behavior)')}`)
+    lines.push(`  ${key('X')}  Clear active text filter  ${hint('(remove custom query applied from ⚡️ Command Palette)')}`)
     lines.push(`  ${key('Q')}  Smart Recommend  ${hint('(🎯 find the best model for your task — questionnaire + live analysis)')}`)
     lines.push(`  ${key('G')}  Cycle theme  ${hint('(auto → dark → light)')}`)
     lines.push(`  ${themeColors.errorBold('I')}  Feedback, bugs & requests  ${hint('(📝 send anonymous feedback, bug reports, or feature requests)')}`)
@@ -770,7 +783,8 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('PgUp/PgDn')}    Jump by page`)
     lines.push(`  ${key('Home/End')}     Jump first/last row`)
     lines.push(`  ${key('Enter')}        Edit key / run selected maintenance action`)
-    lines.push(`  ${key('Space')}        Toggle provider enable/disable`)
+    lines.push(`  ${key('Space')}        Toggle selected row option (provider/theme/favorites)`)
+    lines.push(`  ${key('Y')}            Toggle favorites mode (global)`)
     lines.push(`  ${key('T')}            Test selected provider key`)
     lines.push(`  ${key('U')}            Check updates manually`)
     lines.push(`  ${key('G')}            Cycle theme globally`)
@@ -1203,6 +1217,102 @@ export function createOverlayRenderers(state, deps) {
     if (state.recommendPingTimer) { clearInterval(state.recommendPingTimer); state.recommendPingTimer = null }
   }
 
+  // ─── Incompatible fallback overlay ─────────────────────────────────────────
+  // 📖 renderIncompatibleFallback shows when user presses Enter on a model that
+  // 📖 is NOT compatible with the active tool. Two sections:
+  // 📖   Section 1: "Switch to a compatible tool" — lists tools the model CAN run on
+  // 📖   Section 2: "Use a similar model" — lists SWE-similar models compatible with current tool
+  // 📖 Cursor navigates a flat list across both sections. Enter executes, Esc cancels.
+  function renderIncompatibleFallback() {
+    const EL = '\x1b[K'
+    const lines = []
+    const cursorLineByRow = {}
+
+    const model = state.incompatibleFallbackModel
+    const tools = state.incompatibleFallbackTools || []
+    const similarModels = state.incompatibleFallbackSimilarModels || []
+    const totalItems = tools.length + similarModels.length
+    const activeMeta = getToolMeta(state.mode)
+
+    lines.push(`  ${chalk.cyanBright('🚀')} ${chalk.bold.cyanBright('free-coding-models')}`)
+    lines.push(`  ${chalk.bold('⚠️  Incompatible Model')}`)
+    lines.push('')
+
+    if (!model) {
+      lines.push(chalk.red('  No model data available.'))
+      lines.push('')
+      lines.push(chalk.dim('  Esc Close'))
+    } else {
+      // 📖 Header: explain why it's incompatible
+      const tierFn = TIER_COLOR[model.tier] ?? ((text) => themeColors.text(text))
+      lines.push(`  ${themeColors.textBold(model.label)}  ${tierFn(model.tier)}`)
+      lines.push(chalk.dim(`  This model cannot run on ${activeMeta.emoji} ${activeMeta.label}.`))
+      lines.push('')
+
+      // 📖 Section 1: Switch to a compatible tool
+      if (tools.length > 0) {
+        lines.push(`  ${themeColors.textBold('Switch to a compatible tool:')}`)
+        lines.push('')
+
+        for (let i = 0; i < tools.length; i++) {
+          const toolKey = tools[i]
+          const meta = getToolMeta(toolKey)
+          const [r, g, b] = meta.color || [200, 200, 200]
+          const coloredLabel = chalk.rgb(r, g, b)(`${meta.emoji} ${meta.label}`)
+          const isCursor = state.incompatibleFallbackCursor === i
+          const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+          const row = `${bullet}${coloredLabel}`
+          cursorLineByRow[i] = lines.length
+          lines.push(isCursor ? themeColors.bgCursorInstall(row) : row)
+        }
+        lines.push('')
+      }
+
+      // 📖 Section 2: Use a similar model
+      if (similarModels.length > 0) {
+        lines.push(`  ${themeColors.textBold('Or pick a similar model for')} ${activeMeta.emoji} ${themeColors.textBold(activeMeta.label + ':')}`)
+        lines.push('')
+
+        for (let i = 0; i < similarModels.length; i++) {
+          const sm = similarModels[i]
+          const flatIdx = tools.length + i
+          const tierFnSm = TIER_COLOR[sm.tier] ?? ((text) => themeColors.text(text))
+          const isCursor = state.incompatibleFallbackCursor === flatIdx
+          const bullet = isCursor ? chalk.bold.cyan('  ❯ ') : chalk.dim('    ')
+          const sweLabel = sm.sweScore !== '-' ? `SWE ${sm.sweScore}` : 'SWE —'
+          const row = `${bullet}${themeColors.textBold(sm.label)}  ${tierFnSm(sm.tier)}  ${chalk.dim(sweLabel)}`
+          cursorLineByRow[flatIdx] = lines.length
+          lines.push(isCursor ? themeColors.bgCursorInstall(row) : row)
+        }
+        lines.push('')
+      }
+
+      if (totalItems === 0) {
+        lines.push(chalk.yellow('  No compatible tools or similar models found.'))
+        lines.push('')
+      }
+
+      lines.push(chalk.dim('  ↑↓ Navigate  •  Enter Confirm  •  Esc Cancel'))
+    }
+
+    lines.push('')
+
+    // 📖 Scroll management — same pattern as other overlays
+    const targetLine = cursorLineByRow[state.incompatibleFallbackCursor] ?? 0
+    state.incompatibleFallbackScrollOffset = keepOverlayTargetVisible(
+      state.incompatibleFallbackScrollOffset,
+      targetLine,
+      lines.length,
+      state.terminalRows
+    )
+    const { visible, offset } = sliceOverlayLines(lines, state.incompatibleFallbackScrollOffset, state.terminalRows)
+    state.incompatibleFallbackScrollOffset = offset
+
+    const tintedLines = tintOverlayLines(visible, themeColors.overlayBgSettings, state.terminalCols)
+    const cleared = tintedLines.map(l => l + EL)
+    return cleared.join('\n')
+  }
+
   return {
     renderSettings,
     renderInstallEndpoints,
@@ -1212,6 +1322,7 @@ export function createOverlayRenderers(state, deps) {
     renderRecommend,
     renderFeedback,
     renderChangelog,
+    renderIncompatibleFallback,
     startRecommendAnalysis,
     stopRecommendAnalysis,
   }

package/src/provider-metadata.js

@@ -58,6 +58,7 @@ export const ENV_VAR_NAMES = {
   cloudflare: 'CLOUDFLARE_API_TOKEN',
   perplexity: 'PERPLEXITY_API_KEY',
   zai:        'ZAI_API_KEY',
+  gemini:     'GEMINI_API_KEY',
 }
 
 // 📖 OPENCODE_MODEL_MAP: sparse table of model IDs that differ between sources.js and OpenCode's
@@ -225,4 +226,28 @@ export const PROVIDER_METADATA = {
     signupHint: 'Install @mariozechner/pi-coding-agent and set ANTHROPIC_API_KEY',
     rateLimits: 'Depends on provider subscription (e.g., Anthropic, OpenAI)',
   },
+  rovo: {
+    label: 'Rovo Dev CLI',
+    color: chalk.rgb(148, 163, 184), // slate blue
+    signupUrl: 'https://www.atlassian.com/rovo',
+    signupHint: 'Install ACLI and run: acli rovodev auth login',
+    rateLimits: 'Free tier: 5M tokens/day (beta, requires Atlassian account)',
+    cliOnly: true,
+  },
+  gemini: {
+    label: 'Gemini CLI',
+    color: chalk.rgb(66, 165, 245), // blue
+    signupUrl: 'https://github.com/google-gemini/gemini-cli',
+    signupHint: 'Install: npm install -g @google/gemini-cli',
+    rateLimits: 'Free tier: 1,000 req/day (personal Google account, no credit card)',
+    cliOnly: true,
+  },
+  'opencode-zen': {
+    label: 'OpenCode Zen',
+    color: chalk.rgb(139, 92, 246), // violet — distinctive from other providers
+    signupUrl: 'https://opencode.ai/auth',
+    signupHint: 'Login at opencode.ai/auth to get your Zen API key',
+    rateLimits: 'Free tier models — requires OpenCode Zen API key',
+    zenOnly: true,
+  },
 }

package/src/render-helpers.js

@@ -36,6 +36,7 @@
  *   - chalk: Terminal colors and formatting
  *   - ../src/constants.js: OVERLAY_PANEL_WIDTH, TABLE_FIXED_LINES
  *   - ../src/utils.js: sortResults
+ *   - ../src/tool-metadata.js: isModelCompatibleWithTool (for compatible-first partition)
  *
  *   ⚙️ Configuration:
  *   - OVERLAY_PANEL_WIDTH: Fixed width for overlay panels (from constants.js)
@@ -168,10 +169,22 @@ export function calculateViewport(terminalRows, scrollOffset, totalModels, extra
 
 // 📖 sortResultsWithPinnedFavorites: Recommended models are pinned above favorites, favorites above non-favorites.
 // 📖 Recommended: sorted by recommendation score (highest first).
-// 📖 Favorites: keep insertion order (favoriteRank).
+// 📖 Favorites: keep insertion order (favoriteRank) when pinFavorites=true.
 // 📖 Non-favorites: active sort column/direction.
 // 📖 Models that are both recommended AND favorite — show in recommended section.
-export function sortResultsWithPinnedFavorites(results, sortColumn, sortDirection) {
+// 📖 pinFavorites=false keeps favorites highlighted but lets normal sort/filter order apply.
+export function sortResultsWithPinnedFavorites(results, sortColumn, sortDirection, { pinFavorites = true } = {}) {
+  if (!pinFavorites) {
+    const recommendedRows = results
+      .filter((r) => r.isRecommended)
+      .sort((a, b) => (b.recommendScore || 0) - (a.recommendScore || 0))
+    const nonRecommendedRows = sortResults(
+      results.filter((r) => !r.isRecommended),
+      sortColumn,
+      sortDirection
+    )
+    return [...recommendedRows, ...nonRecommendedRows]
+  }
   const recommendedRows = results
     .filter((r) => r.isRecommended && !r.isFavorite)
     .sort((a, b) => (b.recommendScore || 0) - (a.recommendScore || 0))

package/src/render-table.js

@@ -13,7 +13,8 @@
  *   - Emoji-aware padding via padEndDisplay for aligned verdict/status cells
  *   - Viewport clipping with above/below indicators
  *   - Smart badges (mode, tier filter, origin filter)
- *   - Install-endpoints shortcut surfaced directly in the footer hints
+ *   - Favorites mode hint surfaced directly in footer hints (`Y`)
+ *   - High-visibility active text-filter banner with one-key clear action (`X`)
  *   - Full-width red outdated-version banner when a newer npm release is known
  *   - Distinct auth-failure vs missing-key health labels so configured providers stay honest
  *
@@ -49,7 +50,7 @@ import { TIER_COLOR } from './tier-colors.js'
 import { getAvg, getVerdict, getUptime, getStabilityScore, getVersionStatusInfo } from './utils.js'
 import { usagePlaceholderForProvider } from './ping.js'
 import { calculateViewport, sortResultsWithPinnedFavorites, padEndDisplay, displayWidth } from './render-helpers.js'
-import { getToolMeta } from './tool-metadata.js'
+import { getToolMeta, TOOL_METADATA, TOOL_MODE_ORDER, COMPAT_COLUMN_SLOTS, getCompatibleTools, isModelCompatibleWithTool } from './tool-metadata.js'
 import { getColumnSpacing } from './ui-config.js'
 
 const require = createRequire(import.meta.url)
@@ -66,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) {
+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) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -108,9 +109,12 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
 
   // 📖 Tool badge keeps the active launch target visible in the header, so the
   // 📖 footer no longer needs a redundant Enter action or mode toggle reminder.
+  // 📖 Tool name is colored with its unique tool color for quick recognition.
   const toolMeta = getToolMeta(mode)
   const toolBadgeColor = mode === 'openclaw' ? themeColors.warningBold : themeColors.accentBold
-  const modeBadge = toolBadgeColor(' [ ') + themeColors.hotkey('Z') + toolBadgeColor(` Tool : ${toolMeta.label} ]`)
+  const toolColor = toolMeta.color ? chalk.rgb(...toolMeta.color) : toolBadgeColor
+  const modeBadge = toolBadgeColor(' [ ') + themeColors.hotkey('Z') + toolBadgeColor(' Tool : ') + toolColor.bold(`${toolMeta.emoji} ${toolMeta.label}`) + toolBadgeColor(' ]')
+
   const activeHeaderBadge = (text, bg) => themeColors.badge(text, bg, getReadableTextRgb(bg))
   const versionStatus = getVersionStatusInfo(settingsUpdateState, settingsUpdateLatestVersion, startupLatestVersion, versionAlertsEnabled)
 
@@ -156,6 +160,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   const W_STATUS = 18
   const W_VERDICT = 14
   const W_UPTIME = 6
+  const W_COMPAT = 22 // 📖 "Compatible with" column — 11 emoji slots (10×2 + 1×1 for π + 1 padding)
   // const W_TOKENS = 7 // Used column removed
   // const W_USAGE = 7 // Usage column removed
   const MIN_TABLE_WIDTH = WIDTH_WARNING_MIN_COLS
@@ -175,6 +180,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   let showUptime = true
   let showTier = true
   let showStability = true
+  let showCompat = true // 📖 "Compatible with" column — hidden on narrow terminals
   let isCompact = false
 
   if (terminalCols > 0) {
@@ -186,6 +192,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       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)
+      if (showCompat) cols.push(W_COMPAT)
       return ROW_MARGIN + cols.reduce((a, b) => a + b, 0) + (cols.length - 1) * SEP_W
     }
 
@@ -199,6 +206,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
       wStatus = 13   // Health truncated after 6 chars + '…'
     }
     // 📖 Steps 2–5: Progressive column hiding (least useful first)
+    if (calcWidth() > terminalCols) showCompat = false
     if (calcWidth() > terminalCols) showRank = false
     if (calcWidth() > terminalCols) showUptime = false
     if (calcWidth() > terminalCols) showTier = false
@@ -207,7 +215,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   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 && !widthWarningDismissed && widthWarningShowCount < 2 && remainingMs > 0
+  const showWidthWarning = terminalCols > 0 && terminalCols < MIN_TABLE_WIDTH && !widthWarningDismissed && remainingMs > 0
 
   if (showWidthWarning) {
     const lines = []
@@ -237,7 +245,9 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   }
 
   // 📖 Sort models using the shared helper
-  const sorted = sortResultsWithPinnedFavorites(visibleResults, sortColumn, sortDirection)
+  const sorted = sortResultsWithPinnedFavorites(visibleResults, sortColumn, sortDirection, {
+    pinFavorites: favoritesPinnedAndSticky,
+  })
 
   const lines = [
     `  ${themeColors.accentBold(`🚀 free-coding-models v${LOCAL_VERSION}`)}${modeBadge}${pingControlBadge}${tierBadge}${originBadge}${chalk.reset('')}   ` +
@@ -316,6 +326,14 @@ 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)
   })()
+  // 📖 "Compatible with" column header — show all tool emojis in their colors as the header
+  const compatHeaderEmojis = COMPAT_COLUMN_SLOTS.map(slot => {
+    return chalk.rgb(...slot.color)(slot.emoji)
+  }).join('')
+  // 📖 padEndDisplay accounts for emoji widths (most are 2-wide, π is 1-wide)
+  const compatHeaderRaw = COMPAT_COLUMN_SLOTS.reduce((w, slot) => w + displayWidth(slot.emoji), 0)
+  const compatHeaderPad = Math.max(0, W_COMPAT - compatHeaderRaw)
+  const compatH_c = compatHeaderEmojis + ' '.repeat(compatHeaderPad)
   // 📖 Usage column removed from UI – no header or separator for it.
   // 📖 Header row: conditionally include columns based on responsive visibility
   const headerParts = []
@@ -324,6 +342,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   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)
+  if (showCompat) headerParts.push(compatH_c)
   lines.push('  ' + headerParts.join(COL_SEP))
 
 
@@ -339,6 +358,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   }
 
   // 📖 Viewport clipping: only render models that fit on screen
+  const hasCustomFilter = typeof customTextFilter === 'string' && customTextFilter.trim().length > 0
   const extraFooterLines = versionStatus.isOutdated ? 1 : 0
   const vp = calculateViewport(terminalRows, scrollOffset, sorted.length, extraFooterLines)
   const paintSweScore = (score, paddedText) => {
@@ -581,6 +601,31 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     const sourceCursorText = providerDisplay.padEnd(wSource)
     const sourceCell = isCursor ? themeColors.provider(r.providerKey, sourceCursorText, { bold: true }) : source
 
+    // 📖 "Compatible with" column — show colored emojis for compatible tools
+    // 📖 Each slot in COMPAT_COLUMN_SLOTS maps to one or more tool keys.
+    // 📖 OpenCode CLI + Desktop are merged into a single 📦 slot.
+    let compatCell = ''
+    if (showCompat) {
+      const compatTools = getCompatibleTools(r.providerKey)
+      let compatDisplayWidth = 0
+      const emojiCells = COMPAT_COLUMN_SLOTS.map(slot => {
+        const isCompat = slot.toolKeys.some(tk => compatTools.includes(tk))
+        const ew = displayWidth(slot.emoji)
+        compatDisplayWidth += isCompat ? ew : ew
+        if (isCompat) {
+          return chalk.rgb(...slot.color)(slot.emoji)
+        }
+        // 📖 Replace incompatible emoji with dim spaces matching its display width
+        return themeColors.dim(' '.repeat(ew))
+      }).join('')
+      // 📖 Pad to W_COMPAT — account for actual emoji display widths
+      const extraPad = Math.max(0, W_COMPAT - compatDisplayWidth)
+      compatCell = emojiCells + ' '.repeat(extraPad)
+    }
+
+    // 📖 Check if this model is incompatible with the active tool mode
+    const isIncompatible = !isModelCompatibleWithTool(r.providerKey, mode)
+
     // 📖 Usage column removed from UI – no usage data displayed.
     // (We keep the logic but do not render it.)
     const usageCell = ''
@@ -592,10 +637,15 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     rowParts.push(sweCell, ctxCell, nameCell, sourceCell, pingCell, avgCell, status, speedCell)
     if (showStability) rowParts.push(stabCell)
     if (showUptime) rowParts.push(uptimeCell)
+    if (showCompat) rowParts.push(compatCell)
     const row = '  ' + rowParts.join(COL_SEP)
 
     if (isCursor) {
       lines.push(themeColors.bgModelCursor(row))
+    } else if (isIncompatible) {
+      // 📖 Dark red background for models incompatible with the active tool mode.
+      // 📖 This visually warns the user that selecting this model won't work with their current tool.
+      lines.push(chalk.bgRgb(60, 15, 15).rgb(180, 130, 130)(row))
     } else if (r.isRecommended) {
       // 📖 Medium green background for recommended models (distinguishable from favorites)
       lines.push(themeColors.bgModelRecommended(row))
@@ -618,10 +668,14 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   // 📖 states are obvious even when the user misses the smaller header badges.
   const configuredBadgeBg = getTheme() === 'dark' ? [52, 120, 88] : [195, 234, 206]
   const activeHotkey = (keyLabel, text, bg) => themeColors.badge(`${keyLabel}${text}`, bg, getReadableTextRgb(bg))
+  const favoritesModeBg = favoritesPinnedAndSticky ? [157, 122, 48] : [95, 95, 95]
+  const favoritesModeLabel = favoritesPinnedAndSticky ? ' Favorites Pinned' : ' Favorites Normal'
   // 📖 Line 1: core navigation + filtering shortcuts
   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')) +
@@ -673,9 +727,29 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     lines.push(chalk.bgRed.white.bold(paddedBanner))
   }
 
-  // 📖 Final footer line: changelog shortcut + exit hint (replaces the old proxy notice).
+  // 📖 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} `)
+  }
+
   lines.push(
     '  ' + themeColors.hotkey('N') + themeColors.dim(' Changelog') +
+    (filterBadge
+      ? themeColors.dim('  •  ') + filterBadge
+      : '') +
     themeColors.dim('  •  ') +
     themeColors.dim('Ctrl+C Exit')
   )

package/src/theme.js

@@ -141,6 +141,9 @@ const PROVIDER_PALETTES = {
     qwen: [255, 213, 128],
     zai: [150, 208, 255],
     iflow: [211, 229, 101],
+    rovo: [148, 163, 184],
+    gemini: [66, 165, 245],
+    'opencode-zen': [185, 146, 255],
   },
   light: {
     nvidia: [0, 126, 73],
@@ -163,6 +166,9 @@ const PROVIDER_PALETTES = {
     qwen: [132, 89, 0],
     zai: [0, 104, 171],
     iflow: [107, 130, 0],
+    rovo: [90, 100, 126],
+    gemini: [15, 97, 175],
+    'opencode-zen': [108, 58, 183],
   },
 }
 

package/src/tool-bootstrap.js

@@ -217,6 +217,28 @@ export const TOOL_BOOTSTRAP_METADATA = {
       },
     },
   },
+  rovo: {
+    binary: 'acli',
+    docsUrl: 'https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/',
+    install: {
+      default: {
+        shellCommand: 'npm install -g acli',
+        summary: 'Rovo Dev CLI requires ACLI installation. Visit the documentation for platform-specific instructions.',
+        note: 'Rovo is an Atlassian tool that requires an Atlassian account with Rovo Dev activated.',
+      },
+    },
+  },
+  gemini: {
+    binary: 'gemini',
+    docsUrl: 'https://github.com/google-gemini/gemini-cli',
+    install: {
+      default: {
+        shellCommand: 'npm install -g @google/gemini-cli',
+        summary: 'Install Gemini CLI globally via npm.',
+        note: 'After installation, run `gemini` to authenticate with your Google account.',
+      },
+    },
+  },
 }
 
 export function getToolBootstrapMeta(mode) {

package/src/tool-launchers.js

@@ -41,7 +41,7 @@ import { sources } from '../sources.js'
 import { PROVIDER_COLOR } from './render-table.js'
 import { getApiKey } from './config.js'
 import { ENV_VAR_NAMES, isWindows } from './provider-metadata.js'
-import { getToolMeta } from './tool-metadata.js'
+import { getToolMeta, TOOL_METADATA } from './tool-metadata.js'
 import { PROVIDER_METADATA } from './provider-metadata.js'
 import { resolveToolBinaryPath } from './tool-bootstrap.js'
 
@@ -378,6 +378,57 @@ function writeOpenHandsEnv(model, apiKey, baseUrl, paths = getDefaultToolPaths()
   return { filePath, backupPath }
 }
 
+/**
+ * 📖 writeRovoConfig - Configure Rovo Dev CLI model selection
+ *
+ * Rovo Dev CLI uses ~/.rovodev/config.yml for configuration.
+ * We write the model ID to the config file before launching.
+ *
+ * @param {Object} model - Selected model with modelId
+ * @param {string} configPath - Path to Rovo config file
+ * @returns {{ filePath: string, backupPath: string | null }}
+ */
+function writeRovoConfig(model, configPath = join(homedir(), '.rovodev', 'config.yml')) {
+  const backupPath = backupIfExists(configPath)
+  const config = {
+    agent: {
+      modelId: model.modelId,
+    },
+  }
+
+  ensureDir(configPath)
+  writeFileSync(configPath, `agent:\n  modelId: "${model.modelId}"\n`)
+  return { filePath: configPath, backupPath }
+}
+
+/**
+ * 📖 buildGeminiEnv - Build environment variables for Gemini CLI
+ *
+ * Gemini CLI supports OpenAI-compatible APIs via environment variables:
+ * - GEMINI_API_BASE_URL: Custom API endpoint
+ * - GEMINI_API_KEY: API key for custom endpoint
+ *
+ * @param {Object} model - Selected model with providerKey
+ * @param {Object} config - Full app config
+ * @param {Object} options - Env options
+ * @returns {NodeJS.ProcessEnv}
+ */
+function buildGeminiEnv(model, config, options = {}) {
+  const providerKey = model.providerKey || 'gemini'
+  const apiKey = getApiKey(config, providerKey)
+  const baseUrl = getProviderBaseUrl(providerKey)
+
+  const env = cloneInheritedEnv(process.env, SANITIZED_TOOL_ENV_KEYS)
+
+  // If we have a custom API key and base URL, configure OpenAI-compatible mode
+  if (apiKey && baseUrl && options.includeProviderEnv) {
+    env.GEMINI_API_BASE_URL = baseUrl
+    env.GEMINI_API_KEY = apiKey
+  }
+
+  return env
+}
+
 function printConfigArtifacts(toolName, artifacts = []) {
   for (const artifact of artifacts) {
     if (!artifact?.path) continue
@@ -420,7 +471,9 @@ export function prepareExternalToolLaunch(mode, model, config, options = {}) {
     inheritedEnv: options.inheritedEnv,
   })
 
-  if (!apiKey && mode !== 'amp') {
+  const isCliOnlyTool = TOOL_METADATA[mode]?.cliOnly === true
+
+  if (!apiKey && mode !== 'amp' && !isCliOnlyTool) {
     const providerRgb = PROVIDER_COLOR[model.providerKey] ?? [105, 190, 245]
     const providerName = sources[model.providerKey]?.name || model.providerKey
     const coloredProviderName = chalk.bold.rgb(...providerRgb)(providerName)
@@ -544,6 +597,34 @@ export function prepareExternalToolLaunch(mode, model, config, options = {}) {
     }
   }
 
+  if (mode === 'rovo') {
+    const result = writeRovoConfig(model, join(homedir(), '.rovodev', 'config.yml'), paths)
+    console.log(chalk.dim(`  📖 Rovo Dev CLI configured with model: ${model.modelId}`))
+    return {
+      command: 'acli',
+      args: ['rovodev', 'run'],
+      env,
+      apiKey: null,
+      baseUrl: null,
+      meta,
+      configArtifacts: [{ path: result.filePath, backupPath: result.backupPath, label: 'config' }],
+    }
+  }
+
+  if (mode === 'gemini') {
+    const geminiEnv = buildGeminiEnv(model, config, { includeProviderEnv: options.includeProviderEnv })
+    console.log(chalk.dim(`  📖 Gemini CLI will use model: ${model.modelId}`))
+    return {
+      command: 'gemini',
+      args: [],
+      env: { ...env, ...geminiEnv },
+      apiKey: geminiEnv.GEMINI_API_KEY || null,
+      baseUrl: geminiEnv.GEMINI_API_BASE_URL || null,
+      meta,
+      configArtifacts: [],
+    }
+  }
+
   return {
     blocked: true,
     exitCode: 1,
@@ -598,6 +679,16 @@ export async function startExternalTool(mode, model, config) {
     return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
   }
 
+  if (mode === 'rovo') {
+    console.log(chalk.dim(`  📖 Launching Rovo Dev CLI in interactive mode...`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
+  if (mode === 'gemini') {
+    console.log(chalk.dim(`  📖 Launching Gemini CLI...`))
+    return spawnCommand(resolveLaunchCommand(mode, launchPlan.command), launchPlan.args, launchPlan.env)
+  }
+
   console.log(chalk.red(`  X Unsupported external tool mode: ${mode}`))
   return 1
 }