free-coding-models 0.3.23 → 0.3.25

package/CHANGELOG.md

@@ -1,6 +1,47 @@
 # Changelog
 ---
 
+## [0.3.25] - 2026-03-19
+
+### Changed
+- **Removed "CLI Tools" column** — The compat emoji column has been removed from the TUI table, freeing ~22 characters of horizontal space for other columns
+- **Cleaner table layout** — Responsive column hiding no longer needs to drop the compat column first on narrow terminals
+
+## [0.3.24] - 2026-03-19
+
+### Added
+- **Unique emoji per tool** — Every CLI tool now has a dedicated emoji shown in the Compatible column, Z-cycle badge, command palette, help overlay, and README (📦 OpenCode, 🦞 OpenClaw, 💘 Crush, 🪿 Goose, π Pi, 🛠 Aider, 🐉 Qwen, 🤲 OpenHands, ⚡ Amp, 🦘 Rovo, ♊ Gemini)
+- **Merged compat column** — OpenCode CLI and Desktop share 📦 in a single slot (11 slots instead of 12 separate initials)
+- **COMPAT_COLUMN_SLOTS** — New export in tool-metadata.js for merged compatible-column rendering
+- **Width warning now always shows** - Terminal width warning displays every time terminal is resized below 80 columns (previously limited to 2 shows per session)
+- **Gemini CLI integration** - New CLI-only tool provider with 3 models (Gemini 3 Pro 🆕, Gemini 2.5 Pro, Gemini 2.5 Flash)
+- **Rovo Dev CLI integration** - New CLI-only tool provider with Claude Sonnet 4 🆕
+- **Tool compatibility alerts** - When trying to launch Rovo/Gemini models with wrong tool, shows alert and offers to switch
+- **Auto-install detection** - Prompt to install CLI tools when binary not found (Rovo/Gemini)
+- **OpenAI-compatible API support for Gemini** - Gemini CLI can use custom providers via environment variables
+- **New CLI flags** - Added `--rovo` and `--gemini` launch options
+- **"🆕" badges** - Mark newly added models in the table (Claude Sonnet 4, Gemini 3 Pro)
+- **OpenCode Zen free models** - 5 new free models (Big Pickle, GPT 5 Nano, MiMo V2 Flash Free, MiniMax M2.5 Free, Nemotron 3 Super Free) exclusive to OpenCode CLI/Desktop via `opencode-zen` provider
+- **"Compatible with" column** - New TUI column showing colored emojis for each tool a model supports; incompatible tools show dim spaces
+- **Tool color system** - Each of the 12 supported tools now has a unique RGB color and emoji used in the Z-cycle badge and compatibility column
+- **Incompatible model highlighting** - When a tool mode is active (via Z), models that can't run with that tool get a dark red background for instant visibility — they stay in their normal sorted position (not pushed to the bottom)
+- **Tool compatibility functions** - `getCompatibleTools()` and `isModelCompatibleWithTool()` in tool-metadata.js for programmatic compatibility checks
+- **Incompatible model fallback overlay** - When pressing Enter on a model that can't run on the active tool (red-highlighted row), an in-TUI overlay appears with two options: (1) switch to a compatible tool, or (2) pick a similar model by SWE score that works with the current tool
+- **findSimilarCompatibleModels()** - New function in tool-metadata.js that finds models with closest SWE scores compatible with the active tool
+- **Updated provider/model counts** - Now 23 providers with 171 models (was 20/160)
+
+### Changed
+- **Z key cycle** - Rovo and Gemini added to tool mode cycle (last in order)
+- **Tool metadata** - Removed `initial` field (replaced by emojis), added `cliOnly` flag for CLI-only tools, `emoji` and `color` properties for all 12 tools
+- **Provider metadata** - Added Rovo, Gemini, and OpenCode Zen provider information
+- **Responsive column hiding** - Compatible column hides first (before Rank) on narrow terminals
+- **Key handler** - Zen models auto-switch to OpenCode CLI on launch; API key warnings skip Zen models
+- **Documentation** - Updated README with CLI-only tools section, Zen models, compatibility matrix
+
+### Fixed
+- **Missing import error** - Fixed `getToolMeta` not defined in key-handler.js
+- **CLI-only tools API key requirement** - Gemini CLI and Rovo Dev CLI no longer require API keys to be configured before launching; these tools manage their own authentication
+
 ## 0.3.23
 
 ### Added

