free-coding-models 0.3.66 → 0.3.68

package/changelog/v0.3.18.md

@@ -0,0 +1,12 @@
+# Changelog v0.3.18 - 2026-03-18
+
+### Added
+- **Missing tool bootstrap flow**: FCM now detects when a target CLI is absent, offers a minimal in-TUI install confirmation, runs the official global install command, then resumes the selected model launch automatically.
+
+### Changed
+- **TUI readability overhaul across every screen**: the main table, Settings, Help, Smart Recommend, Feedback, and Changelog overlays now share a semantic high-contrast theme system instead of a patchwork of hardcoded colors.
+- **Global theme switching now works for real**: press `G` to cycle `auto → dark → light` live, and the Settings screen now exposes a visible `Global Theme` row for the same control.
+- **Launcher binary resolution**: direct tool launches now search PATH plus common user bin directories so a freshly installed CLI can be reused immediately in the same FCM session.
+
+### Fixed
+- **Theme repaint bugs**: provider colors, tier colors, separators, badges, cursor highlights, and overlay backgrounds now update immediately when the theme changes instead of keeping stale import-time colors.

package/changelog/v0.3.19.md

@@ -0,0 +1,12 @@
+# Changelog v0.3.19 - 2026-03-18
+
+### Added
+- **Command palette overlay (`Ctrl+P`)**: Added a searchable floating palette with fuzzy matching so users can quickly run filters, sorts, overlays, and global actions.
+
+### Changed
+- **Main footer and help discoverability**: surfaced `Ctrl+P` in table hints and Help overlay so the new command launcher is visible immediately.
+- **Command palette spacing polish**: added two-character inner padding around the floating palette so the overlay feels less cramped and visually cleaner.
+
+### Fixed
+- **Command palette visual jitter**: background ping cycles now pause while the command palette is open so table rows stop reshuffling during command search.
+- **Command palette background freeze**: while the palette is open, the full table behind it is now frozen (spinner glyphs, ping countdown, and dynamic row updates) and resumes instantly on close.

package/changelog/v0.3.2.md

@@ -0,0 +1,5 @@
+# Changelog v0.3.2 - 2026-03-16
+
+### Fixed
+- **Claude Code model-family routing now mirrors `free-claude-code`**: The proxy remaps Claude's internal model ids like `claude-3-5-sonnet-*`, `claude-3-haiku-*`, `claude-3-opus-*`, `sonnet`, `haiku`, and `default` back to the selected FCM proxy model instead of rejecting them as missing.
+- **Claude Code helper/background requests stay on the selected model**: Launches now pin the Anthropic helper model env vars and encode the selected proxy model inside `ANTHROPIC_AUTH_TOKEN`, so Claude Code has a stable fallback even when it emits internal aliases.

package/changelog/v0.3.21.md

@@ -0,0 +1,13 @@
+# Changelog v0.3.21 - 2026-03-18
+
+### Changed
+- **Responsive table layout**: the TUI now adapts to narrow terminals by progressively shrinking columns and hiding least-useful ones. Compact mode shortens headers (`Lat. P`, `Avg. P`, `StaB.`, `PrOD…`) and tightens Provider (10 cols), Health (13 cols), Latest Ping (10 cols), and Avg Ping (8 cols). Below compact, Rank → Up% → Tier → Stability are hidden one by one. Minimum usable width: ~116 cols.
+- **SWE% column tightened**: reduced from 9 to 6 columns wide — trims excess right padding without losing data.
+- **Provider truncation in compact mode**: provider names longer than 5 chars are truncated to 4 chars + `…` (e.g. `Cere…`).
+- **Health truncation in compact mode**: status text longer than 6 chars is truncated with `…` (e.g. `🔥 429 TR…`).
+- **Removed "Used" column from TUI**: the token usage column has been removed from the main table as it was outdated.
+- **Width guardrail threshold tightened**: the narrow-terminal warning now triggers only below 80 columns (instead of broader widths) and keeps the same 2-second auto-hide behavior.
+- **Width warning is always enforced in narrow terminals**: removed the `Small Width Warnings` Settings toggle and the `--disable-widths-warning` runtime flag so the startup guardrail stays consistent.
+
+### Fixed
+- **`--premium` filter lock-in**: premium now applies a resettable startup preset (S-tier + verdict sort) instead of hard-locking an extra hidden elite-only filter.

