CherryHQ/cherry-studio v2.2.1 on GitHub

Downloads (v2.2.1)

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.1 - Remote Tasks, Search Providers, and Agent Fixes

✨ New Features

[Tasks] Remote clients can discover scheduled-task result conversations and query task schedules, run history, and bounded summaries. Task conversations remain discoverable after run records are cleaned up.
[Models] Rapid-MLX is available as a built-in, keyless local provider.
[Web Search] Added SerpKite and StepFun keyword search providers, and Exa can now fetch the content of a URL through its Contents API.
[Files] Dropping a Markdown file (.md, .markdown, .mdx) onto the app window opens it in the read-only preview.
[Agent] System and global package installs now ask for approval in normal modes and run in Full Access, instead of being blocked in every mode.
[Agent] Agents and assistants can use an uploaded image as their avatar, shown in catalogs, selectors, conversations, message headers, and Work tab icons. Existing emoji avatars are unchanged.
[Agent] Workspace and agent groups can be pinned to the top Pinned section while their tasks stay expandable.
[Agent] Computer Use calls show the applications they operated, and session details show the same app icons.
[Agent] Subagent calls can name both a provider and a model, and the subtask row shows the requested model.
[Composer] With Markdown input rendering enabled, Markdown is previewed live while typing in Chat, Agent, and the selection compose bar; markers appear when the caret reaches them and the sent text is unchanged.
[Composer] In the Markdown preview, selected text can be made bold, italic, or inline code with Cmd/Ctrl+B, Cmd/Ctrl+I, and a backtick.
[Composer] In the Markdown preview, fenced code blocks render as a highlighted code region, with Enter inserting a newline, Tab indenting, automatic bracket pairing, and variables or shortcuts staying literal inside the fence.
[Browser] New tabs in the built-in browser can start from a blank page, the last opened page, or a custom URL.
[Knowledge] OpenDocument (.odt, .odp, .ods) and RTF (.rtf) files can be added as knowledge sources.
[API Gateway] CherryAI subscription models are available to external clients and Code Mate through the gateway using the signed-in account's quota.

💄 Improvements

[Agent] Pi and Pi Durable use their runtimes' native compaction and keep provider error details.
[Agent] Session details list the applications an agent is controlling, with their status and a Stop action.
[Chat] The branch map locates the active branch node and can be panned on scroll.
[Models] The reasoning-effort slider follows dragging smoothly, settles onto effort levels, and respects reduced-motion settings.
[Models] Truncated model names in the model selector show the full name on hover, and the model details card no longer clips them.
[Scheduled Tasks] Anchor navigation stays aligned while history loads, and failed run summaries show error details in a tooltip.
[Files] File lists and grids show each file's source path in the name tooltip so same-name files can be distinguished.
[Prompt Polish] Shows the default model with a link to its settings and distinguishes timeouts, missing models, empty responses, and provider failures.
[Feedback] Attaching diagnostics to a problem report is now optional.
[macOS] The DMG installer has a new background and a larger, centered drag-to-Applications layout.
[Assistant] The English default assistant is now named "Cherie".
[UI] Expanded notification stacks no longer clip their shadows.

🐛 Bug Fixes

