Skip to main content

Finch Changelog

Every Finch update, documented

Version 1.6.3

Finch 1.6.3

Mini programs gain an appearance API and a remote provider catalog snapshot lands; the model menu groups by source, the sidebar adopts a hamburger icon, and 142 local Twemoji assets are added—along with fixes for session compression, model catalog refresh, concurrent mini program updates, and custom skin color derivation.

1.6.3 Changelog

New

Mini programs & extensions

  • Appearance capability: mini programs gain ctx.appearance, which can set the theme, custom skins, font size, font family, and Home background once permissions.appearance is granted; the permission card and its trilingual copy are rounded out alongside it.

Models & providers

  • Remote provider catalog snapshot: fetching a remote provider catalog snapshot is now supported, making model catalog state more reliable.

Improvements

  • Model menu cleanup: groups models by source, unifies source-card corner radii, pinned-model hints, and empty-state layout, and adds diagnostics for where a model switch originated.
  • Sidebar and theme details: the sidebar menu switches to a hamburger icon, timestamps and captions are tightened, and the light-theme active row and loading animations are refined.
  • Emoji coverage: adds 142 commonly used local Twemoji assets covering animals, food, nature, sporting goods, and more.
  • Log maintenance: expires old logs by date, caps individual file size, and shortens the detailed log retention window to seven days.

Fixes

Sessions & compression

  • Fixes streamed content rolling back, trailing flicker, stale compression boundaries, and lost follow-up suggestions when switching sessions.
  • Fixes compression boundaries disappearing after collapsing a round, stale operations clearing compression state, and queued messages appearing early during a compression rerun.
  • Fixes send-then-navigate timing on Home and a stale open-identity cache when reopening the latest session after creating one in a container.
  • Fixes incorrect attachment restoration on the first image-and-text message, duplicated action suggestions in an error state, and missing retry details in run status.
  • Fixes a theme flash when creating a session and Space session list expansion state not being written to the database.

Models & Finch Plan

  • Fixes Finch Plan model catalog refresh failures, accidental automatic switching during a refresh, delayed subscription status updates, and network fluctuations signing the user out.
  • Fixes new sessions not restoring the last model, defaults not updating after a model switch, broken cross-provider switching when a model becomes unavailable, and invalid drop targets when dragging models.
  • Fixes usage quota ordering, duplicated Finch Plan quota card titles, and log usage not updating continuously.
  • Fixes an incorrect terminal state being overwritten after a cloud model interruption.

Mini programs, rendering & platform

  • Fixes concurrent mini program update states overwriting each other and permission warnings displaying incorrectly.
  • Fixes relative file links being rendered as blocked and local images failing to display on Windows.
  • Fixes text-default emoji such as ✌️ not rendering correctly as Twemoji.

Appearance

  • Corrects the custom skin --text-inverse derivation: instead of inverting RGB directly, it now blends white or black according to the theme base, preventing saturated dark colors from looking washed out or gray on accent backgrounds.

Version 1.6.2

Finch 1.6.2

A full-window session header with breadcrumbs, quick text quoting, and built-in Mermaid rendering; parallel mini program activation and MCP Resources/Prompts support, Linux desktop integration with GPT-6 Astra, plus more stable usage persistence and SQLite-backed storage.

1.6.2 Changelog

New

Sessions & interaction

  • Full-window session header: overview, mini program panel, and session menu move into the title bar.
  • Session breadcrumbs: the top level is a scope dropdown that jumps straight to a new conversation or recent sessions.
  • Quick text quoting: select text inside a timeline reply to create a quote snippet, with hover preview and more accurate scroll positioning.
  • Built-in Mermaid rendering: diagrams support fullscreen zoom and panning, with an on-demand engine that cuts the main bundle from 1199 kB to 572 kB.
  • Fullscreen table view: dialogs keep uniform safe margins on all four sides instead of overlapping system buttons.
  • Panel-tab context menu: supports Close, Close Others, and Close to the Right.