package/changelog/v0.3.22.md

@@ -0,0 +1,29 @@
+# Changelog v0.3.22 - 2026-03-18
+
+### Added
+- **Hierarchical command palette navigation**: Ctrl+P now opens an improved command palette with expandable/collapsible categories and subcategories for better organization.
+- **Arrow key navigation in command palette**: Use left/right arrows to expand and collapse categories, up/down to navigate, Enter to execute or toggle.
+- **Rich color scheme for command palette**: Categories use bold blue headers, subcategories use bold text, commands show keyboard shortcuts.
+- **Visual expand/collapse indicators**: ▼ shows expanded categories, ▶ shows collapsed, • marks individual commands.
+- **Concise default view**: Categories are collapsed by default (except Filters) showing less detail on first open.
+- **Colored tier filters**: Tier filters (S+, S, A+, A, A-, B+, B, C) now display with their corresponding TUI colors for quick identification.
+- **Specific provider filters**: Added 13 individual provider filters (NVIDIA NIM, Groq, Cerebras, SambaNova, OpenRouter, Together AI, DeepInfra, Fireworks, Hyperbolic, Google AI, Hugging Face) with their signature provider colors.
+- **Filter by model category**: New "Filter by model" category with autocomplete that dynamically shows top 20 visible models, complete with provider icons and colored model names.
+- **Improved search cursor**: Cursor placement fixed to appear right after the `>` prompt instead of after placeholder text for natural typing flow.
+- **Lightning bolt in title**: Command Palette title now shows ⚡ emoji for better visibility and visual appeal.
+
+### Changed
+- **Footer layout cleanup**: Added consistent spacing before `F Toggle Favorite`, moved `N Changelog • Ctrl+C Exit` to a dedicated final footer line for better readability.
+- **Removed Y key binding**: Install Endpoints is no longer a direct hotkey — accessible only via Settings (`P`) or Command Palette (`Ctrl+P`). The `Y` key is now free/unbound.
+- **Removed proxy notice from footer**: The "Proxy is temporarily disabled" banner has been fully retired from the TUI footer and its backing constant removed.
+- **Command palette fuzzy search fix**: `buildCommandPaletteEntries()` now expands all categories so child commands are visible to fuzzy search.
+- **Flat Pages + Actions in ⚡️ Command Palette**: page entries and action entries are now listed directly at root level (no extra submenu depth) for faster access.
+- **Command explanations after shortcuts**: command palette rows now show concise English hints after hotkeys (example: `(Z) — Change target AI Coding CLI Tool.`).
+- **⚡️ emoji consistency**: user-facing Command Palette mentions now consistently render as `⚡️ Command Palette` in TUI and docs.
+- **README Quick Start flow**: install section now explicitly adds “create a free account on one of the providers” with a direct anchor link.
+- **Provider section renamed for clarity**: Quick Start provider table now lives under `List of Free AI Providers`.
+- **Quick Start CTA highlight**: added a large green `USE ⚡️ COMMAND PALETTE / CTRL+P` badge right after the command palette instruction.
+
+### Fixed
+- **Double emoji display bug**: Fixed duplicate emoji icons in command palette entries (was showing `▶ 🔍 🔍 Filters` instead of `▶ 🔍 Filters`).
+- **Provider cycle command behavior**: `Cycle provider` in ⚡️ Command Palette now correctly cycles providers again instead of resetting to `All`.

package/changelog/v0.3.23.md

@@ -0,0 +1,12 @@
+# Changelog v0.3.23 - 2026-03-18
+
+### 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.

package/changelog/v0.3.24.md

@@ -0,0 +1,34 @@
+# Changelog v0.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

package/changelog/v0.3.25.md

@@ -0,0 +1,40 @@
+# Changelog v0.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

package/changelog/v0.3.26.md

