free-coding-models 0.3.22 → 0.3.24

package/CHANGELOG.md

@@ -1,6 +1,54 @@
 # Changelog
 ---
 
+## [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
+- **Favorites display mode (`Y`)**: Added a global toggle to switch favorites between `pinned + always visible` and `normal rows` (starred only, fully obeying active filters/sort).
+- **Favorites mode row in Settings**: Added a dedicated Settings row to inspect/toggle favorites display behavior without leaving the maintenance screen.
+- **Expanded command palette action menus**: Added nested menus for Ping Mode (speed/normal/slow/forced with explanations), Target Tool (all supported tools with explanations), and Favorites Mode (including the new `Y` flow).
+- **Active text-filter footer alert**: When a custom search filter is active (for example `deep`), the last TUI footer line now shows a high-visibility inline badge (between `N Changelog` and `Ctrl+C Exit`) with the exact query and an `X` shortcut to clear it instantly.
+
+### Changed
+- **Favorites sorting/filtering behavior**: Sort/filter logic now respects the selected favorites mode across the table refresh loop, hotkeys, and renderer so non-pinned mode behaves consistently everywhere.
+- **Favorites default mode**: New/legacy configs now default to `Normal filter/sort` favorites mode (not pinned) until users press `Y` to opt into pinned+sticky behavior.
+- **Footer/help/docs shortcut hints**: Surfaced `Y` in the TUI footer, Help overlay, and README so the new favorites mode is discoverable.
+
 ## 0.3.22
 
 ### 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
+
+The TUI shows a **"Compatible with"** column displaying colored emojis for each supported tool. 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)**
 
 ---
@@ -185,6 +238,8 @@ Press **`Z`** in the TUI to cycle between tools without restarting.
 | `D` | Cycle provider filter |
 | `E` | Toggle configured-only mode |
 | `F` | Favorite / unfavorite model |
+| `Y` | Toggle favorites mode (`Normal filter/sort` default ↔ `Pinned + always visible`) |
+| `X` | Clear active custom text filter |
 | `G` | Cycle global theme (`Auto → Dark → Light`) |
 | `Ctrl+P` | Open ⚡️ command palette (search + run actions) |
 | `R/S/C/M/O/L/A/H/V/B/U` | Sort columns |
@@ -202,17 +257,19 @@ 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 🥇🥈🥉
-- **Favorites** — pin models with `F`, persisted across sessions
+- **Favorites** — star models with `F`, persisted across sessions, default to normal rows, and switch display mode with `Y` (pinned+sticky vs normal rows)
 - **Configured-only default** — only shows providers you have keys for
 - **Keyless latency** — models ping even without an API key (show 🔑 NO KEY)
 - **Smart Recommend** — questionnaire picks the best model for your task type
 - **⚡️ 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 (`Y`)
+- **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** — colored emojis show which tools each model supports; 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.22",
+  "version": "0.3.24",
   "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

@@ -21,8 +21,8 @@
  *   - JSON config stored in ~/.free-coding-models.json (auto-migrates from old plain-text)
  *   - Multi-provider support via sources.js (NIM/Groq/Cerebras/OpenRouter/Hugging Face/Replicate/DeepInfra/... — extensible)
  *   - Settings screen (P key) to manage API keys, provider toggles, manual updates, and provider-key diagnostics
- *   - Install Endpoints flow (Y key) to push provider catalogs into OpenCode, OpenClaw, Crush, and Goose
- *   - Favorites system: toggle with F, pin rows to top, persist between sessions
+ *   - Install Endpoints flow (Settings / Command Palette) to push provider catalogs into OpenCode, OpenClaw, Crush, and Goose
+ *   - Favorites system: toggle with F, switch pinning mode with Y, persist between sessions
  *   - Uptime percentage tracking (successful pings / total pings)
  *   - Sortable columns (R/O/M/L/A/S/C/H/V/B/U/G keys)
  *   - Tier filtering via T key (cycles S+→S→A+→A→A-→B+→B→C→All)
@@ -233,6 +233,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
   })
@@ -307,7 +309,7 @@ export async function runApp(cliArgs, config) {
   }
 
   // 📖 Re-sync tracked external-tool catalogs after the live provider catalog has settled.