[Agent] Nested shell, file, and artifact tool results in Pi and Pi Durable codemode are shown again, including after reopening a conversation.
[Agent] Pi shell commands without an explicit timeout no longer wait indefinitely.
[Agent] Closing a session interrupts Claude work first, and interrupted Claude Code turns no longer show a "No response requested." placeholder.
[Agent] Fork and Edit & Resend work after a /compact boundary, and fork no longer rejects a healthy Claude session with blank framing lines.
[Agent] The Step panel no longer shows a finished turn as running, and tasks deleted by the agent leave the list.
[Agent] The Agent top bar keeps the workspace name and open-directory action after the first message.
[Agent] Subagent output and the main agent's continuation appear in the correct order in the open conversation.
[Agent] Goals complete when the verifying model wraps its verdict in a code block or extra text.
[Agent] Agent message edit failures show complete, persistent explanations with copyable diagnostics.
[Agent] The context usage panel shows configured MCP server names instead of IDs.
[Agent] Cross-agent session cards name the target agent.
[Agent] Assistant replies in Work conversations no longer offer Delete, because deleting them cannot remove the runtime transcript.
[Agent] Editing a message asks for confirmation before replacing later conversation history.
[Agent] Markdown artifacts can be previewed from an Agent conversation even when the workspace is empty.
[Agent] Work tab icons update when the agent avatar changes while the tab is hidden.
[Chat] Links in sent messages can be selected smoothly, without accidental navigation.
[Chat] Editing a message no longer drops characters typed right after clicking Edit.
[Chat] An error saved twice in older messages now shows one error card.
[Chat] Empty or malformed API responses show a clear diagnosis with retry guidance instead of an unknown error.
[Chat] The "message is still syncing" branch-switch warning is localized.
[Notes] Code syntax highlighting no longer disappears in the editor.
[Shortcuts] Conversation number shortcuts keep working after the first switch without refocusing the window.
[Browser] Page-load failures use a generic message instead of suggesting that a local server stopped.
[Mini Apps] Website MiniApp sign-in popups stay in their persistent session.
[Knowledge] Failed knowledge items show the failure reason, and empty extraction messages are localized.
[Scheduled Tasks] Cron timeouts work with Gemini-compatible runtimes, and deleting a task with more than about 32,000 sessions no longer fails.
[Providers] Requests no longer fail when a client tool has a blank name.
[Claude] Claude Code creates its runtime folder before staging a download, so installs no longer fail on a missing folder.
[Paintings] SiliconFlow MOSS Image requests no longer fail when no image size is selected.
[Code] Codex CLI keeps the selected model's context window and compaction limit when its configuration is rebuilt.
[UI] Agent Session Details no longer crowds its content or overlaps the file preview.

⚡ Performance

[Agent] Branch switching and message editing are faster in long sessions.

What's Changed

