free-coding-models 0.3.67 → 0.3.68

package/changelog/v0.2.12.md

@@ -0,0 +1,16 @@
+# Changelog v0.2.12 - 2026-03-14
+
+### Added
+- **Auto-select models for all external tools**: All 10 supported tools (Aider, Crush, Goose, Claude Code, Codex, Gemini, Qwen, OpenHands, Amp, Pi) now automatically configure and pre-select the chosen model on launch — no manual model selection needed after pressing Enter.
+- **Changelog loader utility**: New `src/changelog-loader.js` module parses CHANGELOG.md for future TUI integration to display changes directly in the app instead of opening a browser.
+
+### Fixed
+- **Infinite update loop on startup**: Disabled forced auto-update that caused the app to detect the same update repeatedly after restarting. The app now checks for updates in the background without forcing installation.
+- **Removed disruptive browser window**: The auto-update process no longer opens a browser window to show the changelog — it now shows update information in the terminal only.
+- **Update failure tracking**: If update checks fail 3+ times, the app displays a prominent red footer warning: `⚠ OUTDATED version, please update` with manual update instructions instead of crashing.
+
+### Changed
+- **OpenHands integration improved**: Now sets `LLM_MODEL` and `LLM_API_KEY` environment variables for proper model pre-selection on launch.
+- **Amp integration improved**: Now writes `amp.model` to config file with the selected model ID.
+
+---

package/changelog/v0.2.13.md

@@ -0,0 +1,16 @@
+# Changelog v0.2.13 - 2026-03-14
+
+### Added
+- **Persist UI view settings**: Tier filter (T key), provider filter (D key), and sort order now persist across session restarts — settings are saved to `~/.free-coding-models.json` under `config.settings` and automatically restored on next startup. Settings also mirror into active profiles so profile switching captures live view preferences.
+  - When T cycles tier: S+ tier is now remembered for next session
+  - When D cycles provider: Filtered provider is now remembered
+  - When sort keys (R/O/M/L/A/S/C/H/V/B/U) change order: Sort column and direction are now remembered
+  - Profile loading has priority over global `config.settings` so saved profiles override global defaults
+- **Reset view settings (Shift+R)**: New keyboard shortcut to instantly reset tier filter, provider filter, and sort order to defaults (All tier, no provider filter, avg sort ascending). Also clears persisted settings from `config.settings` so next restart returns to factory defaults.
+  - Useful when you've customized your view but want a fresh start
+  - Does not affect favorites, API keys, or other settings — only view state
+
+### Changed
+- **Help overlay (K key)**: Updated to document new Shift+R keybinding for resetting view settings
+
+---

package/changelog/v0.2.14.md

@@ -0,0 +1,6 @@
+# Changelog v0.2.14 - 2026-03-14
+
+### Fixed
+- **Changelog scrolling viewport**: Scrolling in changelog details (N key) now respects viewport boundaries — content no longer scrolls beyond visible area. Down/PageDown/End keys now properly clamp to max scroll offset so you can view all content without it disappearing off screen.
+
+---

package/changelog/v0.2.15.md

@@ -0,0 +1,6 @@
+# Changelog v0.2.15 - 2026-03-15
+
+### Changed
+- **Changelog scrolling experience**: Circular wrap-around scrolling in changelog details (N key) — up at the top now wraps to the bottom, down at the bottom wraps to the top. PageUp/PageDown also wrap for seamless infinite browsing, just like the main TUI list navigation. Home/End still jump to absolute first/last positions for quick access.
+
+---

package/changelog/v0.2.17.md