package/README.md

@@ -2,15 +2,15 @@
   <img src="https://img.shields.io/npm/v/free-coding-models?color=76b900&label=npm&logo=npm" alt="npm version">
   <img src="https://img.shields.io/node/v/free-coding-models?color=76b900&logo=node.js" alt="node version">
   <img src="https://img.shields.io/npm/l/free-coding-models?color=76b900" alt="license">
-  <img src="https://img.shields.io/badge/models-160-76b900?logo=nvidia" alt="models count">
-  <img src="https://img.shields.io/badge/providers-20-blue" alt="providers count">
+  <img src="https://img.shields.io/badge/models-174-76b900?logo=nvidia" alt="models count">
+  <img src="https://img.shields.io/badge/providers-23-blue" alt="providers count">
 </p>
 
 <h1 align="center">free-coding-models</h1>
 
 <p align="center">
   <strong>Find the fastest free coding model in seconds</strong><br>
-  <sub>Ping 160 models across 20 AI Free providers in real-time </sub><br><sub> Install Free API endpoints to your favorite AI coding tool: <br>OpenCode, OpenClaw, Crush, Goose, Aider, Qwen Code, OpenHands, Amp or Pi in one keystroke</sub>
+  <sub>Ping 174 models across 23 AI Free providers in real-time </sub><br><sub> Install Free API endpoints to your favorite AI coding tool: <br>📦 OpenCode, 🦞 OpenClaw, 💘 Crush, 🪿 Goose, 🛠 Aider, 🐉 Qwen Code, 🤲 OpenHands, ⚡ Amp, π Pi, 🦘 Rovo or ♊ Gemini in one keystroke</sub>
 </p>
 
 