-  // 📖 This keeps prior `Y` installs aligned with the current FCM model list.
+  // 📖 This keeps prior endpoint installs aligned with the current FCM model list.
   refreshInstalledEndpoints(config)
 
   // 📖 Build results from MODELS — only include enabled providers
@@ -383,12 +385,13 @@ export async function runApp(cliArgs, config) {
     tierFilterMode: 0,            // 📖 Index into TIER_CYCLE (0=All, 1=S+, 2=S, ...)
     originFilterMode: 0,          // 📖 Index into ORIGIN_CYCLE (0=All, then providers)
     hideUnconfiguredModels: config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
+    favoritesPinnedAndSticky: config.settings?.favoritesPinnedAndSticky === true, // 📖 false by default: favorites follow normal sort/filter rules until Y enables pinned+sticky mode.
       scrollOffset: 0,              // 📖 First visible model index in viewport
       terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
       terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
       widthWarningStartedAt: (process.stdout.columns || 80) < 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
@@ -409,11 +412,11 @@ export async function runApp(cliArgs, config) {
     commandPaletteScrollOffset: 0, // 📖 Vertical scroll offset for the command palette result viewport.
     commandPaletteResults: [],    // 📖 Cached fuzzy-filtered command entries for the command palette.
     commandPaletteFrozenTable: null, // 📖 Frozen table snapshot rendered behind the command palette overlay.
-    commandPaletteExpandedIds: new Set(['filters']), // 📖 Set of expanded category/subcategory IDs (filters expanded by default for quick access).
+    commandPaletteExpandedIds: new Set(['filters', 'actions']), // 📖 Expanded category IDs (filters + actions open by default for quick access).
     helpVisible: false,           // 📖 Whether the help overlay (K key) is active
     settingsScrollOffset: 0,      // 📖 Vertical scroll offset for Settings overlay viewport
     helpScrollOffset: 0,          // 📖 Vertical scroll offset for Help overlay viewport
-    // 📖 Install Endpoints overlay state (Y key opens it)
+    // 📖 Install Endpoints overlay state (opened from Settings or Command Palette)
     installEndpointsOpen: false,  // 📖 Whether the install-endpoints overlay is active
     installEndpointsPhase: 'providers', // 📖 providers | tools | scope | models | result
     installEndpointsCursor: 0,    // 📖 Selected row within the current install phase
@@ -433,6 +436,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
@@ -471,7 +483,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()
       }
@@ -678,12 +689,16 @@ export async function runApp(cliArgs, config) {
     const activeTier = TIER_CYCLE[state.tierFilterMode]
     const activeOrigin = ORIGIN_CYCLE[state.originFilterMode]
     state.results.forEach(r => {
-      // 📖 Favorites stay visible and pinned regardless of configured-only, tier, or provider filters.
-      if (r.isFavorite) {
+      // 📖 Sticky-favorites mode keeps favorites visible regardless of configured-only, tier, or provider filters.
+      if (state.favoritesPinnedAndSticky && r.isFavorite) {
         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
@@ -799,6 +814,7 @@ export async function runApp(cliArgs, config) {
     startOpenCode,
     startExternalTool,
     getToolModeOrder,
+    getToolMeta,
     getToolInstallPlan,
     isToolInstalled,
     installToolWithPlan,
@@ -825,7 +841,7 @@ export async function runApp(cliArgs, config) {
   if (cliArgs.tierFilter) {
     const allowed = TIER_LETTER_MAP[cliArgs.tierFilter]
     state.results.forEach(r => {
-      r.hidden = r.isFavorite ? false : !allowed.includes(r.tier)
+      r.hidden = (state.favoritesPinnedAndSticky && r.isFavorite) ? false : !allowed.includes(r.tier)
     })
   }
 
@@ -861,9 +877,11 @@ 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)
+      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection, {
+        pinFavorites: state.favoritesPinnedAndSticky,
+      })
     }
     let tableContent = null
     if (state.commandPaletteOpen) {
@@ -896,7 +914,9 @@ export async function runApp(cliArgs, config) {
           state.settingsUpdateLatestVersion,
           false,
           state.startupLatestVersion,
-          state.versionAlertsEnabled
+          state.versionAlertsEnabled,
+          state.favoritesPinnedAndSticky,
+          state.customTextFilter
         )
       }
       tableContent = state.commandPaletteFrozenTable
@@ -928,7 +948,9 @@ export async function runApp(cliArgs, config) {
         state.settingsUpdateLatestVersion,
         false,
         state.startupLatestVersion,
-        state.versionAlertsEnabled
+        state.versionAlertsEnabled,
+        state.favoritesPinnedAndSticky,
+        state.customTextFilter
       )
     }
 
@@ -938,6 +960,8 @@ export async function runApp(cliArgs, config) {
         ? overlays.renderInstallEndpoints()
       : state.toolInstallPromptOpen
         ? overlays.renderToolInstallPrompt()
+      : state.incompatibleFallbackOpen
+        ? overlays.renderIncompatibleFallback()
       : state.commandPaletteOpen
         ? tableContent + overlays.renderCommandPalette()
       : state.recommendOpen
@@ -964,9 +988,11 @@ export async function runApp(cliArgs, config) {
 
   // 📖 Populate visibleSorted before the first frame so Enter works immediately
   const initialVisible = state.results.filter(r => !r.hidden)
-  state.visibleSorted = sortResultsWithPinnedFavorites(initialVisible, state.sortColumn, state.sortDirection)
+  state.visibleSorted = sortResultsWithPinnedFavorites(initialVisible, state.sortColumn, state.sortDirection, {
+    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))
+      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

@@ -15,6 +15,74 @@
  * @see src/overlays.js
  */
 
+import { TOOL_METADATA, TOOL_MODE_ORDER } from './tool-metadata.js'
+
+const TOOL_MODE_DESCRIPTIONS = {
+  opencode: 'Launch in OpenCode CLI with the selected model.',
+  'opencode-desktop': 'Set model in shared config, then open OpenCode Desktop.',
+  openclaw: 'Set default model in OpenClaw and launch it.',
+  crush: 'Launch Crush with this provider/model pair.',
+  goose: 'Launch Goose and preselect the active model.',
+  pi: 'Launch Pi with model/provider flags.',
+  aider: 'Launch Aider configured on the selected model.',
+  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.emoji} ${meta.label}`,
+    toolMode,
+    icon: meta.emoji,
+    description: TOOL_MODE_DESCRIPTIONS[toolMode] || 'Set this as the active launch target.',
+    keywords: ['tool', 'target', 'mode', toolMode, meta.label.toLowerCase()],
+  }
+})
+
+const PING_MODE_COMMANDS = [
+  {
+    id: 'action-cycle-ping-mode',
+    label: 'Cycle ping mode',
+    shortcut: 'W',
+    icon: '⚡',
+    description: 'Rotate speed → normal → slow → forced.',
+    keywords: ['ping', 'mode', 'cycle', 'speed', 'normal', 'slow', 'forced'],
+  },
+  {
+    id: 'action-set-ping-speed',
+    label: 'Speed mode (2s)',
+    pingMode: 'speed',
+    description: 'Fast 2s bursts for short live checks.',
+    keywords: ['ping', 'mode', 'speed', '2s', 'fast'],
+  },
+  {
+    id: 'action-set-ping-normal',
+    label: 'Normal mode (10s)',
+    pingMode: 'normal',
+    description: 'Balanced default cadence for daily use.',
+    keywords: ['ping', 'mode', 'normal', '10s', 'default'],
+  },
+  {
+    id: 'action-set-ping-slow',
+    label: 'Slow mode (30s)',
+    pingMode: 'slow',
+    description: 'Lower refresh cost when you are mostly idle.',
+    keywords: ['ping', 'mode', 'slow', '30s', 'idle'],
+  },
+  {
+    id: 'action-set-ping-forced',
+    label: 'Forced mode (4s)',
+    pingMode: 'forced',
+    description: 'Keeps 4s cadence until manually changed.',
+    keywords: ['ping', 'mode', 'forced', '4s', 'manual'],
+  },
+]
+
 // 📖 Base command tree template (will be enhanced with dynamic model list)
 const BASE_COMMAND_TREE = [
   {
@@ -93,6 +161,41 @@ const BASE_COMMAND_TREE = [
       { id: 'sort-uptime', label: 'Sort by uptime', shortcut: 'U', description: 'Success rate', keywords: ['sort', 'uptime'] },
     ]
   },
+  {
+    id: 'actions',
+    label: 'Actions',
+    icon: '⚙️',
+    children: [
+      {
+        id: 'action-target-tool',
+        label: 'Target tool',
+        icon: '🧰',
+        children: [
+          { id: 'action-cycle-tool-mode', label: 'Cycle target tool', shortcut: 'Z', icon: '🔄', description: 'Rotate through every launcher mode.', keywords: ['tool', 'mode', 'cycle', 'target'] },
+          ...TOOL_MODE_COMMANDS,
+        ],
+      },
+      {
+        id: 'action-ping-mode',
+        label: 'Ping mode',
+        icon: '📶',
+        children: PING_MODE_COMMANDS,
+      },
+      {
+        id: 'action-favorites-mode',
+        label: 'Favorites mode',
+        icon: '⭐',
+        children: [
+          { id: 'action-toggle-favorite-mode', label: 'Toggle favorites mode', shortcut: 'Y', icon: '⭐', description: 'Switch pinned+sticky ↔ normal list behavior.', keywords: ['favorite', 'favorites', 'mode', 'toggle', 'y'] },
+          { id: 'action-favorites-mode-pinned', label: 'Pinned + always visible', favoritesPinned: true, description: 'Favorites stay on top and bypass current filters.', keywords: ['favorite', 'favorites', 'pinned', 'sticky', 'always visible'] },
+          { id: 'action-favorites-mode-normal', label: 'Normal rows (starred only)', favoritesPinned: false, description: 'Favorites keep ⭐ but follow active filters and sort.', keywords: ['favorite', 'favorites', 'normal', 'sort', 'filter'] },
+          { id: 'action-toggle-favorite', label: 'Toggle favorite on selected row', shortcut: 'F', icon: '⭐', description: 'Star/unstar the highlighted model.', keywords: ['favorite', 'star', 'toggle'] },
+        ],
+      },
+      { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
+      { id: 'action-reset-view', label: 'Reset view', shortcut: 'Shift+R', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+    ],
+  },
   // 📖 Pages - directly at root level, not in submenu
   { id: 'open-settings', label: 'Settings', shortcut: 'P', icon: '⚙️', type: 'page', description: 'API keys and preferences', keywords: ['settings', 'config', 'api key'] },
   { id: 'open-help', label: 'Help', shortcut: 'K', icon: '❓', type: 'page', description: 'Show all shortcuts', keywords: ['help', 'shortcuts', 'hotkeys'] },
@@ -100,12 +203,6 @@ const BASE_COMMAND_TREE = [
   { id: 'open-feedback', label: 'Feedback', shortcut: 'I', icon: '📝', type: 'page', description: 'Report bugs or requests', keywords: ['feedback', 'bug', 'request'] },
   { id: 'open-recommend', label: 'Smart recommend', shortcut: 'Q', icon: '🎯', type: 'page', description: 'Find best model for task', keywords: ['recommend', 'best model'] },
   { id: 'open-install-endpoints', label: 'Install endpoints', icon: '🔌', type: 'page', description: 'Install provider catalogs', keywords: ['install', 'endpoints', 'providers'] },
-  // 📖 Actions - directly at root level, not in submenu
-  { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', type: 'action', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
-  { id: 'action-cycle-tool-mode', label: 'Target Tool', shortcut: 'Z', icon: '🔄', type: 'action', description: 'Change target AI Coding CLI Tool.', keywords: ['tool', 'mode', 'launcher', 'target'] },
-  { id: 'action-cycle-ping-mode', label: 'Cycle ping mode', shortcut: 'W', icon: '⚡', type: 'action', description: 'Adjust ping speed', keywords: ['ping', 'cadence', 'speed', 'slow'] },
-  { id: 'action-toggle-favorite', label: 'Toggle favorite', shortcut: 'F', icon: '⭐', type: 'action', description: 'Pin to favorites', keywords: ['favorite', 'star'] },
-  { id: 'action-reset-view', label: 'Reset view', shortcut: 'Shift+R', icon: '🔄', type: 'action', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
 ]
 
 /**