Mini programs & extensions

  • Parallel capability activation: mini programs start in parallel according to manifest capability dependencies for faster launches.
  • Session Turn cancellation: mini programs gain a Session Turn cancellation API.
  • Per-item AgentEvent authorization: full event permissions are double-checked against both manifest and persisted grants; newly added permissions are highlighted on update.
  • MCP Resources & Prompts: the MCP client adds resource and prompt capability integration.
  • Stable MCP configuration: config and business secrets move to a stable data directory and survive install-source switching.
  • Canvas capability: adds a display-change event API and rounds out the game Canvas runtime.
  • AppView breadcrumbs: preview/Diff return to the navigation stack, with page-owned breadcrumbs capped at depth 5.
  • File picker: the Space switcher joins the search/sort row for smoother operation.

Platform & models

  • Linux desktop integration: windows use a Finch-logo title bar, support Wayland, fall back automatically without a compositor, and gain an rpm packaging target.
  • New model: GPT-6 Astra is available.
  • Settings entry: Settings becomes its own sidebar button; the About page links straight to Settings and adds a "Learn more" link.

Under the hood & stability

  • Persistent usage stats: model usage is written to a local cache and stays compatible across version rollbacks.
  • SQLite migration: Space and session state move into SQLite storage for more stable history restoration.

Improvements

  • Faster startup: workspace and model startup states are fetched in parallel with module loading.
  • Renderer architecture refactor: reworks Renderer layering and long-session runtime resource ownership.
  • Structured logging: fills in main-process log coverage for easier diagnosis.

Fixes

Follow-ups & compression

  • Fixes interrupted follow-ups leaving old tasks running and stale round content behind.
  • Fixes summary loss during repeated compression of very large contexts and duplicate reruns of manual and automatic compression.
  • Fixes missing auto-compression when the context exceeds the limit and leftover state after compression failures.
  • Fixes compression reruns mistaking cross-session reference material for a task to execute.

Background tasks & notifications

  • Fixes background task results appearing after the wrong message.
  • Fixes background notifications delivered across the wrong workspace, lost on reconnect, and per-message reply triggers.

Sessions & messages

  • Fixes the UI not updating dynamically after switching the session language.
  • Fixes new sessions stuck on skeleton loading and scrambled history-edit positioning and appends.
  • Fixes blank Timeline restoration, lost progressive rendering, and trailing blank space after images load.
  • Fixes anomalous LaTeX formula delimiter rendering.
  • Fixes uncleared input after skipping an interaction and leftover answers after switching sessions.

UI & platforms

  • Fixes stacked dialogs where Escape closed the wrong underlying dialog and inner dialogs were obscured; text areas now fill their container by default.
  • Fixes Windows/Linux session layout and title-bar drag regions covering control buttons.
  • Fixes sub-pixel gaps between diff lines and missing timeline dialog animations.

Models & accounts

  • Corrects oversized GPT context-window configuration and misleading Kimi quota-exhaustion messaging.
  • Fixes Finch Plan usage grouping, vision capability, and address concatenation.

Mini programs & MCP

  • Fixes mini program pages missing a cwd fallback and being unrecoverable when the directory name and identifier mismatch.
  • Fixes MCP tool-list truncation, state cross-contamination with the mini program list, and missing reactivation after recovery.
  • Fixes today's usage not refreshing after reopening and reconnect/overload copy covering run status.

Version 1.6.1

Finch 1.6.1

Professional thinking mode and the GLM 5.3 lineup arrive alongside a richer mini program file picker, HTML preview, and broad refinements across sessions, models, and desktop interaction.

1.6.1 Changelog

New

Thinking & models

  • Professional thinking mode: adds a professional mode with deeper reasoning for complex tasks.
  • GLM 5.3 lineup: enables GLM 5.3 and adds a GLM 5.3 Flash model entry.
  • Subscription-model visibility: the model menu now shows subscription models and refreshes access; free users can see locked Finch models with clearer status.
  • Model selection: models without credentials are no longer selected automatically; login and API-key status are shown separately.

