free-coding-models 0.3.66 → 0.3.68

package/changelog/v0.1.88.md

@@ -0,0 +1,167 @@
+# Changelog v0.1.88 - 2026-03-09
+
+## 🎯 Release Overview
+
+This is a significant stability and usability release that combines two important feature branches (0.1.88 + 0.1.89) into a single polished 0.2.0 release. The focus is on hardening the public launcher ecosystem, improving visual feedback through dynamic filter coloring, and delivering robust integration with Crush including proper proxy support and model selection persistence.
+
+## ✨ Major Features
+
+### 🛡️ Hardened Multi-Tool Launcher Ecosystem
+
+**Public Z-Cycle (stable, battle-tested):**
+- `OpenCode CLI` (default at startup)
+- `OpenCode Desktop`
+- `OpenClaw` (autonomous agent daemon)
+- `Crush` (with new proxy & config improvements)
+- `Goose` (lightweight agent)
+
+**Internal Support (temporarily disabled from public cycle, pending hardening):**
+- Aider, Claude Code, Codex CLI, Gemini CLI, Qwen Code, OpenHands, Amp, Pi
+
+This narrowing from 13 to 5 public launchers in the Z-cycle reduces user confusion and ensures we only expose flows that have been thoroughly tested and validated in the field.
+
+### 🎨 Dynamic Visual Feedback for Active Filters
+
+**Tier Filter Badges:**
+- S+ / S: Bright green [57, 255, 20]
+- A+ / A: Gold [255, 224, 130]
+- A- / B+: Orange [255, 171, 64]
+- B / C: Red / Purple gradients
+- Active tier always visible in both header badges and footer hotkeys
+
+**Provider Filter Badges:**
+- Each provider (NIM, Groq, Cerebras, etc.) now displays with its brand color
+- Active provider instantly recognizable across the table
+- Color coding helps users mentally organize multi-provider workflows
+
+### 🧰 Crush Integration Overhaul
+
+**Configuration Improvements:**
+- Now writes `config.models.large` with actual selected model ID instead of relying on CLI argument parsing
+- Sets `disable_default_providers: true` to force reliance on FCM's configured providers
+- Model selection persists across Crush sessions via the config file
+
+**Proxy Awareness:**
+- Detects when proxy mode is enabled in Settings
+- Routes requests through `http://127.0.0.1:<port>/v1` instead of direct provider
+- Properly substitutes auth tokens and base URLs based on proxy vs. direct mode
+- Provides user feedback on which config path is active
+
+**Spawn Robustness:**
+- Removed `--model` CLI argument (was causing parsing conflicts)
+- All configuration now driven through `crush.json` for cleaner process spawning
+- Fixed shell spawning: `shell: true` only on Windows; Unix systems use direct spawn
+
+### 🧹 OpenCode Proxy Lifecycle
+
+**New CLI Command:**
+- `free-coding-models --clean-proxy` — Remove persisted `fcm-proxy` config from OpenCode safely
+- Available in Settings screen (`P` key) under Maintenance
+
+**Opt-In Architecture:**
+- Proxy mode disabled by default
+- Users explicitly enable in Settings (`P` key) → Proxy settings section
+- Control over proxy persistence and preferred port
+- `S` in Settings to sync proxy into OpenCode only when explicitly requested
+
+### 📚 Documentation & Help Synchronization
+
+**In-App Help Refreshed:**
+- Z-cycle hotkey help now shows only hardened launchers (OpenCode CLI/Desktop, OpenClaw, Crush, Goose)
+- CLI flag examples (`--opencode`, `--openclaw`, `--crush`, `--goose`) reflect public set
+- Removed references to temporarily disabled launchers (Aider, Claude Code, etc.)
+
+**JSDoc Header Updated:**
+- Clarified startup behavior (no menu → direct OpenCode CLI)
+- Documented ping cadence states: 2s startup burst (60s), 10s steady state, 30s idle fallback, forced 4s via W
+- Removed "promptModeSelection" references
+- Explained multi-tool action on Enter key press
+
+**README Synchronized:**
+- Model count, filter descriptions, and default behaviors match current implementation
+- Hardened launcher set documented with Z-cycle order
+- Proxy documentation updated with opt-in architecture
+
+## 🔧 Technical Highlights
+
+### Code Refactoring & Modularity
+- Extracted TUI overlays and key handling into dedicated modules
+- Shared integration helpers for OpenCode/OpenClaw flows
+- Runtime state moved to shared locations for clearer ownership
+- Improved color constants (ACTIVE_FILTER_BG_BY_TIER, PROVIDER_COLOR maps)
+
+### Performance & Stability
+- Rolling averages calculated from ALL successful pings (even 401 responses)
+- Stability score refined: p95 (30%) + jitter (30%) + spike rate (20%) + reliability (20%)
+- Ping cadence adapts: fast startup (2s/60s), steady state (10s), idle slowdown (30s/5m)
+- Timeout models continuously retried, never abandoned
+
+### Platform Compatibility
+- Shell spawning fixed for cross-platform (Windows vs. Unix)
+- Proper process isolation on non-Windows systems
+- Environment variable substitution for all launchers
+
+## 📊 Data Integrity Improvements
+
+**Token Usage Tracking:**
+- Request log overlay (`X` key) shows proxy-only transactions
+- Per-exact-provider/model accounting (no contamination across providers)
+- `Used` column aggregates prompt+completion tokens from startup logs
+- Green dot shown when quota telemetry unavailable or unreliable
+
+**Uptime & Health Metrics:**
+- Health states: UP ✅, NO KEY 🔑, Timeout ⏳, Overloaded 🔥, Not Found 🚫
+- Verdict combines avg latency + stability analysis
+- Persistent favorites (`F` key) with ⭐ prefix
+- Configured-only mode (`E` key) filters to providers with API keys
+
+## 🎬 User Experience Polish
+
+**Visual Clarity:**
+- Tier and Provider filter values display directly inside highlighted pills
+- Header badges show active tool mode (`Z Tool: [selected]`)
+- Footer shortcut colors unified and consistent
+- Provider-colored model names in the main table
+- Selected row uses punchier pink-violet highlight
+
+**Default Behavior:**
+- Configured-only mode enabled by default (press `E` to toggle)
+- Empty state tells users to press `P` to add first API key
+- Terminal width warning shown (centered) when too narrow for table
+- In-app help (`K` key) provides full reference
+
+## ✅ Testing Checklist
+
+- [ ] Z-cycle correctly loops through hardened launchers only
+- [ ] Tier/Provider filter badges display with appropriate colors
+- [ ] Crush launches successfully with direct provider config
+- [ ] Crush launches successfully with FCM proxy when enabled
+- [ ] `--clean-proxy` flag removes proxy config as expected
+- [ ] Help overlay and flag examples show only stable launchers
+- [ ] Filter state persists across all transitions
+- [ ] Rolling averages update correctly on every ping
+- [ ] Favorites saved and restored across restarts
+- [ ] Config profiles capture and restore all settings
+
+## 📦 Files Changed
+
+- `CHANGELOG.md` — Unified 0.1.88 + 0.1.89 → 0.2.0 release notes
+- `README.md` — Synchronized with hardened launcher set and current behavior
+- `package.json` — Version bumped to 0.2.0
+- `bin/free-coding-models.js` — Updated JSDoc; clarified startup and multi-tool behavior
+- `src/overlays.js` — Cleaned up help overlay; only hardened launchers shown
+- `src/render-table.js` — Added dynamic color support for Tier/Provider filter badges
+- `src/tool-launchers.js` — Enhanced Crush config logic; added proxy detection and routing
+- `src/tool-metadata.js` — Hardened launchers active; unstable launchers commented out
+
+## 🚀 Next Steps
+
+1. All 20 providers remain supported: NVIDIA NIM, Groq, Cerebras, SambaNova, OpenRouter, Hugging Face, Replicate, DeepInfra, Fireworks AI, Codestral, Hyperbolic, Scaleway, Google AI, SiliconFlow, Together AI, Cloudflare Workers AI, Perplexity, ZAI, DashScope (Alibaba), iFlow
+2. 159 coding models across 8 tiers (S+, S, A+, A, A-, B+, B, C)
+3. Proxy system available for unified account management when needed
+4. Launcher ecosystem available for hardening on demand
+
+---
+
+**Release date:** 2026-03-09
+**Commit:** 0.2.0 — Unified stable release

