free-coding-models 0.3.67 → 0.3.68

package/changelog/v0.1.1.md

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

package/changelog/v0.1.10.md

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

package/changelog/v0.1.11.md

@@ -0,0 +1,10 @@
+# Changelog v0.1.11 - 2026-02-22
+
+Add unit tests (59 tests), extract pure logic to lib/utils.js, fix GitHub Actions release workflow.
+
+- Extract getAvg, getVerdict, getUptime, sortResults, filterByTier, findBestModel, parseArgs to lib/utils.js
+- Add comprehensive test suite using node:test (sources integrity, core logic, CLI parsing, package sanity)
+- Fix release.yml: remove broken npm version patch, add version detection via git tags, add GitHub Release creation
+- Update AGENTS.md with test-first workflow instructions
+
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

package/changelog/v0.1.12.md

@@ -0,0 +1,16 @@
+# Changelog v0.1.12 - 2026-02-22
+
+### Added
+- Unit test suite: 59 tests across 11 suites using `node:test` (zero dependencies)
+- Tests cover: sources data integrity, core logic (getAvg, getVerdict, getUptime, filterByTier, sortResults, findBestModel), CLI arg parsing, package.json sanity
+- `lib/utils.js`: extracted pure logic functions from the monolithic CLI for testability
+- `pnpm test` script in package.json
+
+### Fixed
+- GitHub Actions release workflow: removed broken `npm version patch` loop, added version detection via git tags
+- GitHub Actions now creates a GitHub Release with auto-generated notes for each new version
+
+### Changed
+- AGENTS.md updated with test-first workflow: agents must run `pnpm test` before `pnpm start`
+
+---

package/changelog/v0.1.13.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.13 - 2026-02-22
+
+_Intermediate patch release — part of the unit test suite addition (see [v0.1.12](../v0.1.12))._

package/changelog/v0.1.14.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.14 - 2026-02-22
+
+_Intermediate patch release — part of the unit test suite addition (see [v0.1.12](../v0.1.12))._

package/changelog/v0.1.15.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.15 - 2026-02-22
+
+_Intermediate patch release — part of the unit test suite addition (see [v0.1.12](../v0.1.12))._

package/changelog/v0.1.16.md

@@ -0,0 +1,13 @@
+# Changelog v0.1.16 - 2026-02-22
+
+### Added
+- OpenCode Desktop support: new `--opencode-desktop` flag and menu option to set model & open the Desktop app
+- "Read Changelogs" menu option when an update is available (opens GitHub releases page)
+- `startOpenCodeDesktop()` function — same config logic as CLI, launches via `open -a OpenCode`
+
+### Changed
+- Startup menu: "OpenCode" renamed to "OpenCode CLI", new "OpenCode Desktop" entry added
+- TUI mode badge: shows `[💻 CLI]` or `[🖥 Desktop]` or `[🦞 OpenClaw]`
+- Footer action hint adapts to desktop mode (`Enter→OpenDesktop`)
+
+---

package/changelog/v0.1.17.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.17 - 2026-02-22
+
+_Intermediate patch release — part of the OpenCode Desktop iteration (see [v0.1.16](../v0.1.16))._

package/changelog/v0.1.18.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.18 - 2026-02-22
+
+_Intermediate patch release — part of the OpenCode Desktop iteration (see [v0.1.16](../v0.1.16))._

package/changelog/v0.1.19.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.19 - 2026-02-22
+
+_Intermediate patch release — part of the OpenCode Desktop iteration (see [v0.1.16](../v0.1.16))._

package/changelog/v0.1.2.md

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

package/changelog/v0.1.20.md

@@ -0,0 +1,14 @@
+# Changelog v0.1.20 - 2026-02-22
+
+### Added
+- **Dynamic tier filtering**: Use E/D keys to filter models by tier during runtime
+- Tier filter badge shown in header (e.g., `[Tier S]`)
+- E key elevates filter (show fewer, higher-tier models)
+- D key descends filter (show more, lower-tier models)
+- Preserves ping history when changing filters
+
+### Fixed
+- **Error 401 with --tier flag**: Fixed issue where using `--tier` alone would show selection menu instead of proceeding directly to TUI
+- Improved flag combination handling for better user experience
+
+---