@@ -0,0 +1,85 @@
+# Changelog v0.3.26 - 2026-03-27
+
+### Added
+- **Groq**: Added Compound + Compound Mini; fixed Llama 4 Scout context (10M)
+- **OpenRouter**: Added MiniMax M2.5, Nemotron 3 Super, Hermes 3 405B, Gemma 3n E4B
+- **HuggingFace**: Replaced invalid DeepSeek-V3-Coder + outdated starcoder2-15b with DeepSeek V3 0324 + Qwen2.5 Coder 32B
+- **Replicate**: Replaced CodeLlama 70B (2023) with DeepSeek V3 0324 + Llama 3.3 70B
+- **Cloudflare**: Added Kimi K2.5, GLM-4.7-Flash, Llama 4 Scout, Nemotron 3 Super, Qwen3 30B MoE
+- **Scaleway**: Added Qwen3.5 400B VLM + Mistral Large 675B
+- **DeepInfra**: Replaced Mixtral Code with Nemotron 3 Super + DeepSeek V3 0324 + Qwen3 235B
+- **Fireworks**: Added Llama 4 Maverick + Qwen3 235B
+- **Hyperbolic**: Added Qwen3 80B Thinking variant
+- **Together AI**: Added Qwen3.5 400B VLM, MiniMax M2.5, GLM-5
+
+### Changed
+- **Rovo Dev CLI**: Updated Sonnet 4 → Sonnet 4.6, added Opus 4.6
+- **Groq**: Removed 4 deprecated models (R1 Distill 70B, QwQ 32B, Kimi K2, Maverick)
+- **OpenRouter**: Updated context sizes for multiple models
+
+## [0.3.25] - 2026-03-19
+
+### Added
+- **Installed Models Manager** — View, launch, and disable models configured in external tools (Goose, Crush, Aider, Qwen, Pi, OpenHands, Amp)
+  - Access via Command Palette (Ctrl+P) → "Installed models"
+  - Scans all supported tool configs automatically on opening
+  - Displays all models per tool (e.g., Crush shows both large and small models)
+  - Actions: Launch (Enter), Disable (D) with backup, Reinstall (R)
+  - Soft delete: Comments out model entries and saves backups to ~/.free-coding-models-backups.json
+- **Full mouse support for the TUI** — Click, right-click, double-click, and scroll work throughout the interface
+  - **Click column headers** — Sort by any column (click Rank, Tier, SWE%, CTX, Model, Provider, etc.)
+  - **Click model rows** — Move cursor to any model (left-click)
+  - **Right-click model rows** — Toggle favorite (same as F key)
+  - **Double-click model rows** — Select model and launch (same as Enter)
+  - **Mouse wheel** — Scroll through the main table, overlays (Settings, Help, Changelog), and command palette results
+  - **Click CLI Tools header** — Cycle through tool modes (same as Z key)
+  - **Click Tier header** — Cycle through tier filters (same as T key)
+  - **Click footer hotkeys** — Trigger any visible hotkey from the footer
+  - **Command palette click** — Click inside to select items, double-click to confirm; click outside to close
+  - **Recommend questionnaire click** — Click on option rows to select, double-click to confirm
+- **Mouse unit tests** — 46 new tests covering SGR sequence parsing, double-click detection, modifiers, and COLUMN_SORT_MAP validation
+
+### Changed
+- **CLI Tools column redesigned** — Renamed from "Compatible with" to "CLI Tools", with left-aligned emoji display (compatible tools packed left instead of fixed slot positions)
+- **Sort arrow overflow fixed** — SWE%, CTX, Stability, and Uptime columns now properly fit within their widths when sorted (arrow now `↑SWE%` instead of `↑ SWE%`)
+- **Mouse sequence suppression** — SGR mouse sequences no longer leak into keypress handlers (prevents spurious sort/filter triggers when clicking)
+
+### Fixed
+- **Command palette scroll leak** — Mouse wheel no longer injects raw SGR sequence bytes into the command palette text input
+- **Double-action on model click** — Clicking a model row now only moves the cursor; it no longer simultaneously triggers column sorting
+- **Mouse event listener order** — Fixed race condition where readline emitted keypress events before mouse data was processed
+
+## [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

package/changelog/v0.3.28.md

@@ -0,0 +1,3 @@
+# Changelog v0.3.28 - 2026-03-27
+
+**Full Changelog**: https://github.com/vava-nessa/free-coding-models/compare/v0.3.26...v0.3.28

package/changelog/v0.3.29.md