package/changelog/v0.1.89.md

@@ -0,0 +1,22 @@
+# Changelog v0.1.89 - 2026-03-09
+
+### Added
+
+- 🎨 Dynamic color coding for active Tier and Provider filter badges — each tier/provider now displays with its signature color directly in the header and footer pills for better visual feedback.
+- 📖 Comprehensive documentation refresh across JSDoc headers in `bin/free-coding-models.js` to clarify the new default startup behavior, ping cadence states, and removal of the startup menu.
+
+### Changed
+
+- 🛡️ **Hardened public launcher set** — Narrowed the Z-cycle to only the stable, tested integrations: `OpenCode CLI` → `OpenCode Desktop` → `OpenClaw` → `Crush` → `Goose`. Aider, Claude Code, Codex CLI, Gemini CLI, Qwen Code, OpenHands, Amp, and Pi are now temporarily disabled pending flow hardening.
+- 🎯 **Improved Crush configuration** — Now writes proper `config.models.large` default selection (instead of relying on CLI args), respects proxy enablement state, and uses `disable_default_providers` to rely on FCM's provider configuration.
+- 🔧 **Crush launcher robustness** — Spawn call simplified to not pass `--model` argument; model selection now driven entirely through `crush.json` to avoid CLI parsing conflicts.
+- 📚 **Synchronized in-app help** — Removed references to temporarily disabled launchers from the Z-cycle hint and CLI flag examples to reduce user confusion and match the hardened set.
+- ✅ **Refined filter UI responsiveness** — Active Tier and Provider filter values now visually highlight in the main table footer hotkeys with tier-matched or provider-matched colors for instant recognition.
+
+### Fixed
+
+- 🪪 **Crush proxy support** — Crush now correctly detects when proxy mode is enabled and routes through the local FCM proxy (`http://127.0.0.1:<port>/v1`) with appropriate token/URL substitution instead of attempting direct provider connection.
+- 📖 **Shell compatibility** — Fixed spawning command for external tools to use `shell: true` only on Windows; Linux/macOS now spawn without shell wrapper for cleaner process trees.
+- 🎛 **Filter state persistence** — Tier and Provider filter badges in the footer now correctly calculate and display their active state across all state transitions.
+
+---

