vava-nessa/free-coding-models v0.5.66

on GitHub

Added

• 📚 Project-wide documentation overhaul — The README, the docs/ repo, and the marketing site (website/) were rewritten end-to-end by a pro doc pass. ~2,000 insertions / ~1,600 deletions across 29 files. Public behaviour is unchanged; this is a content-only release.

• Reordered README around the product priority — TUI → Web → Agent Extensions → Smart Model Router (last). The router and the extensions moved out of the middle of the doc and into dedicated sections at the end, so the TUI and the Web Dashboard (the two core surfaces) are now the centerpiece of the reading flow.

• Expanded Quick Start — grew from a 3-step outline to a 6-step user-centric walkthrough (Install → Grab a key → Launch & paste → Pick & launch → The 30-second cool tour → Go further). Each step links to the relevant deep section. Includes a headless sidebar (--json, --fiable) and a pre-target a tool from the command line example block.

• 🟢 Free AI Providers — kept the 20-provider table near the top, but now sits after Quick Start with a clean ⚠️ Health checks consume provider quota note and a collapsible 🧹 Providers removed from the catalog details block.

• 🎛️ TUI section — now opens with a First-run flow (3 steps), then 7 user-framed workflows ("Give me the fastest model that actually works", "Pick a model & launch", "Benchmark before I commit", "Smart Recommend", "Keep my go-to models pinned", "Switch tools without restarting", "My terminal theme fights the TUI colors"), followed by the complete keyboard reference and a mouse reference.

• 🌐 Web Dashboard — feature table condensed, web (port 3333) vs --daemon (port 19280) port distinction made explicit, Docker quick-start + image tags + env vars + compose + troubleshooting all in one place.

• 🔌 19 per-tool integration pages — replaced the previous 3 generic integration pages (opencode, pi-extension, openclaw) with a dedicated page for every supported target: OpenCode, Pi, OpenClaw, Crush, Goose, Aider, Kilo, Hermes, Continue, Cline, Amp, Qwen Code, ForgeCode, ZCode, jcode, Caveman Code, Copilot CLI, OpenHands, Xcode Intelligence. Each page documents the launch flag, the exact config file FCM writes (path + JSON example verified against src/core/tool-launchers.js), the install/bootstrap behaviour, and (for OpenCode + Pi) the in-agent plugin commands.

• OpenCode + Pi merged into one page per tool — integrations/opencode.mdx and integrations/pi.mdx each combine the FCM launch flow (CLI flag, config, install) with the in-agent plugin (/fcm commands, progress display, architecture). The old pi-extension slug redirects to pi so any external link still resolves.

• 📖 5 video wrappers added across the docs and the landing — <Video name="…" /> placeholders for the 5 planned screen recordings (tui-first-launch, tui-pick-and-launch, tui-speed-test, web-url-deep-linking, router-playground). On the doc pages a <Callout> immediately below each wrapper contains the recording script (shot list, export spec, file location) and a {/* AGENT TODO: … */} comment that tells the next agent exactly which block to delete once the .mp4 is committed. On the landing page the wrappers are bare — no Callout, because the landing is public.

• 🧠 Persistent site component changes — a new <Video /> component (website/src/components/Video.tsx) renders an autoplay / muted / loop / playsinline <video> in a styled figure. The Markdown renderer now wraps every MDX <table> in a .table-scroll container so wide tables scroll inside the page instead of pushing the viewport wider, and the first column gets a min-width: 8rem so label columns (e.g. the "Area" column in the Web Dashboard features table) stay readable. The "On this page" right-side table-of-contents was removed from every docs page; the content was already in flow and the column was redundant.

• Sidebar "View more" toggle on long nav groups — Agent Integrations now lists the 9 most-used tools in the user's preferred order (OpenCode, Pi, Hermes, OpenClaw, Qwen Code, Cline, Goose, Kilo, jcode) and hides the remaining 10 behind a "+ View 10 more…" toggle that expands to "- View less". The active page is always shown even when the group is collapsed, so you never lose your place in the nav.

