---
title: "Changelog · Finch Agent"
description: "Official releases and update history for the Finch desktop app."
source: https://finchwork.app/en/changelog
---

# Finch Changelog

Every Finch update, documented

Version 1.6.0

## Finch 1.6.0

Global right panel and mini program navigation stack, host-rendered Diff with a revamped changes panel, unified Twemoji rendering, and a broader model ecosystem with xAI, DeepSeek vision models, and GLM 5.3.

August 24, 2026

# 1.6.0 Changelog

> Span: v1.5.4 → v1.6.0 (552 commits)

## New

### Right panel & mini program system

-   **Global right Panel:** a new global right-side panel workspace with responsive width strategies; panels survive across sessions, limited to 20 instances across browser/Webview.
-   **Session-level Webview Panel Host:** panels can attach to a specific session and restore with it; supports file preview and a built-in browser.
-   **Mini program navigation stack:** mini programs can open child mini programs, built-in file previews, and browsers (AppView three-level navigation stack) with multi-level breadcrumb back; parent mini program pages stay alive during child navigation instead of refreshing on every return.
-   **New mini program APIs:** `ctx.ui.openDiff` (host-rendered diff), `ctx.ui.delivery` (deliverables), `ctx.spaces` (space list), dynamic toolbar updates (`setToolbar`/`updateToolbarItem`), `window.finch.ui.toast/confirm`, and the `finch-file` local file protocol exposed to Webviews.
-   **Terminology unification:** "mini tools" are now consistently called "mini programs" across the app UI and copy.
-   **Webview experience:** eliminated the light-mode flash on first render — the first frame stays hidden until theme injection completes; AppView child levels now hook into window forward/back history.

### Diff / changes panel

-   **Host-rendered Diff service:** supports comparing two file paths or multi-file Git refs, with patience anchors + an LCS fallback algorithm for better large-file diff performance and precision.
-   **Changes panel:** the diff panel is renamed "Changes", integrates write files, optimizes the line-number gutter with modification counts; deleted files are marked with strikethrough + a tertiary color; large-file diff performance is improved.
-   **Annotation integration:** the changes panel and file preview support quick selection-based annotations that auto-generate annotation tokens with paths and line numbers.

### Messaging & interaction

-   **Twemoji rendering everywhere:** 473 common emoji SVGs are bundled locally (no CDN, works offline) and rendered consistently across AI replies, user messages, sidebar titles, and ask cards, with a system-font fallback outside the subset.
-   **Quote replies:** every AI reply gets a quote button — lightweight quotes no longer inline the full text; hover cards show "Replying to: xxx" with a jump to the original reply.
-   **Annotation enhancements:** annotations support a `reminder` field (model prompt only, not displayed), hover cards truncate overly long content, and previews no longer leak internal tokens.
-   **New conversation capabilities:** the `Session.read` tool reads LLM reply turns from a session in a structured way; a "Open in new window" option joins the session menu; child-session cards stay visible with running-state indicators.
-   **Pending message drawer:** shows parsed human-readable text without leaking annotation payloads.

### Model ecosystem

-   **xAI:** native device-code login (OAuth) for xAI with curated Grok models built in.
-   **DeepSeek:** new vision model (deepseek-v4-flash-vision-exp, 1M context); vision-capable models get a vision badge in the model list.
-   **GLM 5.3:** new model entry; restricted models (GLM/Kimi/DeepSeek) only show low/high/max thinking levels.
-   **Custom models:** filter and batch-select by ID; configure vision capability; one-click add via the `finch://models/add` deep link.
-   **Model probing:** models.dev local cache corrects auto-detected model names and context lengths; models flagged as non-text output are filtered out; a new 372K context-length preset.
-   **OpenCode Zen Go:** built-in OpenAI-compatible provider with 12 models.
-   **Model picker UX:** without an explicit model, the last model used in a real conversation is preferred; hovering a usage chart legend highlights the matching bar.