package/changelog/v0.1.9.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.9 - 2026-02-22
+
+_No release notes available for this version._

package/changelog/v0.2.0.md

@@ -0,0 +1,30 @@
+# Changelog v0.2.0 - 2026-03-09
+
+### Added
+
+- 🧰 Added direct launch modes for `Crush` and `Goose` as hardened public launchers, with additional internal support for `Aider`, `Claude Code`, `Codex CLI`, `Gemini CLI`, `Qwen Code`, `OpenHands`, `Amp`, and `Pi` (temporarily disabled from public cycle pending hardening).
+- 🧹 Added OpenCode proxy cleanup in Settings plus a `--clean-proxy` CLI command to remove persisted `fcm-proxy` config safely.
+- 🎨 Dynamic color coding for active Tier and Provider filter badges — each tier/provider now displays with its signature color directly in the header and footer pills for better visual feedback.
+- 📖 Comprehensive documentation refresh across JSDoc headers in `bin/free-coding-models.js` to clarify the new default startup behavior, ping cadence states, and removal of the startup menu.
+
+### Changed
+
+- 🧭 Extended the `Z` tool cycle, CLI flag parser, help overlay, and header mode badge so the active target tool is visible and switchable across all supported launchers.
+- 🔀 Made the multi-account proxy opt-in and disabled by default, added Settings controls for proxy enablement, OpenCode persistence, and preferred port, and restored direct OpenCode launch as the default path.
+- 🎛 Active Tier and Provider filters now show their current value directly inside the highlighted pills, while Crush now writes a real default selected model into `crush.json` and uses either direct provider config or the local FCM proxy depending on the current proxy setting.
+- 📚 Audited and synchronized the public documentation, in-app help, and footer hints so they now describe the hardened launcher set (`OpenCode CLI`, `OpenCode Desktop`, `OpenClaw`, `Crush`, `Goose`), the real default startup behavior, the current ping cadence, the Settings shortcuts, and the proxy-only request log semantics.
+- 🛡️ **Hardened public launcher set** — Narrowed the Z-cycle to only the stable, tested integrations: `OpenCode CLI` → `OpenCode Desktop` → `OpenClaw` → `Crush` → `Goose`. Aider, Claude Code, Codex CLI, Gemini CLI, Qwen Code, OpenHands, Amp, and Pi are now temporarily disabled pending flow hardening.
+- 🎯 **Improved Crush configuration** — Now writes proper `config.models.large` default selection (instead of relying on CLI args), respects proxy enablement state, and uses `disable_default_providers` to rely on FCM's provider configuration.
+- 🔧 **Crush launcher robustness** — Spawn call simplified to not pass `--model` argument; model selection now driven entirely through `crush.json` to avoid CLI parsing conflicts.
+- 📚 **Synchronized in-app help** — Removed references to temporarily disabled launchers from the Z-cycle hint and CLI flag examples to reduce user confusion and match the hardened set.
+- ✅ **Refined filter UI responsiveness** — Active Tier and Provider filter values now visually highlight in the main table footer hotkeys with tier-matched or provider-matched colors for instant recognition.
+
+### Fixed
+
+- 🪫 Temporarily removed unstable external launchers (`Aider`, `Claude Code`, `Codex CLI`, `Gemini CLI`, `Qwen Code`, `OpenHands`, `Amp`, `Pi`) from the public mode cycle/help so only the currently hardened integrations remain exposed.
+- 🧭 Corrected stale docs that still advertised the removed startup picker, mislabeled the `X` overlay as a live activity/error log viewer, and listed public commands or tips that no longer matched the current UI.
+- 🪪 **Crush proxy support** — Crush now correctly detects when proxy mode is enabled and routes through the local FCM proxy (`http://127.0.0.1:<port>/v1`) with appropriate token/URL substitution instead of attempting direct provider connection.
+- 📖 **Shell compatibility** — Fixed spawning command for external tools to use `shell: true` only on Windows; Linux/macOS now spawn without shell wrapper for cleaner process trees.
+- 🎛 **Filter state persistence** — Tier and Provider filter badges in the footer now correctly calculate and display their active state across all state transitions.
+
+---