@@ -0,0 +1,14 @@
+# Changelog v0.2.17 - 2026-03-16
+
+### Added
+- **All coding tools re-enabled in Z-cycle**: Aider, Claude Code, Codex CLI, Gemini CLI, Qwen Code, OpenHands, and Amp are now back in the public tool mode cycle alongside OpenCode, OpenClaw, Crush, Goose, and Pi — 13 tools total.
+- **All coding tools available in Install Endpoints (Y key)**: The endpoint installer now supports all 13 tools as install targets, not just the original 5. Each tool gets its proper config format (JSON, YAML, or env file).
+- **Connection mode choice in Install flow**: When installing endpoints (Y key), users now choose between **Direct Provider** (pure API connection) or **FCM Proxy** (local proxy with key rotation and usage tracking) — new Step 3 in the 5-step flow.
+- **Install support for new tools**: Pi (models.json + settings.json), Aider (.aider.conf.yml), Amp (settings.json), Gemini (settings.json), Qwen (modelProviders config), Claude Code/Codex/OpenHands (sourceable env files at ~/.fcm-*-env).
+
+### Changed
+- **Install Endpoints flow is now 5 steps**: Provider → Tool → Connection Mode → Scope → Models (was 4 steps without connection mode choice).
+- **Tool labels in install overlay use metadata**: Tool names and emojis in the Y overlay now come from `tool-metadata.js` instead of hard-coded ternary chains — easier to maintain and always in sync.
+- **Help overlay updated**: Z-cycle hint and CLI flag examples now list all 13 tools.
+
+---

package/changelog/v0.2.2.md

@@ -0,0 +1,16 @@
+# Changelog v0.2.2 - 2026-03-10
+
+### Added
+
+- 🔌 Added a new `Y` install flow that pushes one configured provider directly into `OpenCode CLI`, `OpenCode Desktop`, `OpenClaw`, `Crush`, or `Goose`, with either the full catalog or a curated model subset.
+
+### Changed
+
+- 🔄 Tracked endpoint installs are now refreshed automatically on future launches so managed tool catalogs stay aligned when provider model lists evolve.
+
+### Fixed
+
+- 🔐 Clarified provider auth failures in the main table so configured keys rejected by a provider no longer appear as `NO KEY`.
+- 🔁 Hardened Settings key tests with multi-model retries plus detailed diagnostics under Setup Instructions when a provider probe fails.
+- 🏷️ Fixed Settings provider badges so configured keys show `Test` before the first probe, while providers without a key now show `Missing Key`.
+- 🤗 Clarified the Hugging Face setup hint in Settings to require a fine-grained token with `Make calls to Inference Providers`.

package/changelog/v0.2.3.md

@@ -0,0 +1,7 @@
+# Changelog v0.2.3 - 2026-03-10
+
+### Fixed
+
+- 🔧 Fixed Codestral API endpoint URL from `codestral.mistral.ai/v1` to `api.mistral.ai/v1` to align with Mistral AI's unified API platform. This resolves authentication failures when testing Codestral API keys in Settings.
+
+---

package/changelog/v0.2.4.md

@@ -0,0 +1,7 @@
+# Changelog v0.2.4 - 2026-03-10
+
+### Fixed
+
+- 🔧 Fixed Configured Only filter (E key) not being applied at startup. The flag was initialized correctly but the filter function was never called on first render, causing all models to appear visible even when Configured Only mode was enabled.
+
+---

package/changelog/v0.2.5.md

@@ -0,0 +1,12 @@
+# Changelog v0.2.5 - 2026-03-10
+
+### Fixed
+
+- 🔒 **Improved config save reliability** - API keys are now much safer from corruption and loss:
+  - Automatic backups before each save (keeps last 5 versions in `~/.free-coding-models.backups/`)
+  - Post-write verification confirms file was written correctly and data wasn't lost
+  - Explicit error handling instead of silent failures
+  - Auto-repair on startup if config is corrupted (restores from latest backup)
+  - Console notifications when backup is used or config is repaired
+
+---

package/changelog/v0.2.7.md

@@ -0,0 +1,3 @@
+# Changelog v0.2.7 - 2026-03-17
+
+Improve Application Architecture and Error Handling

package/changelog/v0.2.8.md