@@ -0,0 +1,107 @@
+# Changelog v0.3.29 - 2026-03-27
+
+### Added
+- **Fluorescent green UPDATE AVAILABLE banner** — impossible-to-miss fluo green (🚀⬆️) banner at the bottom of the TUI when a new version is detected; click it to update instantly
+- **Command Palette update entry** — `⬆️ UPDATE NOW` is always the first result in Ctrl+P when an update is available
+- **Shift+U hotkey** — press Shift+U from the main table to trigger an immediate update
+- **Mouse-clickable update banner** — click the fluo green banner to install the latest version and relaunch
+- **Background version re-check every 5 minutes** — if a new version is published while the TUI is open, the banner appears live without restarting
+- **Aggressive pre-TUI update prompt** — fluorescent green header, and "Continue without update" warns that reminders will follow
+- **Last release date in footer** — light pink `Last release: Mar 27, 2026, 09:42 PM` shows when the package was last published to npm, so users know how fresh the model data is
+- **Demo2 GIF** — added `demo2.gif` to README for visual showcase of the TUI
+
+### Fixed
+- **Auto-update now detects the correct package manager** — bun, pnpm, and yarn users no longer get duplicate npm installs (fixes #46)
+- Update banner in footer shows the correct install command for your package manager
+
+## [0.3.28] - 2026-03-27
+
+_(Skipped — published as 0.3.28 without changelog in commit message, all changes are in 0.3.29)_
+
+## [0.3.27] - 2026-03-27
+
+## [0.3.26] - 2026-03-27
+
+### Added
+- **Groq**: Added Compound + Compound Mini; fixed Llama 4 Scout context (10M)
+- **OpenRouter**: Added MiniMax M2.5, Nemotron 3 Super, Hermes 3 405B, Gemma 3n E4B
+- **HuggingFace**: Replaced invalid DeepSeek-V3-Coder + outdated starcoder2-15b with DeepSeek V3 0324 + Qwen2.5 Coder 32B
+- **Replicate**: Replaced CodeLlama 70B (2023) with DeepSeek V3 0324 + Llama 3.3 70B
+- **Cloudflare**: Added Kimi K2.5, GLM-4.7-Flash, Llama 4 Scout, Nemotron 3 Super, Qwen3 30B MoE
+- **Scaleway**: Added Qwen3.5 400B VLM + Mistral Large 675B
+- **DeepInfra**: Replaced Mixtral Code with Nemotron 3 Super + DeepSeek V3 0324 + Qwen3 235B
+- **Fireworks**: Added Llama 4 Maverick + Qwen3 235B
+- **Hyperbolic**: Added Qwen3 80B Thinking variant
+- **Together AI**: Added Qwen3.5 400B VLM, MiniMax M2.5, GLM-5
+
+### Changed
+- **Rovo Dev CLI**: Updated Sonnet 4 → Sonnet 4.6, added Opus 4.6
+- **Groq**: Removed 4 deprecated models (R1 Distill 70B, QwQ 32B, Kimi K2, Maverick)
+- **OpenRouter**: Updated context sizes for multiple models
+
+## [0.3.25] - 2026-03-19
+
+### Added
+- **Installed Models Manager** — View, launch, and disable models configured in external tools (Goose, Crush, Aider, Qwen, Pi, OpenHands, Amp)
+  - Access via Command Palette (Ctrl+P) → "Installed models"
+  - Scans all supported tool configs automatically on opening
+  - Displays all models per tool (e.g., Crush shows both large and small models)
+  - Actions: Launch (Enter), Disable (D) with backup, Reinstall (R)
+  - Soft delete: Comments out model entries and saves backups to ~/.free-coding-models-backups.json
+- **Full mouse support for the TUI** — Click, right-click, double-click, and scroll work throughout the interface
+  - **Click column headers** — Sort by any column (click Rank, Tier, SWE%, CTX, Model, Provider, etc.)
+  - **Click model rows** — Move cursor to any model (left-click)
+  - **Right-click model rows** — Toggle favorite (same as F key)
+  - **Double-click model rows** — Select model and launch (same as Enter)
+  - **Mouse wheel** — Scroll through the main table, overlays (Settings, Help, Changelog), and command palette results
+  - **Click CLI Tools header** — Cycle through tool modes (same as Z key)
+  - **Click Tier header** — Cycle through tier filters (same as T key)
+  - **Click footer hotkeys** — Trigger any visible hotkey from the footer
+  - **Command palette click** — Click inside to select items, double-click to confirm; click outside to close
+  - **Recommend questionnaire click** — Click on option rows to select, double-click to confirm
+- **Mouse unit tests** — 46 new tests covering SGR sequence parsing, double-click detection, modifiers, and COLUMN_SORT_MAP validation
+
+### Changed
+- **CLI Tools column redesigned** — Renamed from "Compatible with" to "CLI Tools", with left-aligned emoji display (compatible tools packed left instead of fixed slot positions)
+- **Sort arrow overflow fixed** — SWE%, CTX, Stability, and Uptime columns now properly fit within their widths when sorted (arrow now `↑SWE%` instead of `↑ SWE%`)
+- **Mouse sequence suppression** — SGR mouse sequences no longer leak into keypress handlers (prevents spurious sort/filter triggers when clicking)
+
+### Fixed
+- **Command palette scroll leak** — Mouse wheel no longer injects raw SGR sequence bytes into the command palette text input
+- **Double-action on model click** — Clicking a model row now only moves the cursor; it no longer simultaneously triggers column sorting
+- **Mouse event listener order** — Fixed race condition where readline emitted keypress events before mouse data was processed
+
+## [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

package/changelog/v0.3.3.md

@@ -0,0 +1,11 @@
+# Changelog v0.3.3 - 2026-03-16
+
+### Fixed
+- **Claude Code now uses the real `free-claude-code` proxy contract**: FCM stopped injecting proxy slugs into `claude --model` / `ANTHROPIC_MODEL` and now launches Claude Code with only `ANTHROPIC_BASE_URL` + `ANTHROPIC_AUTH_TOKEN`.
+- **Claude routing is now proxy-side `MODEL` / `MODEL_*` mapping**: The selected FCM model is persisted into the proxy's Anthropic routing config and hot-reloaded by the daemon, so fake Claude model ids resolve to the chosen free backend exactly like `free-claude-code`.
+- **Claude launch now forces a real Claude alias**: FCM starts Claude Code with `--model sonnet`, which overrides stale broken local selections like `gpt-oss-120b` that Claude rejects before the proxy is even contacted.
+- **Claude proxy sync leftovers were removed**: Claude Code is no longer treated as a persisted proxy-sync target, avoiding stale `ANTHROPIC_MODEL=<fcm-slug>` env files that broke the integration.
+
+### Added
+- **Terminal width warning progress bar and toggle**: Added visual progress bar to the terminal width warning overlay and a Settings toggle “Disable Widths Warning” to permanently suppress it.
+- **Config setting `disableWidthsWarning`**: New boolean setting stored in profile and global config, default false.

package/changelog/v0.3.30.md

@@ -0,0 +1,3 @@
+# Changelog v0.3.30 - 2026-03-27
+
+**Full Changelog**: https://github.com/vava-nessa/free-coding-models/compare/v0.3.29...v0.3.30

package/changelog/v0.3.31.md

@@ -0,0 +1,113 @@
+# Changelog v0.3.31 - 2026-04-01
+
+### Changed
+- **Footer layout reorganized** — Discord link moved to the very bottom line of the TUI for better visibility
+- **X/Twitter support message** — added 🐦 "Support me on X: @vavanessa_dev 💖" with clickable link in the last release footer line
+
+## [0.3.29] - 2026-03-27
+
+### Added
+- **Fluorescent green UPDATE AVAILABLE banner** — impossible-to-miss fluo green (🚀⬆️) banner at the bottom of the TUI when a new version is detected; click it to update instantly
+- **Command Palette update entry** — `⬆️ UPDATE NOW` is always the first result in Ctrl+P when an update is available
+- **Shift+U hotkey** — press Shift+U from the main table to trigger an immediate update
+- **Mouse-clickable update banner** — click the fluo green banner to install the latest version and relaunch
+- **Background version re-check every 5 minutes** — if a new version is published while the TUI is open, the banner appears live without restarting
+- **Aggressive pre-TUI update prompt** — fluorescent green header, and "Continue without update" warns that reminders will follow
+- **Last release date in footer** — light pink `Last release: Mar 27, 2026, 09:42 PM` shows when the package was last published to npm, so users know how fresh the model data is
+- **Demo2 GIF** — added `demo2.gif` to README for visual showcase of the TUI
+
+### Fixed
+- **Auto-update now detects the correct package manager** — bun, pnpm, and yarn users no longer get duplicate npm installs (fixes #46)
+- Update banner in footer shows the correct install command for your package manager
+
+## [0.3.28] - 2026-03-27
+
+_(Skipped — published as 0.3.28 without changelog in commit message, all changes are in 0.3.29)_
+
+## [0.3.27] - 2026-03-27
+
+## [0.3.26] - 2026-03-27
+
+### Added
+- **Groq**: Added Compound + Compound Mini; fixed Llama 4 Scout context (10M)
+- **OpenRouter**: Added MiniMax M2.5, Nemotron 3 Super, Hermes 3 405B, Gemma 3n E4B
+- **HuggingFace**: Replaced invalid DeepSeek-V3-Coder + outdated starcoder2-15b with DeepSeek V3 0324 + Qwen2.5 Coder 32B
+- **Replicate**: Replaced CodeLlama 70B (2023) with DeepSeek V3 0324 + Llama 3.3 70B
+- **Cloudflare**: Added Kimi K2.5, GLM-4.7-Flash, Llama 4 Scout, Nemotron 3 Super, Qwen3 30B MoE
+- **Scaleway**: Added Qwen3.5 400B VLM + Mistral Large 675B
+- **DeepInfra**: Replaced Mixtral Code with Nemotron 3 Super + DeepSeek V3 0324 + Qwen3 235B
+- **Fireworks**: Added Llama 4 Maverick + Qwen3 235B
+- **Hyperbolic**: Added Qwen3 80B Thinking variant
+- **Together AI**: Added Qwen3.5 400B VLM, MiniMax M2.5, GLM-5
+
+### Changed
+- **Rovo Dev CLI**: Updated Sonnet 4 → Sonnet 4.6, added Opus 4.6
+- **Groq**: Removed 4 deprecated models (R1 Distill 70B, QwQ 32B, Kimi K2, Maverick)
+- **OpenRouter**: Updated context sizes for multiple models
+
+## [0.3.25] - 2026-03-19
+
+### Added
+- **Installed Models Manager** — View, launch, and disable models configured in external tools (Goose, Crush, Aider, Qwen, Pi, OpenHands, Amp)
+  - Access via Command Palette (Ctrl+P) → "Installed models"
+  - Scans all supported tool configs automatically on opening
+  - Displays all models per tool (e.g., Crush shows both large and small models)
+  - Actions: Launch (Enter), Disable (D) with backup, Reinstall (R)
+  - Soft delete: Comments out model entries and saves backups to ~/.free-coding-models-backups.json
+- **Full mouse support for the TUI** — Click, right-click, double-click, and scroll work throughout the interface
+  - **Click column headers** — Sort by any column (click Rank, Tier, SWE%, CTX, Model, Provider, etc.)
+  - **Click model rows** — Move cursor to any model (left-click)
+  - **Right-click model rows** — Toggle favorite (same as F key)
+  - **Double-click model rows** — Select model and launch (same as Enter)
+  - **Mouse wheel** — Scroll through the main table, overlays (Settings, Help, Changelog), and command palette results
+  - **Click CLI Tools header** — Cycle through tool modes (same as Z key)
+  - **Click Tier header** — Cycle through tier filters (same as T key)
+  - **Click footer hotkeys** — Trigger any visible hotkey from the footer
+  - **Command palette click** — Click inside to select items, double-click to confirm; click outside to close
+  - **Recommend questionnaire click** — Click on option rows to select, double-click to confirm
+- **Mouse unit tests** — 46 new tests covering SGR sequence parsing, double-click detection, modifiers, and COLUMN_SORT_MAP validation
+
+### Changed
+- **CLI Tools column redesigned** — Renamed from "Compatible with" to "CLI Tools", with left-aligned emoji display (compatible tools packed left instead of fixed slot positions)
+- **Sort arrow overflow fixed** — SWE%, CTX, Stability, and Uptime columns now properly fit within their widths when sorted (arrow now `↑SWE%` instead of `↑ SWE%`)
+- **Mouse sequence suppression** — SGR mouse sequences no longer leak into keypress handlers (prevents spurious sort/filter triggers when clicking)
+
+### Fixed
+- **Command palette scroll leak** — Mouse wheel no longer injects raw SGR sequence bytes into the command palette text input
+- **Double-action on model click** — Clicking a model row now only moves the cursor; it no longer simultaneously triggers column sorting
+- **Mouse event listener order** — Fixed race condition where readline emitted keypress events before mouse data was processed
+
+## [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