package/changelog/v0.2.1.md

@@ -0,0 +1,17 @@
+# Changelog v0.2.1 - 2026-03-09
+
+### Added
+
+- 🚨 Added a footer warning that highlights outdated installs with a red banner and the message `This version is outdated .` once a newer npm version is detected.
+
+### Changed
+
+- 💾 The `Z` launcher choice is now persisted in config, so the app restarts on the last tool used instead of always falling back to OpenCode CLI.
+- 📋 The request log overlay now highlights proxy fallback reroutes with a dedicated `SWITCHED ↻` route badge and shows `requested → actual` model transitions inline.
+
+### Fixed
+
+- 🔀 Fixed the footer proxy status so an active proxy now renders as running instead of incorrectly showing `Proxy not configured`.
+- ⚙️ Fixed the footer proxy status so a proxy enabled in Settings now shows as configured even before the local proxy process is started.
+- 🧭 Fixed the main TUI footer so the outdated-version warning appears directly under the proxy status line where users can see it immediately.
+- 🧠 Fixed proxy-backed launcher model selection so `Crush` and `Goose` now use the universal `fcm-proxy` model slug instead of stale provider-specific ids when proxy mode is enabled.

package/changelog/v0.2.10.md

@@ -0,0 +1,7 @@
+# Changelog v0.2.10 - 2026-03-14
+
+### Changed
+- **Discord invite link**: Updated to permanent non-expiring link `https://discord.gg/ZTNFHvvCkU` in README and TUI footer
+- **NVIDIA NIM**: Added MiniMax M2.5 (S+ tier) to model list
+
+---

package/changelog/v0.2.11.md

@@ -0,0 +1,6 @@
+# Changelog v0.2.11 - 2026-03-14
+
+### Added
+- **Pi Coding Agent support**: Enabled Pi (pi.dev) as a launchable mode in the Z key cycle. Select a model and press Enter to configure Pi's config file and spawn the PI coding agent CLI with the chosen model and API endpoint.
+
+---

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.