@@ -47,7 +47,7 @@ create a free account on one of the [providers](#-list-of-free-ai-providers)
 
 ## 💡 Why this tool?
 
-There are **160+ free coding models** scattered across 20 providers. Which one is fastest right now? Which one is actually stable versus just lucky on the last ping?
+There are **174+ free coding models** scattered across 23 providers. Which one is fastest right now? Which one is actually stable versus just lucky on the last ping?
 
 This CLI pings them all in parallel, shows live latency, and calculates a **live Stability Score (0-100)**. Average latency alone is misleading if a model randomly spikes to 6 seconds; the stability score measures true reliability by combining **p95 latency** (30%), **jitter/variance** (30%), **spike rate** (20%), and **uptime** (20%). 
 
@@ -61,7 +61,7 @@ It then writes the model you pick directly into your coding tool's config — so
 
 Create a free account on one provider below to get started:
 
-**160 coding models** across 20 providers, ranked by [SWE-bench Verified](https://www.swebench.com).
+**174 coding models** across 23 providers, ranked by [SWE-bench Verified](https://www.swebench.com).
 
 | Provider | Models | Tier range | Free tier | Env var |
 |----------|--------|-----------|-----------|--------|
@@ -85,6 +85,9 @@ Create a free account on one provider below to get started:
 | [Cloudflare Workers AI](https://dash.cloudflare.com) | 6 | S → B | Free: 10k neurons/day, text-gen 300 RPM | `CLOUDFLARE_API_TOKEN` + `CLOUDFLARE_ACCOUNT_ID` |
 | [Perplexity API](https://www.perplexity.ai/settings/api) | 4 | A+ → B | Tiered limits by spend (default ~50 RPM) | `PERPLEXITY_API_KEY` |
 | [Replicate](https://replicate.com/account/api-tokens) | 1 | A- | 6 req/min (no payment) – up to 3,000 RPM with payment | `REPLICATE_API_TOKEN` |
+| [Rovo Dev CLI](https://www.atlassian.com/rovo) | 1 | S+ | 5M tokens/day (beta) | CLI tool 🦘 |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 3 | S+ → A+ | 1,000 req/day | CLI tool ♊ |
+| [OpenCode Zen](https://opencode.ai/zen) | 8 | S+ → A+ | Free with OpenCode account | Zen models ✨ |
 
 > 💡 One key is enough. Add more at any time with **`P`** inside the TUI.
 
@@ -121,7 +124,7 @@ Need to fix contrast because your terminal theme is fighting the TUI? Press **`G
 ↑↓ navigate   →   Enter to launch
 ```
 
-The model you select is automatically written into your tool's config (OpenCode, OpenClaw, Crush, etc.) and the tool opens immediately. Done.
+The model you select is automatically written into your tool's config (📦 OpenCode, 🦞 OpenClaw, 💘 Crush, etc.) and the tool opens immediately. Done.
 
 If the active CLI tool is missing, FCM now catches it before launch, offers a tiny Yes/No install prompt, installs the tool with its official global command, then resumes the same model launch automatically.
 
@@ -157,19 +160,69 @@ free-coding-models --openclaw --origin groq
 
 | Flag | Launches |
 |------|----------|
-| `--opencode` | OpenCode CLI |
-| `--opencode-desktop` | OpenCode Desktop |
-| `--openclaw` | OpenClaw |
-| `--crush` | Crush |
-| `--goose` | Goose |
-| `--aider` | Aider |
-| `--qwen` | Qwen Code |
-| `--openhands` | OpenHands |
-| `--amp` | Amp |
-| `--pi` | Pi |
+| `--opencode` | 📦 OpenCode CLI |
+| `--opencode-desktop` | 📦 OpenCode Desktop |
+| `--openclaw` | 🦞 OpenClaw |
+| `--crush` | 💘 Crush |
+| `--goose` | 🪿 Goose |
+| `--aider` | 🛠 Aider |
+| `--qwen` | 🐉 Qwen Code |
+| `--openhands` | 🤲 OpenHands |
+| `--amp` | ⚡ Amp |
+| `--pi` | π Pi |
+| `--rovo` | 🦘 Rovo Dev CLI |
+| `--gemini` | ♊ Gemini CLI |
 
 Press **`Z`** in the TUI to cycle between tools without restarting.
 
+### CLI-Only Tools
+
+**🦘 Rovo Dev CLI**
+- Provider: [Atlassian Rovo](https://www.atlassian.com/rovo)
+- Install: [Installation Guide](https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/)
+- Free tier: 5M tokens/day (beta, requires Atlassian account)
+- Model: Claude Sonnet 4 (72.7% SWE-bench)
+- Launch: `free-coding-models --rovo` or press `Z` until Rovo mode
+- Features: Jira/Confluence integration, MCP server support
+
+**♊ Gemini CLI**
+- Provider: [Google Gemini](https://github.com/google-gemini/gemini-cli)
+- Install: `npm install -g @google/gemini-cli`
+- Free tier: 1,000 requests/day (personal Google account, no credit card)
+- Models: Gemini 3 Pro (76.2% SWE-bench), Gemini 2.5 Pro, Gemini 2.5 Flash
+- Launch: `free-coding-models --gemini` or press `Z` until Gemini mode
+- Features: OpenAI-compatible API support, MCP server support, Google Search grounding
+
+**Note:** When launching these tools via `Z` key or command palette, if the current mode doesn't match the tool, you'll see a confirmation alert asking to switch to the correct tool before launching.
+
+### OpenCode Zen Free Models
+
+[OpenCode Zen](https://opencode.ai/zen) is a hosted AI gateway offering 8 free coding models exclusively through OpenCode CLI and OpenCode Desktop. These models are **not** available through other tools.
+
+| Model | Tier | SWE-bench | Context |
+|-------|------|-----------|---------|
+| Big Pickle | S+ | 72.0% | 200k |
+| MiniMax M2.5 Free | S+ | 80.2% | 200k |
+| MiMo V2 Pro Free | S+ | 78.0% | 1M |
+| MiMo V2 Omni Free | S | 64.0% | 128k |
+| MiMo V2 Flash Free | S+ | 73.4% | 256k |
+| Nemotron 3 Super Free | A+ | 52.0% | 128k |
+| GPT 5 Nano | S | 65.0% | 128k |
+| Trinity Large Preview Free | S | 62.0% | 128k |
+
+To use Zen models: sign up at [opencode.ai/auth](https://opencode.ai/auth) and enter your Zen API key via `P` (Settings). Zen models appear in the main table and auto-switch to OpenCode CLI on launch.
+
+### Tool Compatibility
+
+When a tool mode is active (via `Z`), models incompatible with that tool are highlighted with a dark red background so you can instantly see which models work with your current tool.
+
+| Model Type | Compatible Tools |
+|------------|-----------------|
+| Regular (NVIDIA, Groq, etc.) | All tools except 🦘 Rovo and ♊ Gemini |
+| Rovo | 🦘 Rovo Dev CLI only |
+| Gemini | ♊ Gemini CLI only |
+| OpenCode Zen | 📦 OpenCode CLI and 📦 OpenCode Desktop only |
+
 → **[Full flags reference](./docs/flags.md)**
 
 ---
@@ -204,7 +257,7 @@ Press **`Z`** in the TUI to cycle between tools without restarting.
 
 ## ✨ Features
 
-- **Parallel pings** — all 160 models tested simultaneously via native `fetch`
+- **Parallel pings** — all 174 models tested simultaneously via native `fetch`
 - **Adaptive monitoring** — 2s burst for 60s → 10s normal → 30s idle
 - **Stability score** — composite 0–100 (p95 latency, jitter, spike rate, uptime)
 - **Smart ranking** — top 3 highlighted 🥇🥈🥉
@@ -215,6 +268,8 @@ Press **`Z`** in the TUI to cycle between tools without restarting.
 - **⚡️ Command Palette** — `Ctrl+P` opens a searchable action launcher for filters, sorting, overlays, and quick toggles
 - **Install Endpoints** — push a full provider catalog into any tool's config (from Settings `P` or ⚡️ Command Palette)
 - **Missing tool bootstrap** — detect absent CLIs, offer one-click install, then continue the selected launch automatically
+- **Tool compatibility matrix** — incompatible rows highlighted in dark red when a tool mode is active
+- **OpenCode Zen models** — 8 free models exclusive to OpenCode CLI/Desktop, powered by the Zen AI gateway
 - **Width guardrail** — shows a warning instead of a broken table in narrow terminals
 - **Readable everywhere** — semantic theme palette keeps table rows, overlays, badges, and help screens legible in dark and light terminals
 - **Global theme switch** — `G` cycles `auto`, `dark`, and `light` live without restarting

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.23",
+  "version": "0.3.25",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/sources.js

@@ -344,6 +344,40 @@ export const iflow = [
   ['qwen3-max',                               'Qwen3 Max',           'A+', '55.0%', '256k'],
 ]
 
+// 📖 Rovo Dev CLI source - https://www.atlassian.com/rovo
+// 📖 CLI tool only - no API endpoint - requires 'acli rovodev run'
+// 📖 Install: https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/
+// 📖 Free tier: 5M tokens/day (beta) - Claude Sonnet 4 (72.7% SWE-bench)
+// 📖 Requires Atlassian account + Rovo Dev activated on your site
+export const rovo = [
+  ['anthropic/claude-sonnet-4',         'Claude Sonnet 4 🆕',   'S+', '72.7%', '200k'],
+]
+
+// 📖 Gemini CLI source - https://github.com/google-gemini/gemini-cli
+// 📖 CLI tool with OpenAI-compatible API support
+// 📖 Install: npm install -g @google/gemini-cli
+// 📖 Free tier: 1,000 req/day with personal Google account (no credit card)
+// 📖 Models: Gemini 3 Pro (76.2% SWE-bench), Gemini 2.5 Pro, Gemini 2.5 Flash
+// 📖 Supports custom OpenAI-compatible providers via GEMINI_API_BASE_URL
+export const gemini = [
+  ['google/gemini-3-pro',               'Gemini 3 Pro 🆕',      'S+', '76.2%', '1M'],
+  ['google/gemini-2.5-pro',             'Gemini 2.5 Pro',      'S+', '63.2%', '1M'],
+  ['google/gemini-2.5-flash',           'Gemini 2.5 Flash',    'A+', '50.0%', '1M'],
+]
+
+// 📖 OpenCode Zen free models — hosted AI gateway accessed through OpenCode CLI/Desktop
+// 📖 Endpoint: https://opencode.ai/zen/v1/... — requires OpenCode Zen API key
+// 📖 These models are FREE on the Zen platform and only run on OpenCode CLI or OpenCode Desktop
+// 📖 Login: https://opencode.ai/auth — get your Zen API key
+// 📖 Config: set provider to opencode/<model-id> in OpenCode config
+export const opencodeZen = [
+  ['big-pickle',                              'Big Pickle 🆕',             'S+', '72.0%', '200k'],
+  ['gpt-5-nano',                              'GPT 5 Nano 🆕',            'S',  '65.0%', '128k'],
+  ['mimo-v2-flash-free',                      'MiMo V2 Flash Free 🆕',    'S+', '73.4%', '256k'],
+  ['minimax-m2.5-free',                       'MiniMax M2.5 Free 🆕',     'S+', '80.2%', '200k'],
+  ['nemotron-3-super-free',                   'Nemotron 3 Super Free 🆕',  'A+', '52.0%', '128k'],
+]
+
 // 📖 All sources combined - used by the main script
 // 📖 Each source has: name (display), url (API endpoint), models (array of model tuples)
 export const sources = {
@@ -447,6 +481,32 @@ export const sources = {
     url: 'https://apis.iflow.cn/v1/chat/completions',
     models: iflow,
   },
+  // 📖 CLI-only tools (no API endpoint - launched directly)
+  rovo: {
+    name: 'Rovo Dev CLI',
+    url: null, // CLI tool - no API endpoint
+    models: rovo,
+    cliOnly: true,
+    installUrl: 'https://support.atlassian.com/rovo/docs/install-and-run-rovo-dev-cli-on-your-device/',
+    binary: 'acli',
+    checkArgs: ['rovodev', '--help'],
+  },
+  gemini: {
+    name: 'Gemini CLI',
+    url: null, // CLI tool - no API endpoint (can use OpenAI-compatible via env)
+    models: gemini,
+    cliOnly: true,
+    installUrl: 'https://github.com/google-gemini/gemini-cli',
+    binary: 'gemini',
+    checkArgs: ['--version'],
+  },
+  // 📖 OpenCode Zen free models — hosted AI gateway, only runs on OpenCode CLI / Desktop
+  'opencode-zen': {
+    name: 'OpenCode Zen',
+    url: 'https://opencode.ai/zen/v1/chat/completions',
+    models: opencodeZen,
+    zenOnly: true,
+  },
 }
 
 // 📖 Flatten all models from all sources — each entry includes providerKey as 6th element

package/src/app.js

@@ -119,7 +119,8 @@ import { renderTable, PROVIDER_COLOR } from '../src/render-table.js'
 import { setOpenCodeModelData, startOpenCode, startOpenCodeDesktop } from '../src/opencode.js'
 import { startOpenClaw } from '../src/openclaw.js'
 import { createOverlayRenderers } from '../src/overlays.js'
-import { createKeyHandler } from '../src/key-handler.js'
+import { createKeyHandler, createMouseEventHandler } from '../src/key-handler.js'
+import { createMouseHandler, containsMouseSequence } from '../src/mouse.js'
 import { getToolModeOrder, getToolMeta } from '../src/tool-metadata.js'
 import { startExternalTool } from '../src/tool-launchers.js'
 import { getToolInstallPlan, installToolWithPlan, isToolInstalled } from '../src/tool-bootstrap.js'
@@ -233,6 +234,8 @@ export async function runApp(cliArgs, config) {
       openhands: cliArgs.openHandsMode,
       amp: cliArgs.ampMode,
       pi: cliArgs.piMode,
+      rovo: cliArgs.rovoMode,
+      gemini: cliArgs.geminiMode,
     }
     return flagByMode[toolMode] === true
   })
@@ -389,7 +392,7 @@ export async function runApp(cliArgs, config) {
       terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
       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).
+    widthWarningShowCount: 0, // 📖 No longer used — kept for backward compatibility. Warning now shows every time terminal is too small.
     // 📖 Settings screen state (P key opens it)
     settingsOpen: false,          // 📖 Whether settings overlay is active
     settingsCursor: 0,            // 📖 Which provider row is selected in settings
@@ -434,6 +437,15 @@ export async function runApp(cliArgs, config) {
     toolInstallPromptModel: null,
     toolInstallPromptPlan: null,
     toolInstallPromptErrorMsg: null,
+    // 📖 Incompatible model fallback overlay — shown when user presses Enter on a red-highlighted model.
+    // 📖 Offers two options: switch to a compatible tool, or pick a similar SWE-scored model.
+    incompatibleFallbackOpen: false,
+    incompatibleFallbackCursor: 0,
+    incompatibleFallbackScrollOffset: 0,
+    incompatibleFallbackModel: null,        // 📖 The incompatible model the user tried to launch
+    incompatibleFallbackTools: [],           // 📖 Compatible tools for the selected model
+    incompatibleFallbackSimilarModels: [],   // 📖 Similar SWE models compatible with current tool
+    incompatibleFallbackSection: 'tools',    // 📖 'tools' or 'models' — which section cursor is in
     // 📖 Smart Recommend overlay state (Q key opens it)
     recommendOpen: false,         // 📖 Whether the recommend overlay is active
     recommendPhase: 'questionnaire', // 📖 'questionnaire'|'analyzing'|'results' — current phase
@@ -472,7 +484,6 @@ export async function runApp(cliArgs, config) {
       if (prevCols >= WIDTH_WARNING_MIN_COLS || state.widthWarningDismissed) {
         state.widthWarningStartedAt = Date.now()
         state.widthWarningDismissed = false
-        state.widthWarningShowCount++ // 📖 Increment counter when showing the warning again
       } else if (!state.widthWarningStartedAt) {
         state.widthWarningStartedAt = Date.now()
       }
@@ -485,6 +496,7 @@ export async function runApp(cliArgs, config) {
 
   let ticker = null
   let onKeyPress = null
+  let onMouseData = null  // 📖 Mouse data listener — set after createMouseEventHandler
   let pingModel = null
 
   const scheduleNextPing = () => {
@@ -684,7 +696,11 @@ export async function runApp(cliArgs, config) {
         r.hidden = false
         return
       }
-      const unconfiguredHide = state.hideUnconfiguredModels && !getApiKey(state.config, r.providerKey)
+      // 📖 CLI-only tools (rovo, gemini) and Zen models don't need traditional API keys —
+      // 📖 they authenticate via their own CLI login flow, so "configured only" should never hide them.
+      const providerMeta = PROVIDER_METADATA[r.providerKey]
+      const noKeyNeeded = providerMeta?.cliOnly || providerMeta?.zenOnly
+      const unconfiguredHide = state.hideUnconfiguredModels && !noKeyNeeded && !getApiKey(state.config, r.providerKey)
       if (unconfiguredHide) {
         r.hidden = true
         return
@@ -722,6 +738,7 @@ export async function runApp(cliArgs, config) {
     if (ticker) clearInterval(ticker)
     clearTimeout(state.pingIntervalObj)
     if (onKeyPress) process.stdin.removeListener('keypress', onKeyPress)
+    if (onMouseData) process.stdin.removeListener('data', onMouseData)
     if (process.stdin.isTTY && resetRawMode) process.stdin.setRawMode(false)
     process.stdin.pause()
     process.stdout.write(ALT_LEAVE)
@@ -800,6 +817,7 @@ export async function runApp(cliArgs, config) {
     startOpenCode,
     startExternalTool,
     getToolModeOrder,
+    getToolMeta,
     getToolInstallPlan,
     isToolInstalled,
     installToolWithPlan,
@@ -822,6 +840,38 @@ export async function runApp(cliArgs, config) {
     readline,
   })
 
+  // 📖 Mouse event handler: translates parsed mouse events into TUI actions (sort, cursor, scroll).
+  const onMouseEvent = createMouseEventHandler({
+    state,
+    adjustScrollOffset,
+    applyTierFilter,
+    TIER_CYCLE,
+    ORIGIN_CYCLE,
+    noteUserActivity,
+    sortResultsWithPinnedFavorites,
+    saveConfig,
+    overlayLayout: overlays.overlayLayout, // 📖 Overlay cursor-to-line maps for click handling
+    // 📖 Favorite toggle — right-click on model rows
+    toggleFavoriteModel,
+    syncFavoriteFlags,
+    toFavoriteKey,
+    // 📖 Tool mode cycling — compat header click
+    cycleToolMode: () => {
+      // 📖 Inline cycle matching the Z-key handler in createKeyHandler
+      const modeOrder = getToolModeOrder()
+      const currentIndex = modeOrder.indexOf(state.mode)
+      const nextIndex = (currentIndex + 1) % modeOrder.length
+      state.mode = modeOrder[nextIndex]
+      if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+      state.config.settings.preferredToolMode = state.mode
+      saveConfig(state.config)
+    },
+  })
+
+  // 📖 Wire the raw stdin data listener for mouse events.
+  // 📖 createMouseHandler returns a function that parses SGR sequences and calls onMouseEvent.
+  onMouseData = createMouseHandler({ onMouseEvent })
+
   // Apply CLI --tier filter if provided
   if (cliArgs.tierFilter) {
     const allowed = TIER_LETTER_MAP[cliArgs.tierFilter]
@@ -843,8 +893,35 @@ export async function runApp(cliArgs, config) {
     process.stdin.setRawMode(true)
   }
 
+  // 📖 Mouse sequence suppression: readline.emitKeypressEvents() registers its own
+  // 📖 internal `data` listener that parses bytes and fires `keypress` events.
+  // 📖 When a mouse SGR sequence like \x1b[<0;35;20m arrives, readline fragments it
+  // 📖 and emits individual keypress events for chars like 'm', '0', ';' etc.
+  // 📖 The 'm' at the end of a release event maps to the Model sort hotkey!
+  // 📖
+  // 📖 Fix: use prependListener to register a `data` handler BEFORE readline's,
+  // 📖 so we can set a suppression flag before any keypress events fire.
+  // 📖 The flag is cleared on the next tick via setImmediate after all synchronous
+  // 📖 keypress emissions from readline have completed.
+  let _suppressMouseKeypresses = false
+
+  process.stdin.prependListener('data', (data) => {
+    const str = typeof data === 'string' ? data : data.toString('utf8')
+    if (str.includes('\x1b[<')) {
+      _suppressMouseKeypresses = true
+      // 📖 Reset after current tick — all synchronous keypress events from this data
+      // 📖 chunk will have fired by then.
+      setImmediate(() => { _suppressMouseKeypresses = false })
+    }
+  })
+
   process.stdin.on('keypress', async (str, key) => {
     try {
+      // 📖 Skip keypress events that originate from mouse escape sequences.
+      // 📖 readline may partially parse SGR mouse sequences as garbage keypresses.
+      if (str && containsMouseSequence(str)) return
+      // 📖 Suppress fragmented mouse bytes that readline emits as individual keypresses.
+      if (_suppressMouseKeypresses) return
       await onKeyPress(str, key);
     } catch (err) {
       process.stdout.write(ALT_LEAVE);
@@ -854,6 +931,18 @@ export async function runApp(cliArgs, config) {
       process.exit(1);
     }
   })
+
+  // 📖 Mouse data listener: parses SGR mouse escape sequences from raw stdin
+  // 📖 and dispatches structured events (click, scroll, double-click) to the mouse handler.
+  process.stdin.on('data', (data) => {
+    try {
+      if (onMouseData) onMouseData(data)
+    } catch (err) {
+      // 📖 Mouse errors are non-fatal — log and continue so the TUI doesn't crash.
+      // 📖 This could happen on terminals that send unexpected mouse sequences.
+    }
+  })
+
   process.on('SIGCONT', noteUserActivity)
 
   // 📖 Animation loop: render settings overlay, recommend overlay, help overlay, feature request overlay, bug report overlay, changelog overlay, OR main table
@@ -862,7 +951,7 @@ export async function runApp(cliArgs, config) {
     refreshAutoPingMode()
     state.frame++
     // 📖 Cache visible+sorted models each frame so Enter handler always matches the display
-    if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.recommendOpen && !state.feedbackOpen && !state.changelogOpen && !state.commandPaletteOpen) {
+    if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.incompatibleFallbackOpen && !state.recommendOpen && !state.feedbackOpen && !state.changelogOpen && !state.commandPaletteOpen) {
       const visible = state.results.filter(r => !r.hidden)
       state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection, {
         pinFavorites: state.favoritesPinnedAndSticky,
@@ -945,6 +1034,8 @@ export async function runApp(cliArgs, config) {
         ? overlays.renderInstallEndpoints()
       : state.toolInstallPromptOpen
         ? overlays.renderToolInstallPrompt()
+      : state.incompatibleFallbackOpen
+        ? overlays.renderIncompatibleFallback()
       : state.commandPaletteOpen
         ? tableContent + overlays.renderCommandPalette()
       : state.recommendOpen
@@ -975,7 +1066,7 @@ export async function runApp(cliArgs, config) {
     pinFavorites: state.favoritesPinnedAndSticky,
   })
 
-  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.favoritesPinnedAndSticky, state.customTextFilter))
+      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.favoritesPinnedAndSticky, state.customTextFilter))
   if (process.stdout.isTTY) {
     process.stdout.flush && process.stdout.flush()
   }

package/src/command-palette.js

@@ -28,13 +28,15 @@ const TOOL_MODE_DESCRIPTIONS = {
   qwen: 'Launch Qwen Code using the selected provider model.',
   openhands: 'Launch OpenHands with the selected model endpoint.',
   amp: 'Launch Amp with this model as active target.',
+  rovo: 'Rovo Dev CLI model (launch with Rovo tool only).',
+  gemini: 'Gemini CLI model (launch with Gemini tool only).',
 }
 
 const TOOL_MODE_COMMANDS = TOOL_MODE_ORDER.map((toolMode) => {
   const meta = TOOL_METADATA[toolMode] || { label: toolMode, emoji: '🧰' }
   return {
     id: `action-set-tool-${toolMode}`,
-    label: meta.label,
+    label: `${meta.emoji} ${meta.label}`,
     toolMode,
     icon: meta.emoji,
     description: TOOL_MODE_DESCRIPTIONS[toolMode] || 'Set this as the active launch target.',

package/src/constants.js

@@ -47,8 +47,11 @@ import chalk from 'chalk'
 // 📖 \x1b[H      = cursor to top
 // 📖 \x1b[?7l disables auto-wrap so wide rows clip at the right edge instead of
 // 📖 wrapping to the next line (which would double the row height and overflow).
-export const ALT_ENTER = '\x1b[?1049h\x1b[?25l\x1b[?7l'
-export const ALT_LEAVE = '\x1b[?7h\x1b[?1049l\x1b[?25h'
+// 📖 Mouse tracking sequences are appended/prepended so clicks and scroll work in the TUI.
+import { MOUSE_ENABLE, MOUSE_DISABLE } from './mouse.js'
+
+export const ALT_ENTER = '\x1b[?1049h\x1b[?25l\x1b[?7l' + MOUSE_ENABLE
+export const ALT_LEAVE = MOUSE_DISABLE + '\x1b[?7h\x1b[?1049l\x1b[?25h'
 export const ALT_HOME  = '\x1b[H'
 
 // 📖 Timing constants — control how fast the health-check loop runs.

package/src/endpoint-installer.js

@@ -48,7 +48,8 @@ import { getApiKey, saveConfig } from './config.js'
 import { ENV_VAR_NAMES, PROVIDER_METADATA } from './provider-metadata.js'
 import { getToolMeta } from './tool-metadata.js'
 
-const DIRECT_INSTALL_UNSUPPORTED_PROVIDERS = new Set(['replicate', 'zai'])
+// 📖 CLI-only providers (rovo, gemini) and Zen-only (opencode-zen) cannot be installed into other tools.
+const DIRECT_INSTALL_UNSUPPORTED_PROVIDERS = new Set(['replicate', 'zai', 'rovo', 'gemini', 'opencode-zen'])
 // 📖 Install Endpoints only lists tools whose persisted config shape is actually supported here.
 // 📖 Claude Code, Codex, and Gemini stay out while their dedicated bridges are being rebuilt.
 const INSTALL_TARGET_MODES = ['opencode', 'opencode-desktop', 'openclaw', 'crush', 'goose', 'pi', 'aider', 'qwen', 'openhands', 'amp']