package/changelog/v0.1.21.md

@@ -0,0 +1,12 @@
+# Changelog v0.1.21 - 2026-02-22
+
+### Refactored
+- **Simplified tier filtering architecture**: Replaced complex object recreation with simple `hidden` flag system
+- **Flags as shortcuts**: `--tier S` now just sets initial state instead of blocking dynamic filtering
+- **Dynamic filtering preserved**: E/D keys work seamlessly even when starting with `--tier` flag
+
+### Fixed
+- **Ping loop bug**: Fixed issue where filtered models weren't pinged due to using wrong results array
+- **Initial ping bug**: Fixed issue where initial ping used wrong results array
+
+---

package/changelog/v0.1.22.md

@@ -0,0 +1,6 @@
+# Changelog v0.1.22 - 2026-02-22
+
+### Changed
+- **Local changelogs**: "Read Changelogs" menu option now opens local `CHANGELOG.md` file instead of GitHub releases
+
+---

package/changelog/v0.1.23.md

@@ -0,0 +1,16 @@
+# Changelog v0.1.23 - 2026-02-22
+
+### Refactored
+- **Removed startup menu**: No more blocking mode selection menu at startup
+- **Default to OpenCode CLI**: App starts directly in CLI mode when no flags given
+- **Mode toggle in TUI**: Added Z key to cycle between CLI → Desktop → OpenClaw → CLI
+- **GitHub changelogs**: "Read Changelogs" option now opens GitHub URL instead of local file
+- **Auto-update by default**: When new version available without flags, auto-updates and relaunches
+- **Centered update menu**: Update notification appears only when needed, with clean centered layout
+
+### Changed
+- **Header display**: Shows `[💻 CLI] (Z to toggle)` with mode toggle hint
+- **Footer instructions**: Added "M Mode" to key bindings
+- **Update workflow**: Flags (`--opencode` etc.) still show update menu for compatibility
+
+---

package/changelog/v0.1.24.md

@@ -0,0 +1,9 @@
+# Changelog v0.1.24 - 2026-02-22
+
+## What's Changed
+* fix: TUI viewport scrolling for Ghostty and narrow terminals by @whit3rabbit in https://github.com/vava-nessa/free-coding-models/pull/10
+
+## New Contributors
+* @whit3rabbit made their first contribution in https://github.com/vava-nessa/free-coding-models/pull/10
+
+**Full Changelog**: https://github.com/vava-nessa/free-coding-models/compare/v0.1.23...v0.1.24

package/changelog/v0.1.25.md

@@ -0,0 +1,13 @@
+# Changelog v0.1.25 - 2026-02-22
+
+### Added
+- **Discord community link**: Added Discord invite to README and TUI footer
+- **Enhanced footer layout**: Improved footer with multi-line layout showing GitHub repo and Discord links
+- **Clickable author name**: "vava-nessa" is now clickable in terminal (opens GitHub profile)
+- **Release notes automation**: GitHub Actions now uses CHANGELOG.md content for release notes instead of auto-generated notes
+### Changed
+- **Tier filtering system**: Replaced E/D keys with T key that cycles through tier filters: all → S+/S → A+/A/A- → B+/B → C → all
+- **Footer text**: "Made with love by vava-nessa" with clickable links
+### Fixed
+- **Release workflow**: GitHub Releases now display proper changelog content instead of generic commit summaries
+---

package/changelog/v0.1.26.md

@@ -0,0 +1,6 @@
+# Changelog v0.1.26 - 2026-02-22
+
+### Changed
+- **Footer improvements**: Replaced "Repository GitHub" with "GitHub", "love" with 💖 emoji, and simplified Discord text
+- **README enhancement**: Added GitHub link section below Discord invite
+---

package/changelog/v0.1.27.md

@@ -0,0 +1,6 @@
+# Changelog v0.1.27 - 2026-02-22
+
+### Changed
+- **Footer redesign**: All links now on one line with clickable text: "Join our Discord!" and "Read the docs on GitHub"
+- **Improved UX**: Links use same clickable format as author name for consistent user experience
+---

package/changelog/v0.1.28.md

