CherryHQ/cherry-studio v2.2.0 on GitHub

Downloads (v2.2.0)

Platform	Architecture	Download
Windows	x64	Installer · Portable
Windows	arm64	Installer · Portable
macOS	Apple silicon (arm64)	DMG · ZIP
macOS	Intel (x64)	DMG · ZIP
Linux	x64	AppImage · DEB · RPM
Linux	arm64	AppImage · DEB · RPM

Release Notes

Cherry Studio 2.2.0 - Skill Marketplace, Notifications, and Agent Runtime

✨ New Features

[Marketplace] Browse skill catalogs, external skill sources, Agent templates, and MCP resources in one Marketplace, with guided installation and focused MCP and skill management.
[Notifications] A new notification drawer beside the sidebar gathers task results and official announcements, with unread indicators, reply previews, and announcements shown in your language.
[Scheduled Tasks] Scheduled tasks now have a dedicated sidebar page with task conversations, paginated run history, and management for completed or missed tasks. The duplicate Settings page was removed.
[Cherry Cloud] Subscription usage and monthly quotas appear in Settings and the account panel, with plan badges, subscribe entry points, a quota notice above the input, and a notice when a subscription becomes active.
[Selection Assistant] Ask Agent and agent-bound actions open a dedicated agent window for the selected text. Windows can collapse into capsules, follow auto-close rules, and continue the session in the main window.
[Agent] New agents default to the Pi Durable runtime, which persists sessions natively and streams background subagents independently. Sessions can fork at completed checkpoints while keeping independent state.
[Agent] View and edit agent memory from Agent configuration.
[Agent] Session details show grouped subagents, task progress, and context usage in a compact card.
[Agent] Edit and resend now replaces the message and removes everything after it without creating another history version. Files are not restored; fork first to keep the original conversation.
[Chat] Click the branch counter on a message to jump between alternate replies, with previews in the switcher.
[Chat] Generated images offer Use as Reference for models that accept image input.
[Paintings] GPT Image 2.6 Flare and Sunburst support scene complexity and animated GIF output, and ComfyUI workflows can use attached input images.
[Models] Added LongCat 2.5 and Hunyuan 4 with image input, plus reasoning-effort controls for Qwen 3.8 Flash Next.
[Files] Copy a file or folder itself to the system clipboard from the Agent file pane.
[Notes] Save selected conversation text to Notes, and reference Notes from the chat input with @.
[Translate] Copy a completed translation as a full-length PNG image.
[Export] Export MCP server configurations as JSON and export multiple assistants as one file.
[Skills] Choose which managed skills are exported to ~/.agents/skills for external agents.
[Shortcuts] Number shortcuts switch conversations and tabs, and new shortcuts switch assistants and topics; all can be customized in Settings.
[Conversations] Permanently delete conversations from list, More, and History menus, and delete owners from list and group menus, after a confirmation that names the item.
[Markdown] Bare image URLs in responses now render as inline images.
[Mini Apps] The catalog has new creative and productivity sites, and the More menu can restart a MiniApp.
[HTML Artifact] Copy an HTML artifact's source from its inline source toolbar.

💄 Improvements

[Chat] Regenerate is available below user messages and uses the currently selected model.
[Chat] Conversation anchors appear from the first turn; the separate side navigation toolbar was retired in favor of the bottom arrow.
[Agent] Context usage reports runtime capacity, estimated categories, and resources consistently across runtimes, including subagents.
[Agent] Switching permission mode while a task runs applies to its next tool call instead of waiting for the next message.
[Agent] Plan and Goal modes are available as explicit Quick Panel actions, and unsupported history actions are disabled.
[UI] Context-menu shortcuts render as compact keycaps, resize handles use neutral colors, and clipped letter descenders are fixed.
[File Preview] Word previews fit the pane, and more file types show proper icons and labels.
[Models] Qwen AI Platform and Qwen Cloud branding, links, and default API endpoints are updated. Qwen Token Plan keys now work with image generation.
[Claude] The runtime download banner displays correctly and the runtime is named Claude.
[Settings] Resetting a customized provider API host asks for confirmation.
[About] Simplified product information with a Star button, email contact, and bottom-docked DevTools.
[Web Search] A warning now names the provider that actually ran a search when it falls back.

🐛 Bug Fixes