Mini programs & extensions

  • File picker: mini programs gain ctx.ui.pickFile, with Finder-style drill-down browsing, directory item counts, distinct empty states, selected-item highlighting, and a current-path footer.
  • HTML preview: mini programs can choose an HTML preview mode.
  • Toolbar states: AppPanel toolbar buttons support checked states and disabled-state coordination.
  • Mini program theme tokens: mini programs can receive theme tokens such as font size, removing the initial light-theme flash.
  • Single-instance Webview panels: already-open single-instance Webview panels are reused instead of recreated.

Sessions & interaction

  • Session.suggest: adds suggest to the Session tool for next-turn conversation suggestions.
  • Dynamic permission switching: Session permission modes can now change at runtime.
  • Agent error recovery: improves recovery and retry interaction; follow-up suggested actions remain reusable after retries are exhausted.
  • Usage dashboard: redesigns the usage dashboard for clearer dates and presentation.

Home & appearance

  • Home section customization: reorder and show or hide Home sections.
  • Help & feedback menu: adds Help and Feedback submenu entries to the sidebar main menu.
  • Code font-size sync: code font size follows the selected display scale.
  • Tray-menu quota: restores quota display in the tray menu.
  • Home background skins: adds background-skin support for Home.

Other

  • Shared skill source: adds a switch for the shared ~/.agents/skills skill source.
  • Shiki syntax highlighting: adds Shiki highlighting to DiffView and file previews.

Improvements

  • Code-highlight performance: rewrites highlight scheduling; pre-scanning large files and HTML is about 10× faster.
  • Model-menu detail: unifies persistent model-menu layout, improves provider-name and star alignment, and fine-tunes minimum width.
  • Extension builds: installs dependencies only when missing and uses npm ci for more reliable submodule synchronization.
  • Home layout saving: relies on the backend result after saving; controls stay disabled during the save to prevent misclicks.
  • Skill rescanning: connects skill rescans to the serialized workspace refresh chain, preventing stale snapshots from overwriting UI state.
  • Build & dependencies: upgrades Bun to 1.4.0, pins the CI version, and synchronizes build numbers.

Fixes

Input & shortcuts

  • Fixes an invisible cursor while entering long text.
  • Fixes cross-platform shortcut modifier detection.
  • Fixes themed backgrounds for shortcut keys.

Sessions & messages

  • Fixes AskUserQuestion cards being removed by hidden-tool cleanup.
  • Makes session titles turn Composer files and annotation tokens into readable copy.
  • Fixes the queued follow-up send state.
  • Fixes leftover background processes after interruption.
  • Fixes context overflow from batched tool results.
  • Fixes delayed final-session-result rendering.
  • Fixes older sessions not receiving visual capabilities.
  • Fixes clipped sidebar-tab close buttons.

Files & paths

  • Fixes the chat file picker inheriting an old Space directory.
  • Fixes copied file paths gaining line breaks.
  • Fixes path continuations being mistaken for skills.
  • Fixes Chinese-boundary URL rendering and path-related display issues.

Panels & previews

  • Fixes duplicate single-instance panel creation and finch:env races after migration.
  • Fixes app-state restoration across sessions.
  • Fixes hidden tool calls between two replies being merged into the render, removing extra blank lines.
  • Removes hidden final tool calls that follow visible tool calls from rendering as well.
  • Lets image-preview overlays close on click.

Models & accounts

  • Fixes GLM text-model image-request logic.
  • Fixes subscription-fetch failures showing only free models.
  • Fixes the welcome message using the custom assistant name.
  • Prevents transient refresh failures from deleting login credentials.
  • Distinguishes relay-budget exhaustion from request rate limits.
  • Corrects English and Chinese reasoning-level labels (xhigh / max).

System & stability

  • Fixes mini program windows causing all Settings saves to fail silently on Windows.
  • Fixes Home-tab sorting drag cursor, keyboard order, and rebound behavior.
  • Fixes persisted Session unread state.
  • Fixes cross-platform Bash task notifications leaking between sessions.
  • Removes English-month dependence on ICU data in favor of fixed abbreviations.
  • Fixes IME Enter in the Composer accidentally submitting messages.
  • Fixes floating sidebar menus closing unexpectedly.