@@ -0,0 +1,5 @@
+# Changelog v0.1.28 - 2026-02-22
+
+### Added
+- **Footer emojis**: Added 💬 emoji before Discord link and ⭐ emoji before GitHub link for better visual appeal
+---

package/changelog/v0.1.29.md

@@ -0,0 +1,5 @@
+# Changelog v0.1.29 - 2026-02-22
+
+### Fixed
+- **Discord link correction**: Updated all Discord invite URLs to use permanent link https://discord.gg/WKA3TwYVuZ
+---

package/changelog/v0.1.3.md

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

package/changelog/v0.1.31.md

@@ -0,0 +1,10 @@
+# Changelog v0.1.31 - 2026-02-22
+
+### Added
+- **SWE-bench column**: Added new SWE-bench Verified score column showing coding performance for each model
+- **Color-coded column headers**: First letter of each column header is now colored (yellow) to indicate keyboard shortcut for sorting
+- **Keyboard shortcut improvements**: Changed P to L for latest ping sorting, added E for SWE-bench sorting
+### Changed
+- **Source name simplification**: Renamed "NVIDIA NIM" to "NIM" throughout the codebase
+- **Enhanced footer Discord link**: Discord link now displays in bright cyan color with "(link fixed)" indicator
+---

package/changelog/v0.1.32.md

@@ -0,0 +1,8 @@
+# Changelog v0.1.32 - 2026-02-22
+
+### Changed
+- **Column header improvements**: Fixed column alignment issues for better visual appearance
+- **Status renamed to Condition**: "Status" column renamed to "Condition" for clarity
+- **Keyboard shortcut updates**: S key now sorts by SWE-bench score, C key sorts by Condition
+- **Footer Discord text update**: Changed "Join our Discord!" to "Join Free-Coding-Models Discord!"
+---

package/changelog/v0.1.33.md

@@ -0,0 +1,5 @@
+# Changelog v0.1.33 - 2026-02-22
+
+### Fixed
+- **Column header alignment**: Fixed column headers misalignment issue caused by ANSI color codes interfering with text padding
+---

package/changelog/v0.1.34.md

@@ -0,0 +1,6 @@
+# Changelog v0.1.34 - 2026-02-22
+
+### Changed
+- **Condition renamed to Health**: Renamed "Condition" column to "Health" for better clarity
+- **Keyboard shortcut update**: H key now sorts by Health (instead of C for Condition)
+---

package/changelog/v0.1.35.md

@@ -0,0 +1,5 @@
+# Changelog v0.1.35 - 2026-02-22
+
+### Changed
+- **Column reorganization**: Reordered columns for better logical flow: Rank / Tier / SWE% / Model / Origin / Latest Ping / Avg Ping / Health / Verdict / Up%
+---

package/changelog/v0.1.36.md

@@ -0,0 +1,16 @@
+# Changelog v0.1.36 - 2026-02-22
+
+### Added
+- **SWE-bench Verified column**: Shows real SWE-bench Verified scores for all 44 models from official benchmarks
+- **Color-coded keyboard shortcuts**: First letter of each column header colored in yellow to indicate sorting key
+- **Heart and Coffee in footer**: "Made with 💖 & ☕ by vava-nessa"
+### Changed
+- **Column organization**: Reordered columns for better logical flow: Rank / Tier / SWE% / Model / Origin / Latest Ping / Avg Ping / Health / Verdict / Up%
+- **Health column**: Renamed from "Status" to "Health" with H key for sorting
+- **SWE-bench sorting**: S key now sorts by SWE-bench score
+- **Latest ping shortcut**: L key (instead of P) for sorting by latest ping
+- **Source name**: Simplified "NVIDIA NIM" to "NIM"
+### Fixed
+- **Column header alignment**: Fixed misalignment caused by ANSI color codes in headers
+- **Discord link**: Updated to permanent invite link https://discord.gg/WKA3TwYVuZ
+---

package/changelog/v0.1.37.md

@@ -0,0 +1,5 @@
+# Changelog v0.1.37 - 2026-02-22
+
+### Added
+- **Auto-update with sudo fallback**: When npm update fails due to permissions, automatically retries with sudo to complete the update
+---