• Repository docs cleaned up — docs/config.md no longer lists the deprecated providers that were removed from the active catalog (huggingface, replicate, deepinfra, siliconflow, together, perplexity); the env-var table is now aligned with the 20 active providers. docs/development.md is updated from the stale 160 models across 20 providers figure to the real 222 models, and the file-path table is rewritten from the obsolete src/*.js layout to the current src/core/, src/tui/, src/data/ structure. docs/integrations.md now lists 19 tools + the FCM router in the tool → config mapping.

• Marketing site MDX content realigned — the entire website/src/content/docs/ tree was rewritten to match the README. Architectural inaccuracies (e.g. Gemini CLI referenced as a provider, fabricated REST endpoints like /api/best, half-true circuit-breaker states) were corrected against the source code and the README. The cli-tui.mdx keybinding table was rebuilt from the README so it is now 100% accurate (fixing the historical bugs where N was mislabelled as "Sort by Context" and Y was mislabelled as "Sort by Tier"). The docs nav sidebar was reordered so the surfaces (TUI, Web, Docker) come first, the agent integrations follow, and the Smart Router is the last item in "Core concepts & advanced" — matching the README's reading order.

• Landing-page video integration — the static LogoMark + MorphingText content in the Hero card was replaced with the <Video name="tui-first-launch"> wrapper so the first thing a visitor sees becomes a live demo as soon as the recording lands. The router demo is embedded in the FailoverSection, and the remaining three demos live in a new "See it live" grid at the bottom of the SurfacesSection.

Changed

• README "double title" bug — every docs page used to render the title twice (once in the route header, once in the leading # Title of the MDX body). All 18 MDX files had their leading # <Title> line removed; the route header is now the single source of truth for the page title.
• Markdown renderer table overflow — the previous .prose table { white-space: nowrap } rule forced every cell onto a single line, which exploded the page width whenever a cell contained a long description (e.g. the "Highlights" column in the Web Dashboard features table). Tables now wrap their content (overflow-wrap: anywhere) and live inside a horizontal-scroll wrapper as a fallback so even pathological tables scroll inside the page instead of stretching the viewport.
• README.md now contains 5 video references — the same 5 recordings are available on the landing and the docs; all three surfaces reference the same files in website/public/videos/. Mutualised, no duplication.
• Removed pi-extension.mdx — superseded by the merged integrations/pi.mdx. A redirect from the old slug lives in docs/$.tsx so any external link still resolves.

Migration / workaround

No code or behaviour changes. This release is documentation-only. No new flags, no new endpoints, no breaking changes. Upgrade is safe and invisible to runtime users.

The 5 videos are not yet recorded. The wrappers currently render empty <video> frames everywhere. Drop the recorded .mp4 files at website/public/videos/<name>.mp4 and the surrounding <Callout> recording scripts in the docs remove themselves via the {/* AGENT TODO: … */} comment the next time an agent touches them. Public behaviour is unchanged.

Files

• Modified: README.md (full rewrite, ~1,000 lines), docs/config.md, docs/development.md, docs/integrations.md, 16 docs MDX files under website/src/content/docs/, website/src/components/MdxComponents.tsx (registers Video, table), website/src/components/DocsSidebar.tsx (refactored with NavGroup + View more toggle), website/src/routes/index.tsx (landing videos + import cleanup), website/src/routes/docs/$.tsx (TOC removed, pi-extension redirect), website/src/styles.css (table wrapping + scroll wrapper, .table-scroll activated), website/src/content/nav.ts (reordered + primaryCount), package.json (0.5.65 → 0.5.66), this changelog.
• New: website/src/components/Video.tsx (~35 lines).
• New folder: website/public/videos/ (target for the 5 upcoming recordings).
• Deleted: website/src/content/docs/integrations/pi-extension.mdx (replaced by integrations/pi.mdx; redirect handles old links).

Breaking changes

None. This is a documentation-only release. No CLI flags added, no flags removed, no endpoints changed, no behaviour changed.