Overview
free-router 1.2.1 is a patch release that consolidates 90 commits since
v1.2.0. The release focuses on safer OpenCode/OpenClaw handoff behavior,
fresher model metadata, a more stable terminal UI, compatibility shims for the
package rename, and a clearer public site.
Highlights
- Added OpenClaw target sync when applying a selected model, so OpenCode and
OpenClaw configuration stay aligned from the same router selection. - Added fallback handling for unsupported OpenCode selections, with DeepSeek V4
Pro as the default fallback and docs describing the behavior. - Updated OpenCode support mapping to use Models.dev, matching current OpenCode
provider/model metadata instead of stale hardcoded OpenRouter source data. - Refreshed model rankings, generated CSV/Markdown outputs, and support data so
the CLI and site share the same catalog. - Added the
frouter-cliand legacy@jyoung105/free-routercompatibility
shims that re-exec the new@bytonylee/free-routerpackage. - Added a simple homepage Usage section after Installation with the main
free-routerandfree-router --bestcommands.
CLI and TUI
- Improved terminal rendering stability by reducing idle/background redraws,
keeping selected row markers stable, and tuning modal/header/footer chrome. - Reworked search and selection presentation: provider tags sit above search,
empty search states render in the table, selected model metadata is centered,
and terminal-safe verdict markers are used. - Added a selected-row spinner and improved selected-model placement so the
active route is easier to scan while providers are pinging. - Simplified shortcut/search status text and removed older workflow references
from the README. - Flagged rejected NVIDIA API keys more clearly and improved provider status tag
behavior.
Model Catalog and OpenCode Support
- Rebuilt the synced rankings catalog from the current NIM/OpenRouter sources.
- Enforced LLM/VLM-only catalog filtering in the model sync script.
- Regenerated
model-rankings.json,model-rankings.csv, and
model-rankings.md. - Added
model-support.jsongenerated from Models.dev for OpenCode support. - Changed missing OpenCode support matches to remain unknown instead of being
forced unsupported, allowing fallback rules to handle them later. - Preserved vendor-prefixed model IDs such as
nvidia/...when they appear
under OpenRouter.
Site
- Added theme-aware favicon assets and prepaint favicon switching.
- Added
llms.txtdiscovery output and build verification for generated LLM
artifacts. - Fixed canonical URLs, root favicon links, and domain-root deployment behavior.
- Updated the homepage copy, MIT label, Korean wording, split hero lede, and
generated model table. - Added homepage Usage commands and updated the visible site version to
v1.2.1.
Packaging and Release Infrastructure
- Published package metadata under the new
@bytonylee/free-routerscope. - Added compatibility shims for the old package names.
- Moved shim package files under
publish/and updated release documentation to
point at that layout. - Removed the unused shim release lane.
- Removed mandatory automated tests from the default validation policy while
keeping lint, typecheck, and build as enforced checks.
Verification
bun run typecheckbun run lintbun run buildbun run --cwd site build
The site build completes successfully, with the existing Vite warning about the
repo ES2025 TypeScript target.