package/changelog/v0.1.38.md

@@ -0,0 +1,9 @@
+# Changelog v0.1.38 - 2026-02-22
+
+### Fixed
+- **Cross-platform OpenCode integration**: Fixed OpenCode CLI and Desktop installation issues on Windows and Linux
+  - **Windows**: Fixed config path to use %APPDATA%\opencode\opencode.json with fallback to ~/.config
+  - **Linux**: Added support for snap, flatpak, and xdg-open to launch OpenCode Desktop
+  - **All platforms**: Properly detects OS and uses correct commands and paths
+  - **OpenCode Desktop**: Platform-specific launch commands (macOS: `open -a`, Windows: `start`, Linux: multiple methods)
+---

package/changelog/v0.1.39.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.39 - 2026-02-22
+
+_Intermediate patch release — part of the cross-platform OpenCode fixes (see [v0.1.38](../v0.1.38))._

package/changelog/v0.1.4.md

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

package/changelog/v0.1.40.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.40 - 2026-02-22
+
+_Intermediate patch release — part of the cross-platform OpenCode fixes (see [v0.1.38](../v0.1.38))._

package/changelog/v0.1.41.md

@@ -0,0 +1,11 @@
+# Changelog v0.1.41 - 2026-02-22
+
+### Changed
+- **sources.js data audit** — verified and corrected SWE-bench scores, tiers, and context windows across all NIM models:
+  - Devstral 2 123B: `S, 62.0%, 128k` → `S+, 72.2%, 256k` (official Mistral announcement)
+  - Mistral Large 675B: ctx `128k` → `256k`
+  - QwQ 32B: ctx `32k` → `131k`
+  - Llama 4 Maverick: ctx `128k` → `1M` (NVIDIA NIM confirmed)
+  - Llama 4 Scout: ctx `128k` → `10M` (NVIDIA NIM confirmed)
+  - GPT OSS 20B: ctx `32k` → `128k`
+---

package/changelog/v0.1.42.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.42 - 2026-02-22
+
+_Intermediate patch release — part of the multi-provider iteration (see [v0.1.44](../v0.1.44) for full changelog)._

package/changelog/v0.1.43.md

@@ -0,0 +1,3 @@
+# Changelog v0.1.43 - 2026-02-22
+
+_Intermediate patch release — part of the multi-provider iteration (see [v0.1.44](../v0.1.44) for full changelog)._

package/changelog/v0.1.44.md

@@ -0,0 +1,17 @@
+# Changelog v0.1.44 - 2026-02-22
+
+### Added
+- **Multi-provider support** — Groq (6 models) and Cerebras (3 models) added alongside NVIDIA NIM, for 53 total models
+- **Multi-provider first-run wizard** — Steps through all 3 providers (NIM, Groq, Cerebras) on first launch; each is optional, Enter to skip; requires at least one key
+- **Settings screen (`P` key)** — New TUI overlay to manage API keys per provider, toggle providers on/off, and test keys with a live ping
+- **`lib/config.js`** — New JSON config system (`~/.free-coding-models.json`) replacing the old plain-text file
+  - Auto-migrates old `~/.free-coding-models` (plain nvidia key) on first run
+  - Stores keys per provider + per-provider enabled/disabled state
+  - `NVIDIA_API_KEY`, `GROQ_API_KEY`, `CEREBRAS_API_KEY` env vars override config
+- **Per-provider ping URLs** — `ping()` now accepts explicit endpoint URL; each provider has its own API endpoint in `sources.js`
+- **Provider name in Origin column** — Shows `NIM` / `Groq` / `Cerebras` instead of always `NIM`
+### Changed
+- `MODELS` flat array now includes `providerKey` as 6th element
+- State init filters models from disabled providers; rebuilds on settings close
+- Config file path changed from `~/.free-coding-models` to `~/.free-coding-models.json` (migration is automatic)
+---

package/changelog/v0.1.45.md

@@ -0,0 +1,6 @@
+# Changelog v0.1.45 - 2026-02-22
+
+### Fixed
+- **Discord notification**: Fixed GitHub Actions workflow crash (secrets context not allowed in step `if` conditions — now handled in the Node script directly)
+
+---