### Other

-   **Traditional Chinese:** new zh-HK language support with proofread main UI copy.
-   **SQLite app storage:** new SQLite application storage infrastructure (app.db), powering usage caching and more.
-   **MCP 2.0:** client upgraded to the official `@modelcontextprotocol/client` 2.0 with protocol-version negotiation fallback.

## Improvements

-   **Performance:** throttled agentStore/panelStore persistence writes (main-thread load down ~40% during streaming); throttled usage snapshots while running; async chunked quicksearch no longer stutters; progressive rendering and first-frame cost optimizations for long sessions; low-frequency state animations now render as discrete jumps.
-   **Stability:** in-place rendering of resumed running turns eliminates Timeline tearing; streaming output freezes when reading above the bottom to avoid jitter; refined running states (empty stop treated as network error, reconnect/overload shown directly, interrupted turns marked incomplete).
-   **Experience:** right-panel buttons show shortcuts in tooltips; browser default empty-state guidance; max panel width raised to 2560; faster settings-window load.

## Fixes

-   **Multi-window:** fixed user-message sync across windows, unread-state races, follow-up messages not rendering in sync, and Dock badge unread sync.
-   **Permissions/Interaction:** fixed historical permission cards flashing when switching sessions; pending backend permission requests are now cleared when toggling acceptCalls; interaction card response and recovery.
-   **Rendering:** fixed blank history after session restore, abnormal timeline dates, image attachments/base64 failing to render, Chinese-boundary URL rendering issues, and Windows paths rendered as blocked.
-   **Input:** fixed IME Enter accidentally submitting in the rename input; drag-and-drop of directories now inserts @ mentions.
-   **Stability:** fixed message-queue races during auto-compaction, repeated compaction prompts, 524 long backoff not auto-reconnecting, and empty timelines when restoring window sessions.
-   **Grep:** fixed content-mode context line read failures (relative paths resolved against the wrong cwd).
-   **Models:** fixed GLM text-model image requests, OAuth model connection tests, temporary refresh failures deleting saved credentials, and Provider-enable races after login.
-   **OAuth:** fixed callback-page localization, popup window ownership, cancelled authorization keeping the termination page, and icon version-parameter mismatches being rejected.
-   **Other:** fixed rename IME misfires, hover sidebar menus closing accidentally, settings sub-page jumps, MCP client 1.3.x extraction failures, mini program prerelease-version compatibility checks, and directory left-ellipsis segment ordering.

Version 1.5.4

## Finch 1.5.4

Community mini tool search and custom interface fonts, plus smoother long-conversation recovery, stronger startup stability, and a range of interaction and display fixes.

August 12, 2026

# 1.5.4 Changelog

## New

-   **Community mini tool search:** the toolbox now supports searching community mini tools directly, with improved keyword matching and presentation so tools are easier to find.
-   **Custom interface fonts:** Appearance settings now let you customize the interface font and code font, so the UI can better match your preferences.
-   **Improved model menu:** selecting a model with the keyboard now shows the usage card at the same time, making the model menu smoother to use.
-   **Better onboarding:** the HATCH ritual now automatically recommends and installs mini tools after naming, so getting started feels more natural.

## Improvements

-   **Long-conversation recovery:** pagination improves recovery of long conversation history, making startup and switching between long chats smoother.
-   **Startup stability:** improved diagnostic recovery for long conversations, and added a hang watchdog while auto-compaction is running.
-   **IPC architecture consolidation:** the main process IPC has fully migrated to a single typed registration, laying the foundation for future stability and extensibility.
-   **Improved cache hit rate:** adjusted prompt priority, improving the cache hit rate to 99.9% from 0.4% (DeepSeek models).

## Fixes