[Chat] Edited messages update immediately in the open conversation.
[Chat] Sending a message no longer recreates existing history, and code blocks show readable source before highlighting.
[Chat] Images below a provider's minimum edge are padded instead of aborting the request.
[Chat] Returning to the bottom animates smoothly, and bottom-follow resumes after resend.
[Chat] The manual composer height survives typing and pasting.
[Chat] A knowledge-base instruction prompt no longer leaks into the input after returning from Settings.
[Agent] Sessions no longer stay busy after a pending connection fails during close, and interrupted subagents show as stopped.
[Agent] Background continuations stay in the existing reply, and reasoning tokens are reported correctly in usage.
[Agent] Stopping a task on Windows now ends its child processes.
[Agent] move_to_trash and save_attachment work inside managed workspaces and report the real failure reason.
[Agent] The built-in delete guard no longer blocks harmless text that mentions deletion.
[Agent] Tool approval cards are retired when their runtime disappears instead of leaving the conversation stuck.
[Models] Prompt caching works for Claude models on AWS Bedrock.
[Models] OpenAI and Azure OpenAI Responses tools no longer treat optional arguments as required.
[Models] Ollama Agent requests work again after tool calls.
[MCP] Parameterless MCP tools work with strict providers, and installing an existing MCP server reuses its definition.
[Providers] Errors caused by unsupported parameters no longer claim the model was retired; invalid inline images are reported as rejected requests.
[Providers] OpenRouter reranking models are discovered correctly, and Mistral tool-call streams no longer fail when an ID is missing.
[Notes] Full-text search lists matching lines and jumps to them again, and toolbar formatting applies before the editor takes focus.
[Editor] Inline math no longer replaces adjacent text, and multi-line LaTeX environments stay intact.
[Settings] Fallback model pickers warn when configured models are unavailable.
[Knowledge] Invalid knowledge-base URLs are rejected before saving.
[Local Models] Model cards explain when the shared runtime is missing, and the FunASR INT8 decoder was replaced.
[Dictation] The speech-recognition model requirement is now surfaced.
[Tabs] Pinned-tab state persists, and archived items no longer stay disabled after a tab switch.
[Right Panel] Topic drag-and-drop sorting works again.
[Browser] Bare IPv6 loopback addresses are accepted.
[File Editor] A UTF-8 BOM no longer drops following content.
[Security] Provider API keys are no longer written to logs or diagnostic bundles.
[Windows] Close-to-tray now actually hides the main window.
[Selection Assistant] The Windows Snipping Tool is excluded from selection retrieval.
[Computer Use] Unconfirmed runtime cleanup can be recovered without restarting Cherry Studio.
[Claude] Claude Code installs on Windows ARM64, and Linux shows guidance instead of launching without a session bus.
[Tesseract] OCR loads its engine in packaged builds.
[Agent] Remember the session details card's last open or closed state across all sessions and app restarts.
[Agent] Fixed Claude Code (login) agents on macOS failing with "Not logged in · Please run /login" even after logging in with claude /login.
[Subscription] The China edition now picks up subscription changes once the server's notification service comes online, without restarting the app.
[Subscription] The China edition shows subscription changes (activation, renewal, expiry and more) in the notification center.
[Workspace] Consistent icon colors and sizing, clearer Chinese agent labels and settings, restored tooltip contrast, and smoother tabs, pane resizing, conversation shortcuts, and notifications
[API Gateway] Preserve agent instructions, tool schemas, and cache hints when forwarding requests, and prevent unintended tool execution or retries inside the gateway.
[UI] Restore popup close animations, correct prompt and memory editor sizing and styling, and prevent stale actions or drafts when reopening dialogs.
[Agents] Enable PowerShell commands for Pi and Pi Durable on Windows without requiring Git Bash.
[Settings] Group built-in tools in a secondary settings menu and move interface language selection to a dedicated Language section in General.
[Agents] Pi and Pi Durable subagents now default to bypass permissions, avoiding ordinary tool approval prompts. No action required.
[Navigation] Restore sidebar settings on Windows and other non-macOS platforms, and in macOS fullscreen; show the session-details tooltip below its button after a hover delay.

⚡ Performance

[Chat] Preparing large text attachments no longer blocks the interface.
[Agent] Large session lists update more smoothly.

What's Changed