package/changelog/v0.1.46.md

@@ -0,0 +1,9 @@
+# Changelog v0.1.46 - 2026-02-23
+
+### Fixed
+- **Discord notification**: Fixed ECONNRESET error — drain response body with `res.resume()` and call `process.exit(0)` immediately after success so the Node process closes cleanly
+
+### Changed
+- **Discord link**: Updated invite URL to `https://discord.gg/5MbTnDC3Md` everywhere (README, TUI footer)
+
+---

package/changelog/v0.1.47.md

@@ -0,0 +1,6 @@
+# Changelog v0.1.47 - 2026-02-23
+
+### Changed
+- Release test
+
+---

package/changelog/v0.1.48.md

@@ -0,0 +1,11 @@
+# Changelog v0.1.48 - 2026-02-23
+
+### Fixed
+- **`--tier` CLI flag**: `parseArgs()` was never called in `main()`, so `--tier S` was silently ignored — now wired in and applied on TUI startup (thanks @whit3rabbit, PR #11)
+- **`--tier` value leaking into `apiKey`**: `parseArgs()` for-loop was capturing the tier value as the API key — fixed by skipping the value arg after `--tier`
+- **Ctrl+C not exiting**: sort key handler was intercepting all single-letter keypresses including ctrl-modified ones — added `!key.ctrl` guard so Ctrl+C reaches the exit handler (PR #11)
+
+### Added
+- Test verifying `--tier` value does not leak into `apiKey` (63 tests total)
+
+---

package/changelog/v0.1.49.md

@@ -0,0 +1,10 @@
+# Changelog v0.1.49 - 2026-02-23
+
+### Fixed
+- **Cerebras / Groq without API key**: models were being pinged with the fallback NVIDIA key, causing misleading `❌ 401` — now pings without auth header; 401 is treated as `🔑 NO KEY` (server reachable, latency shown dimly)
+- **Settings: entering an API key had no immediate effect**: after saving a key and closing Settings (Escape), models previously in `noauth` state are now immediately re-pinged with the new key
+
+### Changed
+- Ping without API key is now always attempted — a 401 response confirms the server is UP and shows real latency; `🔑 NO KEY` replaces the old `❌ 401` misleading error
+
+---

package/changelog/v0.1.5.md

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

package/changelog/v0.1.50.md

@@ -0,0 +1,7 @@
+# Changelog v0.1.50 - 2026-02-23
+
+### Fixed
+- **Groq/Cerebras models selected for OpenCode were launched as NVIDIA models**: `providerKey` was not passed in `userSelected` on Enter, causing all models to be prefixed with `nvidia/` regardless of their actual provider — now correctly uses `groq/model-id` and `cerebras/model-id`
+- **`startOpenCode` and `startOpenCodeDesktop`**: both functions now handle all 3 providers; Groq and Cerebras use OpenCode's built-in provider support (no custom config block needed, just `GROQ_API_KEY`/`CEREBRAS_API_KEY` env vars); NVIDIA retains its existing custom provider config flow
+
+---

package/changelog/v0.1.51.md

@@ -0,0 +1,4 @@
+# Changelog v0.1.51 - 2026-02-23
+
+### Fixed
+- **Groq/Cerebras models selected for OpenCode had no provider block**: even with the correct `groq/model-id` prefix, OpenCode couldn't use the model because no `provider.groq` block existed in `opencode.json` — now automatically creates the provider block (Groq: built-in with `apiKey: {env:GROQ_API_KEY}`; Cerebras: `@ai-sdk/openai-compatible` with baseURL) and registers the model in `provider.<key>.models`

package/changelog/v0.1.52.md

@@ -0,0 +1,10 @@
+# Changelog v0.1.52 - 2026-02-23
+
+### Fixed
+- **OpenCode model handoff** (PR #14 by @whit3rabbit): API keys from `~/.free-coding-models.json` were not passed to the OpenCode child process, causing silent fallback to the previous model. Also fixes Groq model ID mismatches (e.g. `kimi-k2-instruct` → `kimi-k2-instruct-0905`) via a new `OPENCODE_MODEL_MAP`
+- **OpenClaw nvidia provider missing models array** (PR #13 by @whit3rabbit): `startOpenClaw()` created the nvidia provider block without a `models` property, causing Zod schema validation to reject the config
+
+### Improved
+- **Discord link in TUI footer**: the invite URL is now displayed in plain text on a separate line so it's visible and copiable on terminals that don't support clickable links
+
+---

package/changelog/v0.1.54.md

@@ -0,0 +1,41 @@
+# Changelog v0.1.54 - 2026-02-23
+
+### Added — Providers & Models
+
+**5 new providers** (9 total, 101 models):
+
+- **OpenRouter** — 8 free coding models via the `:free` quota tier (20 req/min, 50 req/day shared). Includes Qwen3 Coder, Step 3.5 Flash, DeepSeek R1 0528, GPT OSS 120B/20B, Nemotron Nano 30B, Llama 3.3 70B. Key prefix: `sk-or-`
+- **Mistral Codestral** — dedicated coding endpoint (`codestral.mistral.ai`), `codestral-latest` model, 30 req/min / 2 000 req/day. Separate API key from the main Mistral platform. Key prefix: `csk-`
+- **Hyperbolic** — $1 free trial credits. 10 models: Qwen3 Coder 480B, DeepSeek R1 0528, Kimi K2, GPT OSS 120B, Qwen3 235B, Qwen3 80B Instruct, DeepSeek V3 0324, Qwen2.5 Coder 32B, Llama 3.3 70B, Llama 3.1 405B. Key prefix: `eyJ`
+- **Scaleway** — 1 million free tokens. 7 models: Devstral 2 123B, Qwen3 235B, GPT OSS 120B, Qwen3 Coder 30B, Llama 3.3 70B, R1 Distill 70B, Mistral Small 3.2. Key prefix: `scw-`
+- **Google AI Studio** — free Gemma 3 models (14 400 req/day, 30 req/min). Gemma 3 27B / 12B / 4B via the OpenAI-compatible `generativelanguage.googleapis.com/v1beta/openai` endpoint. Key prefix: `AIza`
+
+**New models in existing providers:**
+
+- **Groq**: GPT OSS 120B (`openai/gpt-oss-120b`), GPT OSS 20B (`openai/gpt-oss-20b`), Qwen3 32B (`qwen/qwen3-32b`)
+- **Cerebras**: GLM 4.6 (`glm-4.6`) from Z.ai — 10 req/min, 100 req/day
+- **SambaNova**: DeepSeek V3.1 Terminus (`deepseek-ai/DeepSeek-V3.1-Terminus`, S tier 68.4%)
+
+### Added — TUI Features
+
+- **`N` key — Origin/provider filter**: cycles through All → NIM → Groq → Cerebras → SambaNova → OpenRouter → Codestral → Hyperbolic → Scaleway → Google AI → All, mirroring how `T` cycles tiers. The active provider is shown as a badge in the header. The Origin column header now reads `Origin(N)` and highlights in blue when a filter is active.
+- **`C` key — Sort by context window**: the context-window sort was previously on `N`; moved to `C` (mnemonic: Context) to free up `N` for the origin filter.
+- **`K` key — Help overlay**: press `K` (or `Esc`) to open/close a full keyboard shortcut reference listing every key and what it does, rendered in the alt-screen buffer without leaving the TUI.
+- **`Esc` closes help and settings**: pressing Escape now dismisses both the `K` help overlay and the `P` settings screen. The help overlay intercepts Esc before the settings handler so there is no key conflict.
+
+### Changed — README & UI
+
+- Provider count badge updated: **4 → 9 providers**
+- Model count badge updated: **67 → 101 models**
+- Requirements section lists all 9 providers with their signup URLs
+- Discord header block replaced with a plain `💬 Let's talk about the project on Discord` link
+- Support section reformatted: GitHub issues link + Discord link on separate lines + docs link with inline BETA warning (`⚠️ free-coding-models is a BETA TUI — expect rough edges and occasional crashes`)
+- Footer hint line updated: `T Tier  •  N Origin  •  … C` replaces old `N` in sort hint; `K Help` added
+
+### Technical
+
+- `sources.js`: 5 new named exports; `sources` object extended to 9 entries; `@exports` JSDoc updated
+- `lib/config.js`: `ENV_VARS` extended with `openrouter`, `codestral`, `hyperbolic`, `scaleway`, `googleai`; JSDoc config structure comment updated
+- `bin/free-coding-models.js`: first-run wizard extended to 9 providers; `ENV_VAR_NAMES` extended; OpenCode/OpenCode-Desktop provider blocks added for all 5 new providers (all use `@ai-sdk/openai-compatible` + baseURL); `ORIGIN_CYCLE` + `originFilterMode` state; `renderTable` signature gains `originFilterMode` parameter; `renderHelp()` function added; all `renderTable` call sites updated
+
+---

package/changelog/v0.1.55.md

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

package/changelog/v0.1.56.md

@@ -0,0 +1,11 @@
+# Changelog v0.1.56 - 2026-02-23
+
+## What's new
+
+### TUI Footer
+
+- **Footer cleaned up and restructured**: removed duplicate/messy lines; consolidated into two clean footer lines:
+  - Line 1: `Made with 💖 & ☕ by vava-nessa  •  ⭐ Star on GitHub` (clickable links)
+  - Line 2: `💬 Join our Discord  •  ⚠ BETA TUI — might crash or have problems`
+- **BETA warning added to TUI footer**: `⚠ BETA TUI` badge in yellow with a plain-text disclaimer, always visible at the bottom of the TUI app
+- **Discord invite in TUI footer**: clickable OSC 8 hyperlink added directly in the footer (was only in README before)

package/changelog/v0.1.57.md

@@ -0,0 +1,7 @@
+# Changelog v0.1.57 - 2026-02-23
+
+## What's new
+
+### TUI Footer
+
+- **Discord link text shortened**: "Join our Discord" replaces the longer previous label — cleaner footer, same clickable OSC 8 hyperlink

package/changelog/v0.1.58.md

@@ -0,0 +1,7 @@
+# Changelog v0.1.58 - 2026-02-23
+
+## What's new
+
+### TUI
+
+- **Timeout emoji updated**: replaced `⏱` with `⏳` everywhere in the TUI (ping timeout display)

package/changelog/v0.1.59.md

@@ -0,0 +1,7 @@
+# Changelog v0.1.59 - 2026-02-23
+
+## What's new
+
+### TUI Footer
+
+- **`K Help` badge in footer is now bright green**: previously plain text, now rendered as `chalk.bgGreen.black.bold(' K Help ')` so it's immediately visible in the footer hint line

package/changelog/v0.1.6.md

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

package/changelog/v0.1.60.md

@@ -0,0 +1,7 @@
+# Changelog v0.1.60 - 2026-02-23
+
+## What's new
+
+### TUI Footer
+
+- **Discord URL now shown in plain text**: after the clickable "Join our Discord" hyperlink, the raw URL `https://discord.gg/5MbTnDC3Md` is now printed in cyan, separated by `→`. This helps users on terminals that don't support OSC 8 clickable links to still see and copy-paste the URL.

package/changelog/v0.1.61.md

@@ -0,0 +1,9 @@
+# Changelog v0.1.61 - 2026-02-23
+
+## What's new
+
+### TUI Footer & UX
+
+- **"Made with" line is now pink**: the entire "Made with 💖 & ☕ by vava-nessa" sentence is now rendered in soft pink, making it visually distinct from the rest of the footer
+- **`K Help` badge is now ultra-visible**: changed from plain green background to bright green (`bgGreenBright`) with **yellow bold text** — stands out immediately at a glance in the footer hint line
+- **`P` key closes Settings**: pressing `P` again while inside the Settings screen now closes it (same behavior as `Esc`). Both keys now trigger the same close + provider rebuild logic

package/changelog/v0.1.62.md

@@ -0,0 +1,9 @@
+# Changelog v0.1.62 - 2026-02-23
+
+## What's new
+
+### TUI Footer & UX
+
+- **"Made with" line is now pink**: the entire "Made with 💖 & ☕ by vava-nessa" sentence is now rendered in soft pink, making it visually distinct from the rest of the footer
+- **`K Help` badge is now ultra-visible**: changed to bright green background (`bgGreenBright`) with **black bold text** — high contrast, stands out immediately at a glance in the footer hint line
+- **`P` key closes Settings**: pressing `P` again while inside the Settings screen now closes it (same behavior as `Esc`). Both keys now trigger the same close + provider rebuild logic

package/changelog/v0.1.63.md

@@ -0,0 +1,15 @@
+# Changelog v0.1.63 - 2026-02-24
+
+### Changed
+
+- Replaced webhook telemetry with PostHog capture API (`/i/v0/e/`) and kept explicit consent + `--no-telemetry` opt-out.
+- Added persistent anonymous telemetry identity in config (`telemetry.anonymousId`) for stable anonymous usage counts.
+- Added telemetry consent screen UX: custom ASCII onboarding, explicit privacy messaging, and “Accept & Continue” default action.
+- Added telemetry toggle in Settings (`P`) and documented env controls: `FREE_CODING_MODELS_TELEMETRY`, `FREE_CODING_MODELS_POSTHOG_KEY`, `FREE_CODING_MODELS_POSTHOG_HOST`.
+- Added telemetry metadata fields: `app_version`, `system` (`macOS`/`Windows`/`Linux`), and `terminal` (Terminal.app/iTerm2/kitty/etc. with fallback).
+- Added telemetry debug mode with `FREE_CODING_MODELS_TELEMETRY_DEBUG=1` (stderr traces for sent/skip/error states).
+- Hardened telemetry safety behavior: analytics failures stay non-blocking and non-TTY runs no longer overwrite stored consent.
+- Fixed consent renderer to avoid full-screen clear side effects and preserve header visibility across terminals.
+- Updated TUI footer contributors link to point to the repository contributors graph.
+
+---

package/changelog/v0.1.64.md

@@ -0,0 +1,22 @@
+# Changelog v0.1.64 - 2026-02-24
+
+### Added
+
+- Added 4 new free providers: Hugging Face Inference, Replicate, DeepInfra, and Fireworks AI (models, key handling, healthchecks, Settings integration).
+- Added richer Settings (`P`) provider rows with inline rate-limit summary and live API key test status.
+
+### Changed
+
+- OpenCode launch now detects `tmux` and auto-injects `--port` (`OPENCODE_PORT` if free, otherwise first available `4096-5095`) so sub-agent panes work reliably.
+- Updated OpenRouter free model set to include `qwen/qwen3-coder:480b-free`, `mistralai/devstral-2-free`, and `mimo-v2-flash-free`.
+- Added SambaNova `Llama3-Groq` coding-tuned entry.
+- Updated setup/config docs and env var support for new providers (`HUGGINGFACE_API_KEY`/`HF_TOKEN`, `REPLICATE_API_TOKEN`, `DEEPINFRA_API_KEY`/`DEEPINFRA_TOKEN`).
+- Replicate pings now use `/v1/predictions` request format; OpenCode launch for Replicate is guarded with a clear monitor-only message.
+- Settings bottom panel now shows provider onboarding steps (signup URL + key creation/test flow) instead of model list details.
+- Documented in `AGENTS.md` that top changelog entries must stay clean for direct reuse in GitHub Release notes.
+
+### Fixed
+
+- Settings/onboarding disabled state now uses an explicit red cross (`❌`) instead of a gray square glyph for better terminal font compatibility.
+
+---

package/changelog/v0.1.65.md

@@ -0,0 +1,15 @@
+# Changelog v0.1.65 - 2026-02-25
+
+### Added
+
+- Added persistent model favorites with `F` key toggle, star marker in Model column, dark-orange favorite highlighting, and pinned-at-top behavior.
+- Added manual update maintenance flow in Settings (`P`): check npm updates on demand and install directly from the settings screen.
+- Expanded `K` help overlay with complete keybindings (main TUI + settings) and CLI flags usage examples.
+
+### Changed
+
+- Favorites now remain visible and pinned regardless of active sort or tier/origin filters.
+- Extended config schema (`~/.free-coding-models.json`) with a persisted `favorites` array (`providerKey/modelId` entries).
+- Updated README documentation for favorites, manual updates, settings shortcuts, and config structure.
+
+---