-   **Interrupted interactions:** long-running Bash commands now provide a force-quit exit when pressing ESC cannot stop them.
-   **Misplaced messages:** fixed an issue where messages appended mid-run caused the previous reply to be displaced after the new question.
-   **Chinese paths:** local path links now decode percent-encoded characters, fixing errors when opening files with Chinese names.
-   **Deep link display:** fixed finch:// deep links being rendered as \[blocked\] in Markdown.
-   **Timeline:** fixed broken images in the timeline; Write/Edit tool cards no longer expand inline, keeping only the file link dialog.
-   **Conversation titles:** manually renamed conversations now take priority over AI auto-renames and are no longer overwritten.
-   **Multi-window sync:** fixed real-time reply sync and lost unread states across windows.
-   **Conversation view:** fixed conversations leaking across Spaces in the conversation view; renaming a conversation no longer steals the window's currently viewed conversation.
-   **System notifications:** conversations that finish while the window is in the foreground now also show a system notification.
-   **Default fonts:** the interface font and code font now default back to Outfit / JetBrains Mono on first launch.

Version 1.5.3

## Finch 1.5.3

Guides and Space rules now live in the context panel, with smoother mini tool settings and shortcuts plus fixes across mini tools, MCP credentials, and the interface.

August 9, 2026

# 1.5.3 Changelog

## New

-   **Context panel guides:** the context panel now shows Skill guides and Space rules, so you can see available capabilities and collaboration conventions as soon as you open a Space.
-   **Built-in mini tool guide sync:** guides for built-in mini tools now sync automatically to stay current.
-   **Improved mini tool settings:** a unified settings entry point now supports multi-select fields, automatic focus, and Enter to save for a smoother setup flow.
-   **Remembered reading position:** each conversation keeps its own scroll position, so you can pick up where you left off after switching chats.
-   **Enhanced shortcuts:** the model menu now shows shortcut hints and supports direct follow-up prompts; shortcuts for sidebar switching and pinned models are now complete too.
-   **Answer waiting sessions on behalf of someone:** waiting sessions started by mini tools now support proxy answers, making cross-device collaboration more seamless.

## Improvements

-   **Unified hint interactions:** the sidebar and Composer now use Tooltip consistently for more coherent placement and interaction.
-   **Sidebar performance:** improved hover performance in large lists, reducing lag when working through long conversation lists.
-   **Background task status:** background task status now appears in a HoverCard for a cleaner interface.
-   **Preserved conversation activity:** manually stopping a conversation no longer automatically collapses its activity record, making it easier to review what happened.

## Fixes

-   **Mini tool compatibility:** added support for legacy tool image data and both old and new icon paths, making mini tool display more reliable after updating.
-   **Mini tool settings security:** fixed plaintext storage of extension keys and unsaved edits lingering in the settings dialog.
-   **Extension icon display:** fixed extension icons missing on first launch.
-   **MCP credential references:** existing credential references are now retained after renaming an MCP service.
-   **Auto-compaction notice:** context-overflow notices no longer appear incorrectly while auto-compaction is in progress.
-   **Interface details:** fixed the code-copy button in dialogs, dropdown trigger height, question-card width, and missing shortcut dialogs.

## Archive

1.  [1.5.22026-08-08](/en/changelog/1.5.2)
2.  [1.5.12026-08-02](/en/changelog/1.5.1)
3.  [1.5.02026-07-13](/en/changelog/1.5.0)
4.  [1.4.42026-06-22](/en/changelog/1.4.4)
5.  [1.4.32026-06-13](/en/changelog/1.4.3)
6.  [1.4.22026-06-04](/en/changelog/1.4.2)
7.  [1.4.12026-06-01](/en/changelog/1.4.1)
8.  [1.3.02026-05-21](/en/changelog/1.3.0)
9.  [1.2.12026-05-18](/en/changelog/1.2.1)
10.  [1.2.02026-05-16](/en/changelog/1.2.0)
11.  [1.1.02026-05-15](/en/changelog/1.1.0)
12.  [1.0.02026-05-14](/en/changelog/1.0.0)