Skip to content

v1.2.1

Latest

Choose a tag to compare

@bytonylee bytonylee released this 28 Apr 18:58

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-cli and legacy @jyoung105/free-router compatibility
    shims that re-exec the new @bytonylee/free-router package.
  • Added a simple homepage Usage section after Installation with the main
    free-router and free-router --best commands.

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.json generated 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.txt discovery 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-router scope.
  • 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 typecheck
  • bun run lint
  • bun run build
  • bun run --cwd site build

The site build completes successfully, with the existing Vite warning about the
repo ES2025 TypeScript target.