docs(resource-list): propose event-time reads for conversation lists by @kovsu in #23206
refactor(pi-runtime): bind native Pi providers to the internal gateway by @MyPrototypeWhat in #21436
chore(release): sync v2.1.10 metadata by @kangfenmao in #23252
fix(local-model): use compatible FunASR INT8 decoder by @DeJeune in #23243
feat(analytics): report desktop package edition by @kangfenmao in #23234
fix(chat-message-outline): keep the outline rail above the composer band by @cherry-coding[bot] in #23195
Drop empty-name dynamic tools from message replay by @404-Page-Found with @Copilot in #23233
feat(about-settings): streamline About, feedback and DevTools by @kangfenmao in #23208
fix(pi-runtime): omit store for Google OpenAI-compatible endpoints by @cherry-coding[bot] in #23274
ci(deps): bump actions/setup-node from 6 to 7 by @dependabot[bot] in #23285
ci(deps): bump actions/checkout from 6 to 7 by @dependabot[bot] in #23286
ci(deps): bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #23287
fix(provider): accept Bedrock tool-use starts without input (patch 4.0.96) by @cherry-coding[bot] in #23350
refactor(resource-list): keep list helpers in one module by @kovsu in #23357
refactor(renderer-helpers): remove duplicated notes and health-check helpers by @kovsu in #23356
refactor(assistant-mutations): keep one mutation hook for assistants by @kovsu in #23355
refactor(renderer): remove residual v1 types chain by @kovsu in #23353
perf(resource-list): keep list actions stable across host handlers by @kovsu in #23352
docs(artifact-pane): propose removing the test-only wrapper by @kovsu in #23358
fix(web-search): tell the user when a search falls back to another provider by @cherry-coding[bot] in #23342
feat(agent-runtime): add native session observation and context extensions by @MyPrototypeWhat in #21437
feat(agent-runtime): add todo and user-question extensions on native sessions by @MyPrototypeWhat in #21438
docs(website-docs): propose bidirectional content synchronization by @kangfenmao in #23201
feat(website-docs): add bidirectional synchronization and local preview by @kangfenmao in #23204
feat(agent-runtime): run foreground subagents with native session forks by @MyPrototypeWhat in #21578
feat(agent-runtime): persist goals and verify native session context by @MyPrototypeWhat in #21607
fix(api-gateway): omit the strict tool field for non-Responses targets by @cherry-coding[bot] in #23382
chore: version packages by @github-actions[bot] in #23388
fix(provider): derive the DashScope image host from the configured chat base URL by @cherry-coding[bot] in #23381
fix(rich-editor): keep inline math input from replacing adjacent text by @cherry-coding[bot] in #23372
feat(agent-runtime): continue background subagents from native storage by @MyPrototypeWhat in #21693
fix(pi-runtime): omit store for custom chat-completions routes by @cherry-coding[bot] in #23337
docs(agent-behavior): propose the harness-neutral agent behavior package by @MyPrototypeWhat in #21995
feat(agent-behavior): add the harness-neutral agent behavior package (rule core, ports, orchestration, fake harness) by @MyPrototypeWhat in #21996
feat(agent-runtime-pi): implement the agent-behavior harness ports on coding-agent by @MyPrototypeWhat in #22014
fix(file-editor): keep the caret inside the active line highlight by @kovsu in #23391
feat(composer): reference Notes from @ mentions by @louisfy in #20196
refactor(artifact-pane): remove the test-only wrapper by @kovsu in #23390
perf(agent-sessions): re-render only the changed session row by @kovsu in #23389
feat(agent-runtime): correlate owned child inputs and terminal responses by @DeJeune in #22010
fix(windows-tests): make the full test suite portable by @DeJeune in #20309
fix(e2e-regression): isolate the launched app's HOME so CLI tests stop rewriting real credentials by @cherry-qa[bot] in #23118
Restore automatic retries for failed channel startups by @404-Page-Found with @Copilot in #23385
docs(resource-list): drop owned group menus from the conversation list Spec by @kovsu in #23404
fix(virtual-list): keep group headers pinned during scrolling by @ousugo in #23327
fix(anthropic-cache): keep cache_control breakpoints within Anthropic's limit by @cherry-coding[bot] in #23407
feat(models): support LongCat 2.5 by @ousugo in #23425
fix(anthropic-cache): count only serialized breakpoints and keep TTL order by @cherry-coding[bot] in #23418
fix(tool-schema): opt Responses tools out of default strict mode by @pczhao1210 in #23415
feat(skills): allow per-skill exports to ~/.agents/skills by @radianceded in #20356
Fix Ollama Agent tool-call history serialization by @404-Page-Found with @Copilot in #23394
Expose Qwen 3.8 Flash Next effort controls for compatible providers by @404-Page-Found with @Copilot in #23393
chore: version packages by @github-actions[bot] in #23437
fix(browser): enable CDP Runtime on demand so pages cannot detect the console by @cherry-coding[bot] in #23436
chore(patches): remove orphaned yarn-era patch files by @kovsu in #23433
test(rich-editor): avoid background highlighting in line lookup fixture by @DeJeune in #23445
fix(binary-manager): keep uv's build cache off spaced macOS paths by @cherry-coding[bot] in #23448
feat(agent-runtime): persist native contexts and submission facts by @DeJeune in #22071
test(e2e): regression harness with the 56 cases passing on macOS and Windows by @cherry-qa[bot] in #23427
feat(agent-session): retain edited message branches by @DeJeune in #22077
fix(chat): return the viewport to bottom-follow after an accepted resend by @cherry-coding[bot] in #23456
perf(channel-stream): coalesce live channel updates before sanitizing by @kovsu in #23460
feat(export): restore MCP JSON export and add batch assistant export by @cherry-coding[bot] in #23465
docs(main-dependencies): propose bundling main-process JavaScript dependencies Spec by @kovsu in #23464
feat(file-pane): copy the file itself to the OS clipboard by @cherry-coding[bot] in #23477
fix(messages): drop router dependencies from message navigation by @EurFelux in #22981
feat(selection-assistant): add agent bindings and explicit runners to selection actions by @EurFelux in #22990
feat(selection-assistant): open agent actions in a selection agent window by @EurFelux in #23065
feat(selection-assistant): apply state rules and draft hand-off to the selection agent window by @EurFelux in #23089
feat(selection-assistant): collapse started agent windows into capsules by @EurFelux in #23097
feat(selection-assistant): collapse agent windows from the macOS yellow light by @EurFelux in #23158
feat(pi-runtime): integrate shared behavior with desktop sessions by @DeJeune in #22107
fix(move-to-trash): let managed agent workspaces reach the trash by @cherry-coding[bot] in #23492
fix(tab-bar): keep title descenders visible by @DeJeune in #23526
perf(main-dependencies): bundle document-parsing packages into the main build by @kovsu in #23527
fix(data-api): redact credentials in request-logger debug output by @404-Page-Found with @Copilot in #23512
feat(agent): add an in-app memory viewer and editor by @linktao159357 in #23008
feat(mini-app): add restart action to More menu by @HappyAny in #19649
feat(agent-session): persist and stream independent Pi child conversations by @DeJeune in #22689
fix(openrouter): discover reranking models and rerank through its provider by @cherry-coding[bot] in #23471
fix(i18n): say unlink instead of delete in the Russian prompt-binding tooltip by @cherry-coding[bot] in #23296
feat(reasoning): replay edited signed thinking as text by @JuLuogo in #23472
fix(error-category): stop reading deprecated parameters as retired models by @cherry-coding[bot] in #23314
fix(api-gateway): continue internal Agent requests after settled tool tails by @cherry-coding[bot] in #23470
fix(rich-editor): deliver user format commands before focus arrives by @cherry-coding[bot] in #23462
feat(composer): localize builtin slash command descriptions by @cherry-coding[bot] in #23410
fix(openclaw): treat schema stderr warnings as diagnostics, not incompatibility by @cherry-coding[bot] in #23489
fix(chat): keep conversation anchors visible in narrow message columns by @cherry-coding[bot] in #23412
refactor(agent-sessions): move Sessions into a feature folder by @kovsu in #23413
fix(selection-assistant): exclude Windows system screenshot hosts by @cherry-coding[bot] in #23335
refactor(ai-stream): share desktop message projections by @DeJeune in #22698
fix(code-cli): keep provider row actions usable without hover input by @cherry-coding[bot] in #23511
refactor(native-integrations): relocate selection panel and system speech by @DeJeune in #23537
docs(website-docs): align content before enabling synchronization by @cherry-docs-sync[bot] in #23544
fix(scroll-area): unify application scrolling and stabilize sidebar spacing by @DeJeune in #23515
chore: version packages by @github-actions[bot] in #23546
feat(pi-durable): integrate shared behavior with desktop sessions by @DeJeune in #22755
perf(main-dependencies): bundle channel and remote-access packages into the main build by @kovsu in #23530
perf(main-dependencies): bundle media and system packages into the main build by @kovsu in #23533
feat(mini-apps): refresh catalog entries using shared SVG icons by @WhiteZeek in #21553
perf(main-dependencies): bundle the agent SDKs, drop stale packaging rules, fix the Tesseract core by @kovsu in #23536
fix(main-window): hide the window on Windows close-to-tray (#23487) by @cherry-coding[bot] in #23539
chore(claude-code): upgrade SDK to 0.3.311 and define runtime migration by @DeJeune in #22766
fix(ai-params): strip top-k from fixed-sampling Claude requests by @MasterZRC in #23547
feat(agent-runtime-claude-code): add native thread access and observation by @DeJeune in #22809
fix(agent-edit-dialog): hide Skills tab for sealed built-in agents by @404-Page-Found with @Copilot in #23542
chore(electron): upgrade to 45.2.2 and better-sqlite3 13.0.3 by @DeJeune in #23548
test(e2e-regression): expand desktop coverage and harden cross-platform runs by @cherry-qa[bot] in #22618
fix(voice): surface the speech-recognition model requirement for dictation by @cherry-coding[bot] in #23567
fix(right-panel): open shortcut tooltips below the top toolbar by @cherry-coding[bot] in #23573
fix(page-header): keep title descenders visible by @DeJeune in #23607
fix(general-settings): surface unavailable fallback models in settings by @404-Page-Found in #20925
refactor(topics): move Topics into a feature folder by @kovsu in #23589
docs(export): clarify citation-exclusion setting also applies to Word export by @404-Page-Found with @Copilot in #23581
fix(feishu-channel): stay silent when the mention policy rejects a message by @cherry-coding[bot] in #23590
fix(mcp): reuse an existing MCP server definition on install by @cherry-coding[bot] in #23614
docs(notification-center): propose drawer and task result redesign by @WhiteZeek in #23054
fix(cache): avoid Electron downloads in service tests by @DeJeune in #23632
fix(agent-memory): move editor into agent configuration by @DeJeune in #23633
fix(agent-messages): resume bottom follow after sending by @MasterZRC in #23559
fix(agent-memory): remove unused description translations by @DeJeune in #23637
fix(file-preview): complete desktop file icon and label mappings by @LWWZH in #23624
refactor(agent-session-context): remove test-only context helpers by @kovsu in #23641
feat(provider-registry): add GPT Image 2.6 Flare and Sunburst by @ousugo in #23648
chore: version packages by @github-actions[bot] in #23650
refactor(agent-session-context): drop discarded ancestry read in reserveBranchTx by @kovsu in #23658
refactor(agent-session-message): read the native path in one query by @kovsu in #23656
fix(chat-navigation): show anchors immediately and retire side buttons by @DeJeune in #23655
fix(preference-tests): separate cold import from per-test setup by @DeJeune in #23659
fix(shortcut): resolve character shortcuts from the produced character by @cherry-coding[bot] in #22648
perf(agent-session-message): project only token columns from context rows by @kovsu in #23642
fix(registry-sync): keep GPT Image 2.6 models in legacy catalogs by @ousugo in #23687
feat(message-anchor): add keyboard and screen-reader navigation to the turn rail by @404-Page-Found with @Copilot in #23692
feat(shortcuts): add hotkeys to switch assistants and topics by @404-Page-Found with @Copilot in #23682
feat(markdown): render bare network image URLs as inline images by @404-Page-Found with @Copilot in #23681
fix(claude-code): kill the whole process tree when stopping an Agent task on Windows by @404-Page-Found with @Copilot in #23103
feat(sidebar): add Ctrl/Cmd+1–9 shortcuts to open sidebar items by @404-Page-Found with @Copilot in #23689
feat(notification-center): add unified left drawer and announcement refresh by @WhiteZeek in #23060
feat(task-notifications): show compact outcomes and reply previews by @WhiteZeek in #23061
feat(notification-center): add localized announcements and account menu access by @kangfenmao in #23668
fix(e2e-regression): stabilize phase cleanup and remaining regressions by @cherry-qa[bot] in #23428
fix(notes): restore jump-to-line from full-text search matches by @kovsu in #23732
fix(anthropic-cache): send Bedrock cache points for Claude models by @Haarris in #23726
chore(deps): upgrade eslint-plugin-react-hooks to 7.1.1 by @kovsu in #23735
perf(renderer-hooks): keep Effect Events out of effect dependencies by @kovsu in #23736
perf(remote-access): stop idle timers while remote access is unused by @kovsu in #23733
fix(lifecycle): stop tracking cleanup functions disposed before stop by @kovsu in #23734
refactor(home-page): remove unused SHOW_ASSISTANTS manual-open event by @kovsu in #23738
fix(main-dependencies): ship ai and zod once and drop packaging leftovers by @kovsu in #23743
fix(thinking): stop replaying blank Anthropic thinking blocks by @cherry-coding[bot] in #23744
fix(shortcut): make ESC exit-fullscreen respect IME composition and fullscreen state by @cherry-coding[bot] in #23664
fix(chat): pad image attachments below the provider minimum edge by @cherry-coding[bot] in #23757
fix(e2e): restore the app.shell UI contract anchor on the main-window roots by @cherry-coding[bot] in #23759
docs(skills): propose skill labels and grouped bulk assignment in the agent skill selector by @cherry-coding[bot] in #22958
refactor(agent-runtime): unify desktop execution and message projections by @DeJeune in #22856
docs(agent-context): define harness-owned context usage by @DeJeune in #23146
feat(agent-runtime): unify passive thread context usage by @DeJeune in #23164
perf(agent-session-message): read the edit path once per snapshot by @kovsu in #23653
perf(child-thread-projection): index alias reverse lookup once per history load by @kovsu in #23652
perf(child-thread-projection): avoid full-row read and quadratic scans in archive reorder by @kovsu in #23651
fix(pi-durable): report interrupted subagents as stopped by @kovsu in #23631
perf(ai-stream): project topic messages per flushed batch by @kovsu in #23630
fix(registry-sync): hide GPT Image 2.6 GIF in legacy catalogs by @ousugo in #23765
fix(agent-runtime): isolate observation deliveries by @DeJeune in #23767
feat(provider-registry): add Hy4 to Tencent and TokenHub by @Contentment003111 in #23535
feat(qwen-provider): update branding, links and default endpoints by @shigzz in #23704
chore: version packages by @github-actions[bot] in #23769
docs(agent-notes): propose a conversation target for IM channels by @cherry-coding[bot] in #23768
refactor(agent-runtime-pi-durable): resolve child relations from native records by @DeJeune in #23772
fix(registry-sync): filter unsupported GPT Image 2.6 legacy controls by @ousugo in #23771
fix(error-category): classify invalid inline image payloads as bad_request, not rate_limit by @404-Page-Found with @Copilot in #23719
fix(agent-runtime): reuse native SDK types and helpers by @DeJeune in #23780
fix(shortcuts): unify numbered conversation and tab navigation by @DeJeune in #23778
fix(ai-stream): name the failed stage and log the cause when a response stream dies by @cherry-coding[bot] in #23752
refactor(agent-session): unify thread projection message storage by @DeJeune in #23783
fix(provider-error): name the cause of unprocessable successful responses by @cherry-coding[bot] in #23762
fix(file-processing): downscale oversized images before Windows system OCR by @404-Page-Found with @Copilot in #23711
feat(translate): copy translated output as an image by @louisfy in #23698
fix(assistant-files): make move_to_trash and save_attachment usable by @NatsUIJM in #23598
fix(api-gateway): require content on Anthropic message entries by @cherry-coding[bot] in #23643
docs(chat-markdown): specify consecutive code block tabs by @DeJeune in #23181
docs(spec): propose illustrations within assistant replies by @leezehuan in #23551
docs(remote-access): propose client-owned P2P transport by @DeJeune in #23636
docs(mcp-skills): propose client protocol integration by @DeJeune in #22350
docs(agent-notes): propose Spec for clear conversation context on explicit request by @William20100221 in #23329
fix(file-edit): preserve content following a UTF-8 BOM by @yunyv in #22699
fix(webview-address): normalize bare IPv6 loopback hosts by @yunyv in #23309
fix(citations): preserve Unicode at X preview truncation boundary by @yunyv in #23106
fix(html-artifact): preserve multiline preview titles by @yunyv in #22697
fix(render): keep loading state when a metadata request is superseded by @HHHSL in #21539
fix(serializable): preserve shared non-circular references by @yunyv in #22923
fix(resource-catalog): keep the create wizard draft across tab switches by @cherry-coding[bot] in #23302
fix(api-gateway): surface classified 504 on upstream idle timeout instead of an opaque 500 by @xxiaoxiong in #22080
fix(error-diagnosis): classify provider content-filter rejections as content by @cherry-coding[bot] in #22351
fix(mcp-npx-search): inspect all README server entries for npx samples by @yunyv in #23219
fix(paintings): restore terminal state for cached image generations by @felixren7 in #22707
feat(html-artifact): add copy-source action to the inline source toolbar by @cherry-coding[bot] in #23180
fix(composer): restore live tokens when rebuilding content with an empty draft seed by @Leeeeizz in #23457
fix(quick-panel): avoid backtracking when filtering prompts by @yunyv in #23080
feat(provider-settings): confirm before resetting the provider API host by @cherry-coding[bot] in #23071
fix(archive): name the job record blocking permanent deletion by @cherry-coding[bot] in #23070
feat(selection): save selected conversation text to Notes by @louisfy in #23453
fix(tabs): keep pinned-tab persistence at a fixed point by @cherry-coding[bot] in #22774
fix(archive): release batch busy state across tab switches by @ousugo in #23224
feat(messages): make the branch counter a direct branch switcher by @404-Page-Found with @Copilot in #23720
feat(agent-composer): typing-triggered Plan Mode hint by @404-Page-Found with @Copilot in #23774
Fix drag-and-drop sorting for topics in right panel by @404-Page-Found in #23779
docs(provider-registry): propose Fortytwo built-in provider by @obantysh in #23635
fix(discord-channel): request online presence on the gateway IDENTIFY by @cherry-coding[bot] in #23812
fix(tooltip): swap light and dark mode neutral colors by @DeJeune in #23828
i18n(skill-import): clarify folder drag and drop support in drop hint by @LWWZH in #23839
docs(agents): propose agent-scoped IM channel binding entry points by @404-Page-Found in #23859
docs(agent-notes): propose agent work directory recovery spec by @404-Page-Found in #23860
fix(remote-access): keep identity key-store access off the gateway activation path by @cherry-coding[bot] in #23827
refactor(renderer): unify app-route url parsing behind parseAppRouteUrl by @404-Page-Found with @Copilot in #23691
fix(scroll-area): restore thumb width and rounded ends by @kangfenmao in #23876
fix(translate): repair image capture theme fixture in CI by @DeJeune in #23883
fix(selection-toolbar): size the toolbar window with its own zoom by @cherry-coding[bot] in #23502
Fix non-streaming paths to align with streaming model resolution by @404-Page-Found in #23793
chore: version packages by @github-actions[bot] in #23885
Dispose of issue #23059 by updating BinaryManager by @404-Page-Found in #23781
fix(mistral): tolerate chat-completions tool-call deltas without an id by @cherry-coding[bot] in #23747
fix(agent-runtime): preserve request controls through the gateway by @DeJeune in #23878
fix(markdown): keep \begin{env} LaTeX blocks intact when a line is only = or --- by @404-Page-Found with @Copilot in #23541
fix(file-preview): fit Word previews to the pane and drop the grey mat by @angri450 in #23122
Support input images in ComfyUI workflows by @404-Page-Found with @Copilot in #23270
fix(preference): isolate subscription tests from real Electron by @DeJeune in #23887
fix(validation): include UI theme contracts for renderer changes by @EurFelux in #23879
docs(scheduled-tasks): specify dedicated task page and interactions by @WhiteZeek in #23207
feat(scheduled-tasks): filter task pages and paginate run history by @WhiteZeek in #23220
feat(scheduled-tasks): resolve and retain task conversations by @WhiteZeek in #23221
feat(scheduled-tasks): add dedicated task conversation page by @WhiteZeek in #23222
refactor(scheduled-tasks): retire duplicate settings page by @WhiteZeek in #23725
feat(scheduled-tasks): migrate completed and missed task management by @kangfenmao in #23877
chore: version packages by @github-actions[bot] in #23894
chore(deps): drop unused workspace package dependencies by @kovsu in #23893
feat(scheduler): frame scheduled task triggers as agent executions by @404-Page-Found in #23851
feat(cherry-cloud): enable subscription surfaces in the China edition by @SiinXu in #22937
fix(packaging): trim Claude binaries, use ULFO and polish download status by @kangfenmao in #23895
feat(cherry-cloud): add subscribe touchpoints to the selector and sidebar by @SiinXu in #22938
chore: version packages by @github-actions[bot] in #23896
feat(cherry-cloud): announce a newly active subscription by @SiinXu in #22939
feat(composer): show a quota notice above the input by @SiinXu in #22940
feat(cherry-cloud): show monthly usage in settings and the account panel by @SiinXu in #22941
feat(cherry-cloud): follow China-edition subscription notifications by @SiinXu in #23316
feat(cherry-cloud): add subscription usage insights by @SiinXu in #23405
Fix stale external-store values in hidden tabs by @404-Page-Found with @Copilot in #23854
fix(chat): decouple fold-view reply browsing from context selection by @Doekin in #23889
Restore regenerate action below user messages by @404-Page-Found with @Copilot in #23862
fix(messages): Honor auto-collapse in Agent reasoning history by @404-Page-Found with @Copilot in #23863
Show missing shared runtime status on local model cards by @404-Page-Found with @Copilot in #23837
feat(file-processing): upgrade doc2x processor to v3-2026 with structured layout support by @XueHua-s in #23831
fix(mcp): normalize input schema for parameterless MCP tools by @404-Page-Found in #23821
chore(openai): upgrade image adapter within AI SDK 6 by @ousugo in #23678
docs(paintings): specify GPT Image 2.6 complexity and animation by @ousugo in #23702
feat(paintings): add GPT Image 2.6 complexity and animation by @ousugo in #23684
chore: version packages by @github-actions[bot] in #23908
refactor(cherry-cloud): converge subscription ownership and refresh contracts by @DeJeune in #23906
feat(agent-details): add compact session details card by @DeJeune in #23899
fix(message-branches): show previews in branch switcher by @DeJeune in #23910
fix(message-branches): restore main CI with supported focus event by @DeJeune in #23911
fix(resize-handle): use neutral interaction colors by @DeJeune in #23912
fix(computer-use): let the user recover from unconfirmed runtime cleanup by @DeJeune in #23913
Initialize OpenAI Responses reasoning parts before deltas by @404-Page-Found with @Copilot in #23816
chore(pi-runtime): upgrade Pi dependencies to 1.5.0 by @DeJeune in #23915
fix(computer-use): upgrade runtime and expose input channel by @DeJeune in #23918
fix(agent-runtime): preserve failures and unblock Durable shutdown by @DeJeune in #23919
feat: add “Use as Reference” to generated chat images by @404-Page-Found with @Copilot in #23847
fix(agent-subagent): temporarily disable chat continuation by @DeJeune in #23921
fix(agent-history): align native history actions and explicit mode controls by @DeJeune in #23904
fix(agent-session): show workspace open shortcut in target menu by @DeJeune in #23922
test(agent-right-pane): restore main CI command mock by @DeJeune in #23923
fix(agent-sessions): show pin and archive actions on hover by @DeJeune in #23926
fix(chat-attachments): keep text preparation off the main thread by @DeJeune in #23927
fix(agent-runtime): preserve response identity and context freshness by @DeJeune in #23925
refactor(scheduled-tasks): unify session ownership in migration 0035 by @DeJeune in #23924
test(ci-validation): restore main CI worker isolation and session checks by @DeJeune in #23928
test(claude-runtime): enable native idle events in desktop fixture by @DeJeune in #23929
fix(tool-approval): retire approval cards whose runtime is gone by @NatsUIJM in #23754
fix(builtin-agent): match the delete guard on executable commands by @NatsUIJM in #23597
feat(resource-list): restore direct permanent deletion by @SiinXu in #21837
feat(command-focus): scope keyboard routing and menu origins by @DeJeune in #23917
fix(context-menu): render shortcuts as keycaps by @DeJeune in #23940
docs(skill-marketplace): define discovery and installation contract by @WhiteZeek in #23800
feat(skill-marketplace): add skill catalogs, agent templates and MCP discovery by @WhiteZeek in #20978
fix(agent-creation): default to Pi Durable and hide runtime configuration by @DeJeune in #23937
fix(agent-sessions): hide status icons while shortcut hints show by @DeJeune in #23941
docs(command): specify renderer command target routing by @DeJeune in #23934
docs(agent-runtime-acp): specify stable v1 adapter by @DeJeune in #23916
fix(agent-session): keep background continuations in existing replies by @DeJeune in #23943
Fix regenerate to use the selected model by @404-Page-Found with @Copilot in #23865
fix(chat-messages): preserve history and paint code before highlighting by @DeJeune in #23947
fix(desktop-runtime): address product regressions exposed by e2e by @kangfenmao in #23870
test(agent-session): align approval projection response assertion by @DeJeune in #23955
fix(command-focus): prevent update loops and improve error fallback by @kangfenmao in #23960
Align generate_image reference limits with Paintings by @404-Page-Found with @Copilot in #23374
Reject invalid knowledge-base URLs before saving by @404-Page-Found with @Copilot in #23366
Close the main window with Cmd+W on the last tab by @404-Page-Found with @Copilot in #23282
fix(message-list): animate shared return to bottom by @DeJeune in #23965
fix(command-focus): keep scope attachments stable across rerenders by @DeJeune in #23957
test(knowledge): assert legacy URLs through the restore schema by @404-Page-Found in #23969
fix(agent-session): release session when a pending connect fails during close by @kovsu in #23974
feat(pi-durable): support shared-backend desktop forks by @DeJeune in #23956
fix(tool-approval): notify onAborted when an approval's signal aborts by @kovsu in #23976
fix(ci): skip prek binary downloads in CI by @kangfenmao in #23982
feat(pi-durable): support edit and resend by @DeJeune in #23983
fix(website-links): update official website and documentation domains by @kangfenmao in #23973
fix(composer): keep the manual input height through paste and typing by @cherry-coding[bot] in #23970
refactor(tool-approval): unify pending approval cancellation by @DeJeune in #23984
feat(agent-runtime): apply permission-mode switches to the running turn by @1lck in #23971
fix(agent-session): replace edited tails without history versions by @DeJeune in #23989
fix(pi-durable): keep reasoning tokens in turn usage metadata by @kovsu in #23985
refactor(pi-runtime): share child task publishing between Pi and Durable by @kovsu in #23986
fix(marketplace): unify scrolling and MCP management by @kangfenmao in #23975
fix(chat): refresh rendered message list after editing a message by @404-Page-Found with @Copilot in #23518
fix(ci): restore marketplace main checks by @DeJeune in #23994
Fail fast when Claude Code lacks a Linux session bus by @404-Page-Found with @Copilot in #23380
fix(agent-details): backport shared card visibility to v2.2.0 by @DeJeune in #24027
fix(release): backport #24030 to v2.2.0 by @kangfenmao in #24032
fix(release): backport #24035 to v2.2.0 by @kangfenmao in #24039
fix(release): backport #24036 to v2.2.0 by @kangfenmao in #24040
fix(release): backport #24041 to v2.2.0 by @kangfenmao in #24050
fix(release): backport #24037 to v2.2.0 by @kangfenmao in #24052
fix(release): backport #24081 to v2.2.0 by @kangfenmao in #24095
fix(release): backport #24113 to v2.2.0 by @kangfenmao in #24121
fix(settings): backport tools and language layout to v2.2.0 by @kangfenmao in #24120
fix(release): backport #24124 to v2.2.0 by @kangfenmao in #24128
fix(release): backport #24123 to v2.2.0 by @kangfenmao in #24131

New Contributors

@radianceded made their first contribution in #20356
@cherry-docs-sync[bot] made their first contribution in #23544
@MasterZRC made their first contribution in #23547
@Haarris made their first contribution in #23726
@Contentment003111 made their first contribution in #23535
@shigzz made their first contribution in #23704
@leezehuan made their first contribution in #23551
@William20100221 made their first contribution in #23329
@felixren7 made their first contribution in #22707
@Leeeeizz made their first contribution in #23457
@obantysh made their first contribution in #23635
@XueHua-s made their first contribution in #23831

Full Changelog: v2.1.10...v2.2.0