fix(ci): cancel closed PR runs and superseded manual validation by @kangfenmao in #23993
feat(agent-runtime-acp): add stable v1 runtime adapter by @DeJeune in #23996
feat(browser): open a configurable start page in the built-in browser by @cherry-coding[bot] in #23961
feat(knowledge): accept OpenDocument and RTF files by @404-Page-Found in #24010
fix(agent-session): confirm before replacing edited history by @DeJeune in #23990
fix(grok-cli): resolve version file through path registry by @kovsu in #24014
feat(agent): show desktop control state in session details by @cherry-coding[bot] in #23959
hotfix(agent-details): persist shared card visibility by @DeJeune in #24023
test(e2e-regression): retain cross-platform verified coverage by @kangfenmao in #23723
fix(release): backport hotfixes before the first draft by @DeJeune in #24029
hotfix(agent-runtime-claude-code): keep Claude Code login readable on macOS by @SiinXu in #24030
hotfix(cherry-cloud): keep checking for notifications after a 404 by @SiinXu in #24035
fix(agent-session): stop usage owners from retaining finished turns by @kovsu in #24009
hotfix(cherry-cloud): show subscription notifications in the notification center by @SiinXu in #24036
fix(code-cli): write the Codex context window from the selected model by @cherry-coding[bot] in #24016
fix(error-category): recognize empty or malformed API responses by @ZKunZhang in #24033
hotfix(workspace-ui): align styling and stabilize desktop interactions by @kangfenmao in #24041
hotfix(api-gateway): preserve caller context in single-step SDK forwarding by @DeJeune in #24037
feat(feedback): make diagnostic attachments optional in the problem report by @cherry-coding[bot] in #24069
fix(agent-session): name the target Agent on cross-Agent session_create cards by @cherry-coding[bot] in #24079
perf(ci): parallelize validation and reduce workflow latency by @1lck in #24080
feat(web-search): add Exa URL fetching through the Contents API by @NatsUIJM in #24077
chore: version packages by @github-actions[bot] in #24082
fix(agent-fork): skip blank framing lines in Claude native history by @cherry-coding[bot] in #24062
fix(e2e-regression): restore highlighting and repair desktop checks by @kangfenmao in #24078
hotfix(dialog-ui): restore close animations and editor layouts by @kangfenmao in #24081
fix(agent-chat): hide delete for assistant replies in Work conversations by @cherry-coding[bot] in #24093
fix(agent-session): chunk session id lists below the SQLite variable limit by @kovsu in #24094
fix(pi-runtime): extract the goal verdict from fenced or prefixed model text by @kovsu in #24026
fix(pi-durable): flush pending child output before saving a continuation by @kovsu in #24025
fix(files): show source path for same-name rows by @SiinXu in #19499
hotfix(settings): reorganize built-in tools and language settings by @kangfenmao in #24099
hotfix(pi-runtime): enable PowerShell tools on Windows by @DeJeune in #24113
fix(agent-session): pin message tree queries to the parent index by @kovsu in #24103
hotfix(pi-subagent): default Pi subagent permissions to bypass by @DeJeune in #24124
hotfix(navigation): restore sidebar settings and correct session details tooltip by @kangfenmao in #24123
Keep MiniApp OAuth popups in their persistent session by @404-Page-Found with @Copilot in #24092
fix(claude-code): drop synthetic CLI turn-closer instead of rendering it as a reply by @404-Page-Found in #20816
fix(prompt-polish): surface model identity and distinct failures by @SiinXu in #20772
fix(conversation-shortcuts): preserve continuous number-key navigation by @DeJeune in #24133
fix(agent-artifact): open Markdown artifacts from chat when the system workspace is empty by @cherry-coding[bot] in #22920
feat(message-flow): locate the active branch node and pan on scroll by @cherry-coding[bot] in #22933
fix(agent-chat): preserve complete edit failure diagnostics by @ZKunZhang in #24134
fix(toast): keep expanded stack shadows inside the scroll padding by @kovsu in #24141
fix(agent-tabs): synchronize hidden tab avatars by @ZKunZhang in #24139
feat(mac-installer): give the DMG window a custom background and layout by @kovsu in #24147
refactor(ipc): remove dead legacy IPC channels by @kovsu in #24158
refactor(file-storage): remove unregistered legacy FileStorage methods by @kovsu in #24157
fix(cron): advertise a Gemini-compatible timeout schema by @ZKunZhang in #24156
refactor(remote-access): drop cross-phase IpcApiService dependency by @kovsu in #24153
fix(silicon-image): default missing MOSS image size by @ZKunZhang in #24137
chore(release): sync v2.2.0 metadata by @kangfenmao in #24135
feat(i18n): name the English default assistant "Cherie" by @cherry-coding[bot] in #24164
test(openai-responses): cover textless stream events by @404-Page-Found with @Copilot in #24106
refactor(temporary-chat): move temporary topic routes from DataApi to IpcApi by @kovsu in #24101
docs(composer): propose Markdown live preview Spec by @EurFelux in #23898
feat(composer): keep one paragraph per source line by @EurFelux in #24055
feat(composer): render Markdown as live preview decorations by @EurFelux in #24056
feat(composer): edit fenced code blocks in the Markdown preview by @EurFelux in #24057
feat(composer): keep fenced Markdown code literal by @EurFelux in #24058
feat(composer): toggle Markdown styles on a selection by @EurFelux in #24059
chore(agent-runtime): upgrade Pi and Pi Durable to 1.5.2 by @DeJeune in #24187
feat(agent-sessions): pin workspace and agent groups by @DeJeune in #24197
fix(cherry-cloud): credit Subscribe clicks made under the avatar dot by @SiinXu in #24190
fix(agent-context): resolve MCP server display names by @DeJeune in #24198
feat(assistant): upload an image avatar for assistants by @cherry-coding[bot] in #23773
feat(agent): upload an image avatar for agents by @cherry-coding[bot] in #23788
perf(ci-validation): reduce runner usage and skip unrelated platform jobs by @kangfenmao in #24132
test(test-quality): remove low-signal behavior-pinning tests by @DeJeune in #24204
fix(code-highlight): drop worker replies when the response channel is gone by @404-Page-Found in #24208
feat(subagent): show the requested model and resolve provider-qualified names by @cherry-coding[bot] in #24182
feat(api-gateway): expose CherryAI subscription models by @DeJeune in #24225
test(pi-durable): allow subagent integration turn to settle by @DeJeune in #24229
fix(knowledge-indexing): show a failed item's reason and localize empty extraction by @cherry-coding[bot] in #24185
fix(scroll-area): separate scroll boundaries from content spacing by @DeJeune in #24226
chore: version packages by @github-actions[bot] in #24231
feat(computer-use): display apps through client presentation data by @DeJeune in #24138
fix(agent-session): render the main agent's continuation after a sub-agent returns by @cherry-coding[bot] in #24228
feat(web-search): add StepFun keyword search provider by @404-Page-Found in #24181
fix(claude-code): create the runtime root before staging a download by @cherry-coding[bot] in #24191
fix(chat): show one card for an error part persisted twice by @SiinXu in #24172
chore: version packages by @github-actions[bot] in #24232
chore(package-licenses): standardize public libraries on MIT by @DeJeune in #24234
feat(web-search): add SerpKite search provider by @Nolikzero in #21426
fix(agent): keep the workspace identity in the Agent top bar after the first message by @cherry-coding[bot] in #24227
fix(agent): stop the Step panel from showing a finished turn as running by @cherry-coding[bot] in #24240
fix(api-gateway): drop blank client tool names before the provider request by @cherry-coding[bot] in #24196
fix(composer): keep keystrokes typed right after starting a message edit by @cherry-coding[bot] in #24194
feat(agent): let users approve system and global package installs by @cherry-coding[bot] in #24195
feat(file-preview): open a dropped Markdown file in the read-only preview by @cherry-coding[bot] in #24201
docs(chat): document ordinary-chat context defaults and windowless compaction by @cherry-coding[bot] in #24202
fix(model-selector): surface a clipped model name through a tooltip by @1lck in #24264
fix(model-speed-control): smooth reasoning slider feedback by @1lck in #24272
feat(provider-registry): add Rapid-MLX as a local provider by @raullenchai in #23363
test(e2e-regression): free the duplicated MP-152 case id by @cherry-coding[bot] in #24256
fix(chat-write-actions): localize the still-syncing branch toast by @kovsu in #24271
fix(claude-code): restore fork and edit-resend after a /compact boundary by @cherry-coding[bot] in #24253
fix(webview): use generic browser load failure copy by @ZKunZhang in #24273
docs(websearch): state the scope of "Prefer model-native web tools" by @cherry-coding[bot] in #24243
fix(scheduled-tasks): center anchor rails and show error tooltips by @kangfenmao in #24290
refactor(renderer-boundary): keep hooks from importing components by @kovsu in #24311
fix(agent-session): interrupt Claude work before closing sessions by @DeJeune in #24310
fix(markdown): keep className parsing runtime-safe and restore array-rewrite coverage by @404-Page-Found in #24206
perf(usage-budget-notification): sum today's tokens instead of running full usage stats by @kovsu in #24301
fix(composer): allow smooth text selection in sent links by @1lck in #24314
fix(pi-shell): default Pi and Durable shell calls to a native timeout by @DeJeune in #24317
docs(agent-compaction): propose native runtime ownership by @DeJeune in #24289
fix(pi-artifacts): preserve nested declarations from native history by @DeJeune in #24318
fix(agent-runtime): use native compaction and preserve provider errors by @DeJeune in #24305
fix(pi-runtime): preserve nested codemode tool results and rendering by @DeJeune in #24322
docs(remote-task-api): define task queries and result discovery by @DeJeune in #24298
feat(remote-task-api): expose tasks and restore result discovery by @DeJeune in #24299
fix(release): backport #24326 to v2.2.1 by @kangfenmao in #24327

New Contributors

@Nolikzero made their first contribution in #21426
@raullenchai made their first contribution in #23363

Full Changelog: v2.2.0...v2.2.1