@@ -0,0 +1,107 @@
+# Changelog v0.2.8 - 2026-03-13
+
+### Updated
+
+- 📊 **Provider quota information refreshed** – Updated free‑tier request limits for NVIDIA NIM, Groq, Cerebras, Replicate, DeepInfra, and Fireworks AI in `src/provider-metadata.js` and the README.
+- 📖 **README requirements section** – Added the latest quota details for each provider (40 req/min for NVIDIA, 30‑50 RPM for Groq, generous dev tier for Cerebras, 6 req/min free Replicate, 200 concurrent DeepInfra, 10 req/min free Fireworks) and clarified payment‑method dependent limits.
+- 🛠️ **No functional code changes** – Metadata updates only; all tests continue to pass.
+
+### Added
+
+- 📊 **Added `--json` flag for scriptable output** - Output model results as JSON for automation, CI/CD, and monitoring dashboards. Example: `free-coding-models --tier S --json | jq '.[0].modelId'`
+
+- 💾 **Added persistent ping cache** - Cache ping results for 5 minutes to speed up subsequent runs:
+  - Cache stored in `~/.free-coding-models.cache.json`
+  - Automatic cache refresh on startup if stale
+  - Saves API rate limits and reduces wait time
+  - Cache is saved on exit for next run
+
+- 🔐 **Added config file security check with auto-fix** - Warns if `~/.free-coding-models.json` has insecure permissions:
+  - Checks file permissions on startup
+  - Warns if file is readable by others (security risk)
+  - Offers one-click auto-fix with `chmod 600`
+  - Shows manual fix command if auto-fix fails or is declined
+
+- 🎨 **Added provider colors to logs and settings** - Provider names are now colored the same way as in the main table:
+  - Settings overlay (P) shows colored provider names
+  - Fiable mode output uses colored provider names
+  - Tool launcher messages use colored provider names
+  - Request log overlay (X) shows colored provider names
+  - Consistent visual experience across all UI elements
+
+### Changed
+
+- 📝 **Increased default log limit from 200 to 500 entries** - Request log overlay now shows up to 500 entries by default (previously 200)
+- 🔀 **Added toggle for unlimited logs** - Press `A` in request log overlay to toggle between showing 500 entries or ALL logs
+- ❌ **Enhanced visual failure indication in logs** - Failed requests with zero tokens now have:
+  - Dark red background (`rgb(40, 0, 0)`) on the entire row
+  - Model name in red
+  - Token column shows red cross emoji (✗) instead of token count
+  - Quick visual identification of errors vs successful requests
+- 📝 **Updated documentation** - Added `--json` flag to CLI flags table in README.md with usage examples
+
+- 🔌 Added `terminalcp` MCP server configuration for Claude Code to spawn and interact with the TUI headlessly. Agents can now visually test the terminal interface by capturing output and sending keystrokes programmatically. See AGENTS.md → "Testing the TUI with terminalcp" for usage.
+- 🎨 **Added consistent branding header to all overlays** - Each overlay (Settings, Help, Log, Install Endpoints, Recommend, Feature Request, Bug Report) now displays:
+  - Free-coding-models logo with rocket emoji (🚀)
+  - Version number display
+  - Clean title on a separate line
+  - Consistent visual styling across all screens
+  - **Main table title now uses rocket emoji (🚀) and cyanBright color** for consistency with overlays
+
+### Changed
+
+- 📝 **Updated documentation** - Added `--json` flag to CLI flags table in README.md with usage examples
+
+- 📊 **Improved ping progress visibility** - Moved ping completion counter from the W badge to the main status bar:
+  - Now shows as `📦 49/59` next to model status counts (up/timeout/down)
+  - More prominent placement makes it easier to see ping progress at a glance
+  - W badge still shows interval, mode, and countdown to next ping
+
+- 🧹 **Removed unnecessary blank line** - Overlays (Settings P, Help K, Log X) no longer have a blank line at the top, giving more vertical space for content
+
+- 🔽 **Removed duplicate "CONFIGURED ONLY" badge** - The header no longer shows the "CONFIGURED ONLY" indicator since it's already displayed in the footer hints. This reduces header clutter while keeping the information visible.
+
+- 🎨 **Enhanced Request Log (X) with colors and visual indicators**:
+  - **Latency gradient**: Green (<500ms) → Orange (<1000ms) → Yellow (<1500ms) → Red (≥1500ms) for quick performance assessment
+  - **Token opacity**: Light green (low usage) → Medium green → Bright green (high usage, >30k tokens)
+  - **Model coloring**: Matches status color for visual consistency
+  - **Status colors** - Distinct colors for each HTTP code:
+    - `200` ✅ → Bright green
+    - `400` → Dark magenta (#8B008B)
+    - `401` → Dark orchid (#9932CC)
+    - `403` → Medium orchid (#BA55D3)
+    - `404` → Dark red (crimson)
+    - `413` → Tomato red (#FF6347)
+    - `429` → Dark orange (#FFB90F)
+    - `500` → Crimson (#DC143C)
+    - `502` → Medium violet red (#C71585)
+    - `503` → Medium purple (#9370DB)
+    - `5xx` → Magenta (other 5xx errors)
+    - `0` → Dim gray (timeout/unknown)
+  - **Fixed token display bug**: Corrected chalk function calls that were showing JavaScript code instead of token counts
+
+- 💖 **Added "Buy me a coffee" link to footer**:
+  - Added in main TUI footer next to Contributors link (buymeacoffee.com/vavanessadev)
+  - Added in Settings overlay (P) footer with credits "Made with 💖 & ☕ by vava-nessa"
+  - Warm orange color for the coffee link to match the cozy theme
+
+### Fixed
+
+- 🖥️ **Overlays now use 100% terminal width** - All overlays (Settings P, Help K, Log X, Recommend Q, Feature J, Bug I) now dynamically adapt to full terminal width instead of fixed 116-column panels:
+  - Rate limits text is no longer truncated (full descriptions visible)
+  - Diagnostic messages wrap using available terminal width
+  - Separator lines extend to full terminal width
+  - Better readability on wider terminals
+
+- 🔒 **Fixed profile loading to preserve API keys** - Loading a profile now MERGES apiKeys instead of replacing them:
+  - Keys in the profile override existing keys (allows profile-specific overrides)
+  - Keys NOT in the profile are preserved (prevents key loss when switching profiles)
+  - Fixes bug where switching profiles would cause API keys disappear
+  - Added test to verify merge behavior
+
+- 📝 **Updated OpenRouter rate limits information**:
+  - README now includes detailed explanation of free tier quotas (50/day <$10 credits, 1000/day ≥$10)
+  - Settings overlay displays accurate rate limit text
+  - Added note about failed requests counting toward daily quota
+
+---

package/changelog/v0.2.9.md

@@ -0,0 +1,10 @@
+# Changelog v0.2.9 - 2026-03-14
+
+### Fixed
+- **Discord link**: Updated expired invite URL to `https://discord.gg/f2AjwV2AN` in README and TUI footer
+
+### Added
+- **Discord link health-check workflow**: New GitHub Actions workflow (`check-discord-link.yml`) runs every 12 hours, validates the Discord invite via the Discord API, and auto-opens an issue labeled `discord-link` if the link becomes invalid
+- **Pi provider metadata**: Added `pi` provider entry to `src/provider-metadata.js` with light blue color, pi.dev signup URL, and setup hint for `@mariozechner/pi-coding-agent` integration
+
+---

package/changelog/v0.3.0.md

@@ -0,0 +1,30 @@
+# Changelog v0.3.0 - 2026-03-16
+
+## 🚀 FCM Proxy V2 — Always-on background proxy service
+
+### Added
+- **Always-on background proxy service** — `launchd` (macOS) / `systemd` (Linux). All tools get free model access 24/7 without the TUI.
+- **Anthropic wire format translation** — Claude Code works natively through FCM Proxy V2 (no external Python proxy needed).
+- **`J` key shortcut** — Opens FCM Proxy V2 settings directly. Footer shows `📡 FCM Proxy V2 On/Off` badge.
+- **Dedicated proxy overlay** — Full-page manager with status, restart, stop, force-kill, and log viewer.
+- **CLI daemon subcommand** — `free-coding-models daemon [status|install|uninstall|restart|stop|logs]`
+- **Stable proxy identity** — Persistent token & port (`18045`) survive restarts.
+- **`GET /v1/health` + `/v1/stats`** — Health and stats endpoints for monitoring.
+- **Hot-reload** — Config changes picked up automatically without restart.
+- **Generalized proxy sync** (`src/proxy-sync.js`) — Single-endpoint config sync for 12 tools.
+- **Retry backoff with jitter** — Progressive delays (0ms, 300ms, 800ms + jitter).
+- **Automatic account cooldown** — 3+ consecutive failures → graduated cooldown (30s → 60s → 120s).
+
+### Changed
+- **Rebranded to FCM Proxy V2** across all CLI messages, overlays, and services.
+- **Proxy overlay generalized** — Tool selector, auto-sync toggle, and cleanup for any of 12 tools.
+- **Feedback overlay redesigned** — `I` key opens unified "Feedback, bugs & requests".
+- **Claude Code / Codex / Gemini require proxy** — Clear error message + instructions when proxy is off.
+- **Goose launcher rewritten** — Writes `config.yaml` with `GOOSE_PROVIDER`/`GOOSE_MODEL` (replaces obsolete `OPENAI_HOST` env vars).
+- **Crush launcher improved** — Removed `disable_default_providers`, sets both `models.large` + `models.small`.
+- **Pi launcher improved** — Uses `--provider` and `--model` CLI flags for guaranteed auto-selection.
+
+### Fixed
+- 20+ security & stability fixes including body size limits, stack trace leak prevention, SSE buffer overflow guards, `execSync` timeout safety, crash protections, and more.
+
+**Full changelog:** https://github.com/vava-nessa/free-coding-models/blob/main/CHANGELOG.md

package/changelog/v0.3.1.md

@@ -0,0 +1,17 @@
+# Changelog v0.3.1 - 2026-03-16
+
+### Added
+- **CLI `--help` output**: `free-coding-models --help` now prints the full launcher, analysis, config, and daemon command matrix in a non-interactive format.
+
+### Fixed
+- **Outdated-version footer alert**: The main TUI now shows a full-width red footer line with manual `npm install -g free-coding-models@latest` recovery instructions, but only when a newer npm version is actually known.
+- **Claude Code proxy auth conflict**: Proxy launches now sanitize inherited env vars and use only `ANTHROPIC_AUTH_TOKEN` + `ANTHROPIC_BASE_URL`, matching the `free-claude-code` contract instead of mixing Anthropic auth modes.
+- **Codex CLI proxy routing**: Codex launches now force an explicit custom provider config and the proxy now supports `POST /v1/responses`, so `codex-cli 0.114.0` no longer depends on the broken built-in OAuth/base-url path.
+- **Anthropic token counting**: Added `POST /v1/messages/count_tokens` with a fast local estimate so Claude-compatible clients keep their budgeting flow through FCM Proxy V2.
+- **Gemini proxy failure mode**: Gemini launch now preflights the installed CLI/config, blocks incompatible builds like `0.33.0`, and surfaces `~/.gemini/settings.json` schema errors instead of pretending proxy mode works.
+
+### Changed
+- **Proxy auto-sync now follows the current tool**: The proxy overlay no longer asks for a separate active tool; cleanup and auto-sync now target the current `Z` mode whenever that tool supports persisted proxy config.
+- **Install Endpoints (`Y`) is narrower on purpose**: `Claude Code`, `Codex`, and `Gemini` were removed from the install-target menu so the flow only lists tools with a stable persisted-config contract.
+- **Proxy model listing is more Codex-friendly**: `GET /v1/models` now returns both the usual OpenAI `data` array and a `models` array with `slug` fields for clients that expect a richer catalog shape.
+- **Launcher diagnostics now mention the beta state clearly**: Proxy-backed external tools now remind users that the integration is still stabilizing when a launch is blocked.

package/changelog/v0.3.11.md

@@ -0,0 +1,20 @@
+# Changelog v0.3.11 - 2026-03-16
+
+### Fixed
+- Added early 404 response when a requested model has no registered accounts, ensuring clear error handling.
+
+### Removed
+- **Profile system**: Entire profile system removed to ensure API keys persist permanently across all sessions. No more profile switching causing API key loss.
+
+### Added
+- **`--proxy` foreground mode**: New `--proxy` flag starts FCM Proxy V2 in the current terminal with a live dashboard showing status, accounts, provider breakdown, and real-time request log. No daemon install needed — works from dev checkout too.
+
+### Fixed
+- **Claude Code proxy auth**: Proxy now accepts `x-api-key` header (used by Anthropic SDK / Claude Code) in addition to `Authorization: Bearer`
+- **Claude model fallback**: When `anthropicRouting` is all null, Claude model names now fall back to the first available account instead of returning "Model not found"
+- **Proxy sync for Claude Code**: Added `claude-code` to `PROXY_SYNCABLE_TOOLS` so the env file is properly written/updated by proxy sync
+- **Correct env var name**: Claude Code env file now exports `ANTHROPIC_API_KEY` (SDK standard) instead of `ANTHROPIC_AUTH_TOKEN`
+- **Auto-source shell profile**: Claude Code env file is now automatically sourced in `.zshrc` / `.bashrc` / `.bash_profile`
+- **Removed deleted profile functions from tests**: Cleaned up test imports after profile system removal from config.js
+
+---

package/changelog/v0.3.12.md

@@ -0,0 +1,18 @@
+# Changelog v0.3.12 - 2026-03-17
+
+> **Proxy / bridge update:** the current legacy proxy stack is now officially discontinued while we rebuild that whole layer from zero. This cleanup is intentional: Claude Code support, a smarter router, and a much more reliable external-tools bridge are being reworked as a separate, cleaner system and will come back in a future release. In the meantime, FCM has been cleaned up and narrowed to the stable direct-launch surface so the app stays solid for day-to-day usage.
+
+### Added
+- **Legacy proxy cleanup action**: Settings now includes a one-shot cleanup that removes discontinued proxy leftovers from older installs and explains that a more stable replacement is in progress.
+
+### Changed
+- **Stable direct-launch surface**: The app now documents and exposes only the supported direct-provider launcher workflow while the old bridge is rebuilt.
+- **README reset**: Rewrote the documentation to match the real product surface, current tools, and current test commands.
+- **Footer transparency**: The main TUI now shows an explicit magenta notice that the old proxy is disabled while the replacement bridge is being rebuilt.
+
+### Fixed
+- **Selected model now really becomes the launched tool default**: external tool launch prep now writes the chosen model into each tool config before spawn, and OpenClaw no longer hardcodes `nvidia/*` when another provider was selected.
+
+### Removed
+- **Global proxy stack**: Deleted the old proxy runtime, daemon flow, request-log flow, and related orphaned helpers/tests.
+- **Hidden launcher bridges**: Claude Code, Codex, and Gemini are no longer exposed in the app while their integrations are being rewritten.

package/changelog/v0.3.13.md

@@ -0,0 +1,4 @@
+# Changelog v0.3.13 - 2026-03-17
+
+### Fixed
+- **Small Width Warnings toggle actually works again**: the Settings row now shows `Small Width Warnings` with clear enabled/disabled status, the startup overlay reacts immediately to the toggle, and the narrow-terminal warning now auto-hides after 2 seconds instead of 4.

package/changelog/v0.3.14.md

@@ -0,0 +1,6 @@
+# Changelog v0.3.14 - 2026-03-17
+
+### Changed
+- **Massive TUI Controller Extraction:** Extracted the main UI event loop and state machine out of `bin/free-coding-models.js` into a dedicated `src/app.js` controller. This cuts the main executable size drastically and makes the TUI architecture more modular and testable.
+- **Robust Error Boundaries:** Wrapped all critical asynchronous operations, keypress handlers, UI render timers, and polling cycles with comprehensive `try/catch` blocks. Instead of the TUI crashing and destroying the terminal scrollback on unexpected errors, it will now gracefully exit the alternate screen buffer, print a formatted stack trace, and point users to the GitHub issue tracker and feedback form.
+- **Global Crash Resiliency:** Added `uncaughtException` and `unhandledRejection` listeners at the entry point to guarantee terminal restoration even if a library fails catastrophically.

package/changelog/v0.3.15.md

@@ -0,0 +1,4 @@
+# Changelog v0.3.15 - 2026-03-17
+
+### Changed
+- Added vertical column separators (gentle dark orange) for clearer column separation and removed the horizontal separator line in the main TUI.

package/changelog/v0.3.16.md

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

package/changelog/v0.3.17.md

@@ -0,0 +1,4 @@
+# Changelog v0.3.17 - 2026-03-18
+
+### Added
+- **Auto Light/Dark Theme**: Implemented automatic detection of the user's terminal theme (dark or light) so that the TUI is always readable. Added semantic color tokens, and users can override the theme as `dark`, `light`, or `auto` via the Settings interface.

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