> opencode.ai is the source of truth for OpenCode, the open source coding agent, including its apps, install commands, docs and releases. The current version is OpenCode v2.
> Cite the canonical page, https://opencode.ai/changelog, not this Markdown file. For an index of the site, see https://opencode.ai/llms.txt.

# Changelog

New updates and improvements to OpenCode

[RSS feed](https://opencode.ai/changelog.xml) · [Watch releases on GitHub](https://github.com/anomalyco/opencode/releases)

## 2026-10-30

### [Worktree and Shell Mode Shortcuts](https://opencode.ai/changelog/v2.2.5)

2026-10-30 · v2.2.5

Press `⌘⌥O` on macOS or `Ctrl+Alt+O` on Windows and Linux to choose a worktree, and `⌘⌥B` or `Ctrl+Alt+B` to choose its base branch. `⌘⇧X` or `Ctrl+Shift+X` now toggles shell mode in the composer. ([#60713](https://github.com/anomalyco/opencode/pull/60713))

#### Send Quotes From the Comment Popup

Hold `⌘` or `Ctrl` in the quote popup to turn its checkmark into send, or press `⌘Enter` or `Ctrl+Enter`, to send just that quote and comment while leaving the rest of the composer untouched. ([#60640](https://github.com/anomalyco/opencode/pull/60640))

#### Percentage Compaction Buffer

Set `"compaction": { "buffer": "20%" }` in `opencode.json` to keep a share of each model's context window free, so one setting fits models with small and large windows. Token counts still work. ([#60647](https://github.com/anomalyco/opencode/pull/60647))

#### Improvements

- **Core:** When `read` misses because a folder is missing, the error names that folder and the nearest one that exists. ([#60688](https://github.com/anomalyco/opencode/pull/60688))
- **Core:** When `edit` can't find `oldString`, the error shows the file's closest lines, or says the change is already there. ([#60689](https://github.com/anomalyco/opencode/pull/60689))
- **Core:** Calls to a tool named `bash` now run as `shell` instead of failing, with the same permissions. A plugin tool actually named `bash` still takes precedence. ([#60687](https://github.com/anomalyco/opencode/pull/60687))
- **Desktop:** Added flat input surfaces and a compact input size. ([#60598](https://github.com/anomalyco/opencode/pull/60598))

#### Fixes

- **Core:** MCP servers that send stdio messages larger than 10 MiB no longer get disconnected, and large messages are read much faster. ([#60694](https://github.com/anomalyco/opencode/pull/60694))
- **Core:** Idle locations no longer restart their MCP servers right after shutting down. ([#60668](https://github.com/anomalyco/opencode/pull/60668))
- **Core:** Compaction now caps its prompt at the model's context window when the input limit is larger. ([#60660](https://github.com/anomalyco/opencode/pull/60660))
- **Core:** LiteLLM context window errors now trigger compaction instead of stopping the session. ([#60692](https://github.com/anomalyco/opencode/pull/60692))
- **Core:** Reasoning is no longer turned into plain text when you switch models or resume an interrupted response, which caused request errors on some providers. ([#60498](https://github.com/anomalyco/opencode/pull/60498))
- **Terminal, Desktop:** The connect menu no longer lists MCP servers, which are managed in their own place. ([#60675](https://github.com/anomalyco/opencode/pull/60675))
- **Desktop:** Added the missing top inset to the search field in the recently closed menu. ([#60652](https://github.com/anomalyco/opencode/pull/60652))

Released in [v2.2.5](https://github.com/anomalyco/opencode/releases/tag/v2.2.5)

### [Persistent Desktop Terminals](https://opencode.ai/changelog/v2.2.4)

2026-10-30 · v2.2.4

Desktop terminals now belong to the session, survive server restarts with their scrollback, and stay synchronized with the TUI and other windows. Renamed terminals also keep their names across restarts. ([#60346](https://github.com/anomalyco/opencode/pull/60346))

#### Publish Interactive Artifacts

Enable `"experimental": { "artifacts": true }` in `opencode.json` to let agents publish, update, and serve HTML or static artifacts through the built-in local provider or plugin-provided storage. ([#60351](https://github.com/anomalyco/opencode/pull/60351))

#### Guided Claude Agent Setup

Select **Claude Agent** from the provider picker to copy `claude auth login`, install Claude Code, and verify the connection before continuing to model selection. ([#60603](https://github.com/anomalyco/opencode/pull/60603))

#### Choose a Base Branch Quickly

While creating a worktree, open **Choose base branch** with `⌘⌥.` on macOS or `Ctrl+Alt+.` on Windows and Linux. The command is also available in the command palette and Settings › Shortcuts. ([#60579](https://github.com/anomalyco/opencode/pull/60579))

#### Improvements

- **Core:** Made enabled schedules run under `opencode serve` and coordinated multiple server processes so a schedule fires only once. Schedules remain opt-in through `experimental.schedules`. ([#60478](https://github.com/anomalyco/opencode/pull/60478))
- **Core:** Raised OpenCode Go limits for DeepSeek V4.1 Flash. ([#60625](https://github.com/anomalyco/opencode/pull/60625))
- **Desktop:** Simplified the session location popover and made long paths easier to read. ([#60492](https://github.com/anomalyco/opencode/pull/60492))
- **SDK:** Extended `client.experimental.persistentPty.update` to rename terminals or clear a user title, and exposed `userTitle` plus `persistent-pty.updated` events. ([#60329](https://github.com/anomalyco/opencode/pull/60329))

#### Fixes

- **Core:** Allowed user, project, and remote configuration to override Console-supplied provider names, limits, variants, settings, and headers. ([#60597](https://github.com/anomalyco/opencode/pull/60597))
- **Core:** Kept local OpenCode service requests out of environment-configured proxies. ([#60441](https://github.com/anomalyco/opencode/pull/60441))
- **Core:** Replaced Claude Code’s misleading `/login` instruction with `claude auth login`. ([#60592](https://github.com/anomalyco/opencode/pull/60592), [@Tarquinen](https://github.com/Tarquinen))
- **Terminal:** Preserved prompt cursor styles applied by plugins when themes or unrelated prompt state change. ([#60599](https://github.com/anomalyco/opencode/pull/60599))
- **Terminal:** Added missing right padding to edit and patch diffs. ([#60614](https://github.com/anomalyco/opencode/pull/60614))
- **Terminal:** Extended the vertical session-tab activity pulse across the full tab width. ([#60338](https://github.com/anomalyco/opencode/pull/60338))
- **Desktop:** Kept terminal tab clicks and rename fields attached to the intended tab. ([#60645](https://github.com/anomalyco/opencode/pull/60645))
- **Desktop:** Listed matching commands before sessions in command-palette search. ([#60616](https://github.com/anomalyco/opencode/pull/60616))
- **Desktop:** Restored copying user messages from an open actions menu. ([#60576](https://github.com/anomalyco/opencode/pull/60576))
- **Desktop:** Reduced repeated work and allocations while streaming Markdown, especially in long sessions. ([#60549](https://github.com/anomalyco/opencode/pull/60549), [#60562](https://github.com/anomalyco/opencode/pull/60562), [#60577](https://github.com/anomalyco/opencode/pull/60577))

Released in [v2.2.4](https://github.com/anomalyco/opencode/releases/tag/v2.2.4)

### [Use Claude Code in OpenCode](https://opencode.ai/changelog/v2.2.3)

2026-10-30 · v2.2.3

Install Claude Code, run `claude auth login`, then select **Claude Agent** in `/connect` to use your Claude Code login and models. ([#58782](https://github.com/anomalyco/opencode/pull/58782))

#### Faster Long Sessions in Desktop

Streaming replies and long conversations now do much less rendering work. ([#60489](https://github.com/anomalyco/opencode/pull/60489), [#60521](https://github.com/anomalyco/opencode/pull/60521), [#60513](https://github.com/anomalyco/opencode/pull/60513), [#60481](https://github.com/anomalyco/opencode/pull/60481))

#### Desktop Stability Fixes

Fixes side-panel tabs, repeated "Session not found" toasts, and **Open file** over HTTP. ([#60430](https://github.com/anomalyco/opencode/pull/60430), [#60436](https://github.com/anomalyco/opencode/pull/60436), [#60459](https://github.com/anomalyco/opencode/pull/60459), [#60462](https://github.com/anomalyco/opencode/pull/60462))

#### Breaking changes

**TUI plugins require OpenTUI 0.8**

`@opencode/plugin` now requires `@opentui/core` and `@opentui/solid` 0.8.0 or later. In OpenTUI 0.8, a ScrollBox's `wrapper`, `viewport`, `content`, and scrollbars are facade objects instead of renderables, and a custom `RenderContext` must implement `clock` and `onAnimationTick`. See the [OpenTUI 0.8.0 release notes](https://opentui.com/docs/releases/0.8.0).

**Managed policy: `integration.use` covers integrations only**

`integration.use` now controls which integration accounts can be used, and the new `mcp.use`, `skill.use`, and `plugin.use` actions control MCP servers, skills, and plugins. Rules with the old `mcp:`, `skill:`, and `plugin:` resource prefixes are converted automatically, but a bare `integration.use` rule no longer applies to MCP servers, skills, or plugins.

#### Improvements

- **Core:** Added Code Mode JavaScript checks to experimental schedules, including statically authorized tool calls, persistent state, and custom wake messages. ([#60140](https://github.com/anomalyco/opencode/pull/60140))
- **Core:** Added separate managed-policy actions for connecting to integrations and using integrations, MCP servers, skills, and plugins. ([#60315](https://github.com/anomalyco/opencode/pull/60315))
- **Terminal, SDK:** Added lazy loading for stored image references when `experimental.media_blob` is enabled. Images are downloaded only for previews, while undo, revert, fork, and prompt recall restore referenced attachments safely. ([#60116](https://github.com/anomalyco/opencode/pull/60116))
- **Terminal:** Added a distinct marker for the selected composer suggestion in the new designs. ([#60393](https://github.com/anomalyco/opencode/pull/60393))
- **Desktop:** Added a Desktop spellcheck toggle under **Settings → General** and system-language dictionary selection on Windows and Linux. ([#59129](https://github.com/anomalyco/opencode/pull/59129))
- **Desktop:** Added `PageUp` and `PageDown` timeline paging from the composer without moving the draft cursor or focus. ([#59426](https://github.com/anomalyco/opencode/pull/59426))
- **Desktop:** Added independently configurable question notifications and sounds under **Settings → Notifications → Questions**. ([#60358](https://github.com/anomalyco/opencode/pull/60358), [@YuriNek0](https://github.com/YuriNek0))
- **Desktop:** Added separate project and worktree actions to the new-session control. ([#60486](https://github.com/anomalyco/opencode/pull/60486))
- **Desktop:** Added one-click version copying in **Settings → About**. ([#52356](https://github.com/anomalyco/opencode/pull/52356))
- **Desktop:** Grouped added projects in workspace settings. ([#60221](https://github.com/anomalyco/opencode/pull/60221))
- **Desktop:** Made question-answer text selectable. ([#60372](https://github.com/anomalyco/opencode/pull/60372))
- **Desktop:** Adapted the session header to narrow timeline widths. ([#59512](https://github.com/anomalyco/opencode/pull/59512))
- **SDK:** Preserved partial `LLMResponse` output on `AIError.partial` when generation, object generation, or a tool loop fails. ([#60477](https://github.com/anomalyco/opencode/pull/60477))
- **SDK:** Unified Effect and Promise tool declarations around `tool(...)`, with optional output schemas and executable or declaration-only tools. ([#60407](https://github.com/anomalyco/opencode/pull/60407))
- **SDK:** Added typed OpenRouter `debug`, `models`, `plugins`, `provider`, and `user` options to the Responses route. ([#60044](https://github.com/anomalyco/opencode/pull/60044))
- **Extensions:** Added persistent-terminal renaming to the process daemon, including capability discovery and user titles that override shell-provided titles until cleared. ([#60324](https://github.com/anomalyco/opencode/pull/60324))

#### Fixes

- **Core:** Preserved plugin-provided model variants and delayed dynamic provider fallback until external SDK hooks have run. ([#60097](https://github.com/anomalyco/opencode/pull/60097), [#60380](https://github.com/anomalyco/opencode/pull/60380))
- **Core:** Preserved permission reasons and feedback in MCP failures, and made Code Mode failures match direct tool-call failures. ([#60102](https://github.com/anomalyco/opencode/pull/60102), [#60109](https://github.com/anomalyco/opencode/pull/60109))
- **Core:** Fixed invalid Code Mode schedule checks so creation fails immediately and existing invalid checks pause without repeated execution. ([#60349](https://github.com/anomalyco/opencode/pull/60349))
- **Core:** Removed a session’s persistent terminals when the session is deleted. ([#60322](https://github.com/anomalyco/opencode/pull/60322))
- **Core:** Kept nested tool progress from replacing the parent `execute` call rows. ([#60480](https://github.com/anomalyco/opencode/pull/60480))
- **Terminal:** Fixed PHP syntax highlighting for code blocks without an opening `<?php` tag. ([#60359](https://github.com/anomalyco/opencode/pull/60359))
- **Terminal:** Preserved `#` in file-search paths unless it introduces a valid line range. ([#60336](https://github.com/anomalyco/opencode/pull/60336))
- **Terminal:** Kept the configured default cursor style after config reloads. ([#60302](https://github.com/anomalyco/opencode/pull/60302))
- **Terminal:** Matched the search cursor to the highlighted row when a selection dialog has no query. ([#60310](https://github.com/anomalyco/opencode/pull/60310))
- **Desktop:** Kept question options and submit controls reachable on mobile. ([#60335](https://github.com/anomalyco/opencode/pull/60335))
- **Desktop:** Preserved simultaneous request notifications and inbox scroll position when opening sessions. ([#60378](https://github.com/anomalyco/opencode/pull/60378), [#60356](https://github.com/anomalyco/opencode/pull/60356))
- **Desktop:** Fixed consecutive dropped files so every file mention is inserted into the composer. ([#60463](https://github.com/anomalyco/opencode/pull/60463))
- **Desktop:** Kept the current `@` and command-menu selection stable while results update under a stationary pointer. ([#59434](https://github.com/anomalyco/opencode/pull/59434), [#60368](https://github.com/anomalyco/opencode/pull/60368))
- **Desktop:** Fixed `⌘W` side-panel closing and focus restoration when no closable tabs remain. ([#59002](https://github.com/anomalyco/opencode/pull/59002), [#60435](https://github.com/anomalyco/opencode/pull/60435))
- **Desktop:** Kept the mobile session drawer open while a session loads. ([#59427](https://github.com/anomalyco/opencode/pull/59427))
- **Desktop:** Restored maximized windows on their saved display and retained renderer permissions across shared-session windows. ([#60482](https://github.com/anomalyco/opencode/pull/60482), [#60458](https://github.com/anomalyco/opencode/pull/60458))
- **Desktop:** Fixed timeline growth, zoom-end scrolling, highlighting, and DOM-observer performance issues in long sessions. ([#60489](https://github.com/anomalyco/opencode/pull/60489), [#60481](https://github.com/anomalyco/opencode/pull/60481), [#60488](https://github.com/anomalyco/opencode/pull/60488), [#60513](https://github.com/anomalyco/opencode/pull/60513), [#60521](https://github.com/anomalyco/opencode/pull/60521))
- **Desktop:** Kept models with unknown release dates visible. ([#60496](https://github.com/anomalyco/opencode/pull/60496), [@joe-ieta](https://github.com/joe-ieta))
- **Desktop:** Fixed reasoning-capability detection for models that expose reasoning through variants or compatibility metadata. ([#60457](https://github.com/anomalyco/opencode/pull/60457))
- **Desktop:** Fixed the macOS application icon and added the required folder-access description to the app bundle. ([#60020](https://github.com/anomalyco/opencode/pull/60020), [#60503](https://github.com/anomalyco/opencode/pull/60503))
- **SDK:** Matched the Promise AI client more closely to the Effect API and accepted typed tools in loops. ([#60465](https://github.com/anomalyco/opencode/pull/60465), [#60390](https://github.com/anomalyco/opencode/pull/60390))
- **SDK:** Kept tools whose `execute` handler can throw available to the AI client. ([#60431](https://github.com/anomalyco/opencode/pull/60431))
- **SDK:** Continued polling queued media generations when providers return unknown intermediate statuses. ([#59988](https://github.com/anomalyco/opencode/pull/59988))
- **SDK:** Stopped sending an incompatible `filename` alongside `file_url` on OpenAI Responses requests. ([#60382](https://github.com/anomalyco/opencode/pull/60382))
- **Extensions:** Preserved `null` values in Code Mode text encoding. ([#57639](https://github.com/anomalyco/opencode/pull/57639), [@xiajiahang](https://github.com/xiajiahang))
- **Extensions:** Tidied nested Extensions menus. ([#59468](https://github.com/anomalyco/opencode/pull/59468))

Released in [v2.2.3](https://github.com/anomalyco/opencode/releases/tag/v2.2.3)

## 2026-10-29

### [Image Generation by Default](https://opencode.ai/changelog/v2.2.2)

2026-10-29 · v2.2.2

When a connected provider supports image models, agents can now use `experimental_image_generate` without additional configuration. Set its preferred model through `experimental.image_generate.model`. ([#60258](https://github.com/anomalyco/opencode/pull/60258))

#### Faster Worktree Selection

On the new-session screen, click the current Git branch to open that project’s “Run session in” worktree picker directly. ([#60263](https://github.com/anomalyco/opencode/pull/60263))

#### Unified Quotes and Annotations

Timeline quotes, terminal quotes, and browser annotations now share a compact optional-comment editor, while source highlights remain attached to local drafts. ([#60164](https://github.com/anomalyco/opencode/pull/60164))

#### Improvements

- **Core:** Recorded the start time of each session’s latest execution.
- **Desktop:** Restored classic question cards by default and added **Settings → Experimental → New question UI** for the redesigned keyboard-oriented dock. ([#59723](https://github.com/anomalyco/opencode/pull/59723))
- **Desktop:** Added a side-panel tab menu and kept close buttons visible when tabs overflow.
- **Desktop:** Moved user-message actions into a compact menu.
- **Desktop:** Redesigned the active todo pill to show the current task and concurrent work more clearly.
- **Desktop:** Added consistent styling for searchable dialogs and composer pills.
- **SDK:** Added `if` and `until` inputs for `client.experimental.schedule.create`, plus schedule check results and output fields. ([#60137](https://github.com/anomalyco/opencode/pull/60137))
- **SDK:** Exposed `SessionInfo.time.busy` for the latest execution’s start time.
- **SDK:** Added optional source metadata to prompt file attachments.

#### Fixes

- **Core:** Rejected persistent terminal requests whose working directory no longer exists.
- **Core:** Preserved media when sessions are forked or imported.
- **Core:** Associated image-generation notices with the correct background job.
- **Terminal:** Preserved captured attachments and their original source paths. ([#60222](https://github.com/anomalyco/opencode/pull/60222), [@OpeOginni](https://github.com/OpeOginni))
- **Terminal:** Prevented middle-truncated paths from overflowing at very narrow terminal widths.
- **Terminal:** Improved Go usage-limit messages with the reset time and account page link.
- **Terminal:** Correctly typed and displayed Go and ChatGPT usage-limit errors.
- **Desktop:** Stopped queued prompts from dropping frames as their content grows.
- **Desktop:** Counted queued quotes and browser annotations as attachments.
- **Desktop:** Reported failures to persist composer attachments through the normal error UI.
- **Desktop:** Made Markdown fragment links scroll to the referenced heading.
- **Desktop:** Kept each tab’s timeline state when switching directories.
- **Desktop:** Ordered the inbox’s **Working** shelf by execution start time.
- **Desktop:** Fixed side-panel launchers and automatic closing when the final tab is removed.
- **Desktop:** Focused the matching navigation arrow while reviewing changes.
- **Desktop:** Preserved pending model labels only when a queued prompt actually changes models.
- **Desktop:** Added reset details, an account link, and a composer tray for Go usage limits.
- **Extensions:** Corrected visible flowchart edges connected through Merman subgraphs.

Released in [v2.2.2](https://github.com/anomalyco/opencode/releases/tag/v2.2.2)

### [Keep Working Toward a Goal](https://opencode.ai/changelog/v2.2.1)

2026-10-29 · v2.2.1

Run `/goal <objective>` in the TUI or Desktop to let the session continue until a reviewer confirms the objective is met. Use `/goal pause`, `/goal resume`, or `/goal clear` to control it. ([#59437](https://github.com/anomalyco/opencode/pull/59437))

#### Generate Images

Enable `experimental.image_generate` to let agents create or edit images with the new `image_generate` tool. You can optionally set its default model with `experimental.image_generate.model`. ([#59939](https://github.com/anomalyco/opencode/pull/59939), [#60096](https://github.com/anomalyco/opencode/pull/60096))

#### Inspect Background Shells

Click a running shell in the Desktop activity pill to see its live output and stop it without leaving the menu. ([#59496](https://github.com/anomalyco/opencode/pull/59496))

#### New Default Model Picker

Search favorites, recent models, providers, and variants from the redesigned model picker, which is now the default in Desktop. ([#59997](https://github.com/anomalyco/opencode/pull/59997))

#### Breaking changes

**`@opencode/ai` provider removals and renames**

These changes affect code that imports `@opencode/ai` directly. They don't change the CLI, Desktop, or the HTTP API.

- The fal, Black Forest Labs, Replicate, and Stability providers are removed, along with their `./providers/fal`, `./providers/black-forest-labs`, `./providers/replicate`, and `./providers/stability` entry points.
- Five legacy entry points are removed. Import the nested paths instead, which 2.2.0 already exports: `./providers/amazon-bedrock-mantle` → `./providers/amazon-bedrock/mantle`, and `./providers/google-vertex-chat`, `-interactions`, `-mistral`, and `-responses` → `./providers/google-vertex/chat`, `/interactions`, `/mistral`, and `/responses`.
- Each provider's `configure()` input type is now named `Config`, for example `Groq.LanguageModelOptions` → `Groq.Config`, and `model()` settings are optional when every setting is optional.

#### Improvements

- **Core:** Add opt-in scheduled prompts through `/schedule`, agent tools, and `experimental.schedules`. ([#59401](https://github.com/anomalyco/opencode/pull/59401), [#59457](https://github.com/anomalyco/opencode/pull/59457))
- **Core:** Offer GPT Image 2 after Codex sign-in and add MiniMax and Meta Muse image generation support. ([#60085](https://github.com/anomalyco/opencode/pull/60085), [#59929](https://github.com/anomalyco/opencode/pull/59929), [#60081](https://github.com/anomalyco/opencode/pull/60081))
- **Core:** Add Responses API support for OpenRouter, DigitalOcean, and Venice, including freeform tools. ([#59991](https://github.com/anomalyco/opencode/pull/59991), [#59963](https://github.com/anomalyco/opencode/pull/59963))
- **Core:** Improve snapshot performance by coalescing captures and avoiding repeated ignore-file work. ([#59419](https://github.com/anomalyco/opencode/pull/59419))
- **Desktop:** Add `/reload` to reload configuration without restarting. ([#59887](https://github.com/anomalyco/opencode/pull/59887))
- **Desktop:** Redesign the integrations dialog and always include OpenCode free models in the model picker. ([#59976](https://github.com/anomalyco/opencode/pull/59976), [#60047](https://github.com/anomalyco/opencode/pull/60047))
- **Desktop:** Add project, worktree, open-in-app, and terminal actions to the session location menu. ([#59607](https://github.com/anomalyco/opencode/pull/59607))
- **Desktop:** Refine project and worktree selection, command search, prompt-history focus, composer model labels, and artifact preview controls. ([#59397](https://github.com/anomalyco/opencode/pull/59397), [#59604](https://github.com/anomalyco/opencode/pull/59604), [#59626](https://github.com/anomalyco/opencode/pull/59626), [#59735](https://github.com/anomalyco/opencode/pull/59735), [#59657](https://github.com/anomalyco/opencode/pull/59657))
- **Desktop:** Highlight quoted timeline content while you write its first comment. ([#59286](https://github.com/anomalyco/opencode/pull/59286))
- **Desktop:** Keep draft attachment bytes local when using experimental media URIs. ([#59104](https://github.com/anomalyco/opencode/pull/59104))
- **SDK:** Add `client.experimental.schedule.{create,list,get,pause,resume,delete}` for managing scheduled prompts. ([#59457](https://github.com/anomalyco/opencode/pull/59457))
- **SDK:** Group experimental generated-client methods under `client.experimental`; previous locations remain as deprecated aliases until the next minor release. ([#59072](https://github.com/anomalyco/opencode/pull/59072))
- **SDK:** Expose compaction through the Promise AI client. ([#59987](https://github.com/anomalyco/opencode/pull/59987))
- **SDK:** Add freeform tool support and Responses routes for OpenRouter, DigitalOcean, and Venice. ([#59963](https://github.com/anomalyco/opencode/pull/59963), [#59991](https://github.com/anomalyco/opencode/pull/59991))
- **Extensions:** Let Code Mode extension globals return Effects and declare required services. ([#59948](https://github.com/anomalyco/opencode/pull/59948))

#### Fixes

- **Core:** Preserve more context headroom when fitting tool output into the context window. ([#59934](https://github.com/anomalyco/opencode/pull/59934))
- **Core:** Retry provider throttling correctly instead of reporting it as context overflow. ([#59649](https://github.com/anomalyco/opencode/pull/59649))
- **Core:** Send image-edit references and image sizes in the formats expected by OpenRouter, Google, and Vercel Grok. ([#60067](https://github.com/anomalyco/opencode/pull/60067), [#59927](https://github.com/anomalyco/opencode/pull/59927))
- **Core:** Keep credential metadata and prompt-cache settings out of model settings and variants. ([#60057](https://github.com/anomalyco/opencode/pull/60057), [#59500](https://github.com/anomalyco/opencode/pull/59500))
- **Core:** Keep Git snapshots working in repositories that use a split index. ([#59417](https://github.com/anomalyco/opencode/pull/59417))
- **Core:** Expose Console web search only when the workspace enables it. ([#59592](https://github.com/anomalyco/opencode/pull/59592))
- **Core:** Improve Code Mode diagnostics for parse errors, stalled awaits, and promise-like search results. ([#59834](https://github.com/anomalyco/opencode/pull/59834), [#59749](https://github.com/anomalyco/opencode/pull/59749), [#59981](https://github.com/anomalyco/opencode/pull/59981))
- **Terminal:** Show execution failures that occur before the first model step. ([#60079](https://github.com/anomalyco/opencode/pull/60079))
- **Terminal:** Keep the activity spinner visible while a continued subagent runs. ([#59950](https://github.com/anomalyco/opencode/pull/59950))
- **Terminal:** Send pasted image and PDF paths correctly when connected to a local server. ([#59833](https://github.com/anomalyco/opencode/pull/59833))
- **Terminal:** Improve spacing in an empty `/usage` dialog. ([#59918](https://github.com/anomalyco/opencode/pull/59918), [@Tarquinen](https://github.com/Tarquinen))
- **Desktop:** Follow each plugin server’s configured endpoint when connecting to its event stream. ([#60087](https://github.com/anomalyco/opencode/pull/60087))
- **Desktop:** Treat the reachable scroll boundary as the end when Desktop zoom is active. ([#60034](https://github.com/anomalyco/opencode/pull/60034))
- **Desktop:** Prevent shell text from showing through copy buttons and avoid restyling the transcript when closing a side panel. ([#59901](https://github.com/anomalyco/opencode/pull/59901), [#59878](https://github.com/anomalyco/opencode/pull/59878))
- **Desktop:** Keep rendering malformed tool metadata instead of crashing the timeline. ([#59736](https://github.com/anomalyco/opencode/pull/59736))
- **Desktop:** Make dropdowns open immediately and keep the new-session location shortcut working after tooltip interactions. ([#59268](https://github.com/anomalyco/opencode/pull/59268), [#59680](https://github.com/anomalyco/opencode/pull/59680))
- **Desktop:** Remove edge halos from macOS application icons. ([#59900](https://github.com/anomalyco/opencode/pull/59900))

Released in [v2.2.1](https://github.com/anomalyco/opencode/releases/tag/v2.2.1)

## 2026-10-28

### [Failed TUI worker requests now return an error instead of leaving the caller hanging](https://opencode.ai/changelog/v1.19.5)

2026-10-28 · v1.19.5

Released in [v1.19.5](https://github.com/anomalyco/opencode/releases/tag/v1.19.5)

## 2026-10-27

### [Create, install and share Desktop plugins (experimental)](https://opencode.ai/changelog/v2.2.0)

2026-10-27 · v2.2.0

#### Refreshed the desktop app experience

#### Add experimental image and decision generation APIs to plugins and sdk

Add experimental image and decision generation APIs to plugins and sdk, allowing image generation or decision model (think typesafe, clef, etc) workflows. ([#59190](https://github.com/anomalyco/opencode/pull/59190), [#59380](https://github.com/anomalyco/opencode/pull/59380), [#58758](https://github.com/anomalyco/opencode/pull/58758))

#### Plugins can now attach and update keyed session instructions with ctx.session.instructions.entry.put/list/remove

Plugins can now attach and update keyed session instructions with ctx.session.instructions.entry.put/list/remove. Instead of editing the system prompt and busting the prompt cache, each change is added as a small update at the next step. The entries also survive compaction and reverts, and they don't start an extra model turn. ([#56550](https://github.com/anomalyco/opencode/pull/56550))

#### Restored the Todo tool in desktop via opt-in

#### Add configurable prompt cache TTLs per provider/model

#### Breaking changes

**`@opencode/ai` root is now the Promise API**

`@opencode/ai` now works like `@opencode/sdk` and `@opencode/client`: the package root exports the Promise API, and the Effect API moved to `@opencode/ai/effect`. `@opencode/ai/promise` is removed, and the wildcard subpath export is replaced with an explicit list of provider and protocol entry points.

```diff
-import { AI } from "@opencode/ai/promise"
-import { LLM } from "@opencode/ai"
+import { AI } from "@opencode/ai"
+import { LLM } from "@opencode/ai/effect"
```

**The OpenCode GitHub Action is removed**

The OpenCode GitHub Action is no longer published. Remove it from your workflows.

**TUI plugins require OpenTUI 0.7**

`@opencode/plugin` now requires `@opentui/core` and `@opentui/solid` 0.7.0, up from 0.6.8 or later. Plugins that depend on OpenTUI 0.6 fail to install until they upgrade. In OpenTUI 0.7, custom renderables read their hooks from their class at construction: assign `renderBefore`, `renderAfter`, and `onLifecyclePass` in the constructor instead of as class fields, call `refreshHooks()` after adding a hook by reflection, and replace `defineNativeIntegration()` with a `static nativeIntegration` declaration. See the [OpenTUI 0.7.0 release notes](https://opentui.com/docs/releases/0.7.0).

#### Improvements

- **Core:** Improve integration rebuild performance. ([#59402](https://github.com/anomalyco/opencode/pull/59402))
- **Core:** Let custom model configuration set a model type. ([#59388](https://github.com/anomalyco/opencode/pull/59388))
- **Core:** Let model-list API requests filter by type. ([#59355](https://github.com/anomalyco/opencode/pull/59355))
- **Core:** Make external-directory permission checks use the project's filesystem. ([#59089](https://github.com/anomalyco/opencode/pull/59089))
- **Core:** Reduce memory use when code search finds very large lines. ([#59205](https://github.com/anomalyco/opencode/pull/59205))
- **Core:** Let plugins filter event subscriptions by type. ([#58864](https://github.com/anomalyco/opencode/pull/58864))
- **Core:** Move image resizing off the main process and release idle image memory. ([#58820](https://github.com/anomalyco/opencode/pull/58820))
- **Core:** Reduce repeated session-history loading during a step. ([#59091](https://github.com/anomalyco/opencode/pull/59091))
- **Core:** Add an experimental API for session media and opt-in media URI support. ([#59103](https://github.com/anomalyco/opencode/pull/59103))
- **Core:** Add the machine hostname to `/api/info`. ([#59090](https://github.com/anomalyco/opencode/pull/59090))
- **Core:** Add experimental content-addressed blob storage for session media behind `experimental.media_blob`. ([#58656](https://github.com/anomalyco/opencode/pull/58656), [#58741](https://github.com/anomalyco/opencode/pull/58741))
- **Core:** Start session history from the latest completed compaction. ([#59020](https://github.com/anomalyco/opencode/pull/59020))
- **Core:** Reduce work encoding durable event payloads that are not persisted. ([#58923](https://github.com/anomalyco/opencode/pull/58923))
- **Core:** Expose MCP server titles from `serverInfo`. ([#58950](https://github.com/anomalyco/opencode/pull/58950))
- **Core:** Apply OpenCode Console workspace configuration as a configuration layer. ([#57703](https://github.com/anomalyco/opencode/pull/57703))
- **Core:** Replace experimental evaluations with Decision APIs in the AI pkg, including OpenAI Decisions, System One, and Cloudflare Run models. ([#58758](https://github.com/anomalyco/opencode/pull/58758), [#58382](https://github.com/anomalyco/opencode/pull/58382), [#58379](https://github.com/anomalyco/opencode/pull/58379), [#58381](https://github.com/anomalyco/opencode/pull/58381))
- **Core:** Convert tool schemas once to speed up tool execution. ([#58798](https://github.com/anomalyco/opencode/pull/58798), [#58848](https://github.com/anomalyco/opencode/pull/58848))
- **Core:** Make Git project discovery faster while recognizing repository changes. ([#58616](https://github.com/anomalyco/opencode/pull/58616))
- **Core:** Show OpenCode Console budget limits and Go usage where they block you. ([#58694](https://github.com/anomalyco/opencode/pull/58694), [#58714](https://github.com/anomalyco/opencode/pull/58714))
- **Core:** Record provider-reported session costs. ([#58562](https://github.com/anomalyco/opencode/pull/58562))
- **Core:** Find Git more reliably on macOS. ([#58602](https://github.com/anomalyco/opencode/pull/58602))
- **Core:** Resolve model details once per prompt step. ([#58601](https://github.com/anomalyco/opencode/pull/58601))
- **Core:** Add GPT-6.1 Terra and GPT-6.1 Terra Fast to Sign in with ChatGPT. ([#59359](https://github.com/anomalyco/opencode/pull/59359))
- **Terminal:** Reduce CPU use while animated session-tab pulses are visible. ([#59235](https://github.com/anomalyco/opencode/pull/59235))
- **Terminal:** List OpenCode Console before OpenCode Go in the integration picker. ([#59107](https://github.com/anomalyco/opencode/pull/59107))
- **Terminal:** Add `/usage`, model-picker, prompt, sidebar, warning, and error details for OpenCode Console usage limits. ([#58731](https://github.com/anomalyco/opencode/pull/58731))
- **Terminal:** Make CLI service registration more reliable when concurrent processes update its files. ([#59105](https://github.com/anomalyco/opencode/pull/59105))
- **Desktop:** Add a persistent desktop zoom setting. ([#59277](https://github.com/anomalyco/opencode/pull/59277))
- **Desktop:** Capture heap snapshots in desktop debug builds on `SIGUSR2` when explicitly enabled. ([#58317](https://github.com/anomalyco/opencode/pull/58317))
- **Desktop:** Show the open session title in the browser tab. ([#59131](https://github.com/anomalyco/opencode/pull/59131))
- **Desktop:** Load session history once when returning to a session tab. ([#59166](https://github.com/anomalyco/opencode/pull/59166))
- **Desktop:** Answer questions with number keys and show multi-select choices as checkboxes. ([#58595](https://github.com/anomalyco/opencode/pull/58595))
- **Desktop:** Let you edit line comments and copy shell output. ([#58970](https://github.com/anomalyco/opencode/pull/58970), [#58974](https://github.com/anomalyco/opencode/pull/58974))
- **Desktop:** Render Mermaid diagrams in messages much faster, sized to fit the column. ([#57483](https://github.com/anomalyco/opencode/pull/57483), [#57004](https://github.com/anomalyco/opencode/pull/57004))
- **Desktop:** Add opt-in memory logging and remote debugging for desktop debug builds. ([#58315](https://github.com/anomalyco/opencode/pull/58315))
- **Desktop:** Show web sources for a turn behind the experimental Sources setting. ([#58307](https://github.com/anomalyco/opencode/pull/58307))
- **Desktop:** Jump from a completed shell notification to its shell output. ([#58663](https://github.com/anomalyco/opencode/pull/58663))
- **Desktop:** Keep the composer usable while the voice-call panel floats. ([#58587](https://github.com/anomalyco/opencode/pull/58587))
- **Desktop:** Use the Soft Radar activity spinner by default and provide experimental variations. ([#58010](https://github.com/anomalyco/opencode/pull/58010), [#57903](https://github.com/anomalyco/opencode/pull/57903))
- **Desktop:** Add an experimental new model picker. ([#58413](https://github.com/anomalyco/opencode/pull/58413))
- **Desktop:** Add experimental Console voice calls in Desktop beta. ([#58249](https://github.com/anomalyco/opencode/pull/58249))
- **Desktop:** Add a timeline width setting. ([#58308](https://github.com/anomalyco/opencode/pull/58308))
- **Desktop:** Improve command, session, and model search lists with sticky sections. ([#58222](https://github.com/anomalyco/opencode/pull/58222))
- **Desktop:** Add search to recently closed sessions. ([#55721](https://github.com/anomalyco/opencode/pull/55721))
- **Desktop:** Open extension configuration and skills in side tabs. ([#58023](https://github.com/anomalyco/opencode/pull/58023))
- **Desktop:** Open session extension lists on hover and follow keyboard navigation. ([#58021](https://github.com/anomalyco/opencode/pull/58021))
- **Desktop:** Add video previews with zoom controls. ([#57924](https://github.com/anomalyco/opencode/pull/57924))
- **Desktop:** Add generated project avatars and an experimental avatar-style switcher. ([#57871](https://github.com/anomalyco/opencode/pull/57871), [#57930](https://github.com/anomalyco/opencode/pull/57930))
- **Desktop:** Add recently closed side tabs to the new-tab view. ([#57863](https://github.com/anomalyco/opencode/pull/57863))
- **Desktop:** Add a searchable prompt history picker. ([#57716](https://github.com/anomalyco/opencode/pull/57716))
- **Desktop:** Find settings from the command palette. ([#57651](https://github.com/anomalyco/opencode/pull/57651))
- **Desktop:** Group queued and steered messages, and group consecutive user messages under one metadata line. ([#57561](https://github.com/anomalyco/opencode/pull/57561), [#57552](https://github.com/anomalyco/opencode/pull/57552))
- **Desktop:** Improve file-tree and folder-picker performance. ([#57573](https://github.com/anomalyco/opencode/pull/57573), [#57557](https://github.com/anomalyco/opencode/pull/57557))
- **Desktop:** Keep branch search results visible while new results load. ([#57531](https://github.com/anomalyco/opencode/pull/57531))
- **Desktop:** Add a session-details menu to the session header. ([#57528](https://github.com/anomalyco/opencode/pull/57528))
- **Desktop:** Show a subagent's model, status, and elapsed time in its composer area. ([#57473](https://github.com/anomalyco/opencode/pull/57473))
- **Desktop:** Let you delete sessions from tab menus and rename the current session with Ctrl+R. ([#57453](https://github.com/anomalyco/opencode/pull/57453), [#57423](https://github.com/anomalyco/opencode/pull/57423))
- **Desktop:** Restore session summary and project menu actions. ([#57781](https://github.com/anomalyco/opencode/pull/57781))
- **Desktop:** Add text-rendering controls to the debug bar. ([#57326](https://github.com/anomalyco/opencode/pull/57326))
- **Desktop:** Show elapsed time for background work. ([#57218](https://github.com/anomalyco/opencode/pull/57218))
- **Desktop:** Improve streamed Markdown rendering reliability and performance. ([#57016](https://github.com/anomalyco/opencode/pull/57016))
- **Desktop:** Split the side pane and add a draggable bottom pane with tabs. ([#56960](https://github.com/anomalyco/opencode/pull/56960))
- **Desktop:** Open multiple file tabs at once and open side-panel content in tabs. ([#57182](https://github.com/anomalyco/opencode/pull/57182), [#57094](https://github.com/anomalyco/opencode/pull/57094))
- **Desktop:** Move running work to the background when you steer a session. ([#57142](https://github.com/anomalyco/opencode/pull/57142))
- **Desktop:** Let the timeline scroll beneath the composer while keeping its content visible. ([#57141](https://github.com/anomalyco/opencode/pull/57141))
- **Desktop:** Quote selected timeline or terminal text into the composer. ([#55664](https://github.com/anomalyco/opencode/pull/55664), [#58420](https://github.com/anomalyco/opencode/pull/58420))
- **Desktop:** Add a Reduce motion appearance setting. ([#57103](https://github.com/anomalyco/opencode/pull/57103))
- **Desktop:** Attach the new-session location picker below the composer. ([#56952](https://github.com/anomalyco/opencode/pull/56952))
- **Desktop:** Open image previews directly from message and composer thumbnails. ([#56896](https://github.com/anomalyco/opencode/pull/56896))
- **Desktop:** Add a sidebar toggle for vertical tabs. ([#55646](https://github.com/anomalyco/opencode/pull/55646))
- **Desktop:** Add ⌘1–9 and ⇧⌘[ / ⇧⌘] shortcuts for side-panel tabs. ([#57301](https://github.com/anomalyco/opencode/pull/57301))
- **Desktop:** Let you choose a new directory or worktree when a session location is unavailable. ([#56087](https://github.com/anomalyco/opencode/pull/56087))
- **Desktop:** Refresh the Manage models, MCP, and fork dialogs with compact searchable lists. ([#56029](https://github.com/anomalyco/opencode/pull/56029), [#56028](https://github.com/anomalyco/opencode/pull/56028))
- **Desktop:** Install future Windows desktop updates in about a second. ([#55933](https://github.com/anomalyco/opencode/pull/55933))
- **Desktop:** Show individual Code Mode tool calls in Execute rows. ([#55649](https://github.com/anomalyco/opencode/pull/55649))
- **Desktop:** Add a Commentary timeline category and display setting. ([#55248](https://github.com/anomalyco/opencode/pull/55248))
- **Desktop:** Support `@` links to other sessions in messages. ([#57480](https://github.com/anomalyco/opencode/pull/57480))
- **Desktop:** Polish spacing, alignment, borders, and typography across the session header, titlebar, composer, file tree, browser pane, timeline, and Settings. ([#58195](https://github.com/anomalyco/opencode/pull/58195), [#57776](https://github.com/anomalyco/opencode/pull/57776), [#57570](https://github.com/anomalyco/opencode/pull/57570), [#57782](https://github.com/anomalyco/opencode/pull/57782), [#57336](https://github.com/anomalyco/opencode/pull/57336), [#57363](https://github.com/anomalyco/opencode/pull/57363), [#58100](https://github.com/anomalyco/opencode/pull/58100), [#58979](https://github.com/anomalyco/opencode/pull/58979))

#### Fixes

- **Core:** Wait for plugins to finish reloading before each session step and tool call. ([#51133](https://github.com/anomalyco/opencode/pull/51133), [@kernel-oops](https://github.com/kernel-oops), [@Tarquinen](https://github.com/Tarquinen))
- **Core:** Size session compaction from the provider's reported token count to preserve usable context. ([#59441](https://github.com/anomalyco/opencode/pull/59441))
- **Core:** Skip unavailable models.dev API entrypoints instead of failing model catalog updates. ([#59475](https://github.com/anomalyco/opencode/pull/59475))
- **Core:** Return a server error with a reference ID when the server cannot encode a response. ([#59459](https://github.com/anomalyco/opencode/pull/59459))
- **Core:** Avoid warming a session while its model request is running. ([#59325](https://github.com/anomalyco/opencode/pull/59325))
- **Core:** Preserve legacy MCP `codemode` settings during migration. ([#59126](https://github.com/anomalyco/opencode/pull/59126), [@tneemo](https://github.com/tneemo))
- **Core:** Use the correct Vertex AI endpoints for the `eu` and `us` multi-regions. ([#59335](https://github.com/anomalyco/opencode/pull/59335))
- **Core:** Accept Databricks hosts that include `http://` or `https://`. ([#59334](https://github.com/anomalyco/opencode/pull/59334))
- **Core:** Keep files intact when patch edits move a file onto itself. ([#59197](https://github.com/anomalyco/opencode/pull/59197))
- **Core:** Preserve literal `$0` and `$ARGUMENTS` text in custom command input. ([#59198](https://github.com/anomalyco/opencode/pull/59198))
- **Core:** Close project locations concurrently during shutdown. ([#59326](https://github.com/anomalyco/opencode/pull/59326))
- **Core:** Treat equivalent directory paths, including trailing slashes, as one location. ([#59327](https://github.com/anomalyco/opencode/pull/59327))
- **Core:** Send valid tool schemas to Kimi for tuple, default, and keyword-like arguments. ([#59207](https://github.com/anomalyco/opencode/pull/59207))
- **Core:** Expose Code Mode MCP tools directly when the `execute` permission is denied. ([#59315](https://github.com/anomalyco/opencode/pull/59315))
- **Core:** Coordinate OAuth credential refreshes across locations and processes. ([#54023](https://github.com/anomalyco/opencode/pull/54023))
- **Core:** List and search remote Git branches correctly without bare remote names. ([#58597](https://github.com/anomalyco/opencode/pull/58597))
- **Core:** Detect AVIF, HEIC/HEIF, QuickTime, and M4A attachments correctly. ([#58480](https://github.com/anomalyco/opencode/pull/58480), [#58886](https://github.com/anomalyco/opencode/pull/58886), [#58887](https://github.com/anomalyco/opencode/pull/58887))
- **Core:** Reduce memory retained by long-running tool calls and unchanged hooked model requests. ([#58448](https://github.com/anomalyco/opencode/pull/58448), [#58449](https://github.com/anomalyco/opencode/pull/58449))
- **Core:** Load session diffs without reading every message, improving performance for large sessions. ([#57686](https://github.com/anomalyco/opencode/pull/57686))
- **Core:** Keep active locations alive when session events use an equivalent directory path. ([#56259](https://github.com/anomalyco/opencode/pull/56259))
- **Core:** Reload compatibility skills only when their own sources change. ([#59086](https://github.com/anomalyco/opencode/pull/59086))
- **Core:** Avoid publishing redundant catalog updates when configuration is unchanged. ([#56267](https://github.com/anomalyco/opencode/pull/56267))
- **Core:** Avoid booting idle or deleted project locations while polling session forms. ([#59083](https://github.com/anomalyco/opencode/pull/59083))
- **Core:** Wait for plugins before returning agent and provider lists, preventing incomplete catalogs. ([#59082](https://github.com/anomalyco/opencode/pull/59082))
- **Core:** Manage sessions and instruction entries after their project directory is deleted. ([#58997](https://github.com/anomalyco/opencode/pull/58997))
- **Core:** Start fuzzy file search only on first use, reducing project startup work. ([#58959](https://github.com/anomalyco/opencode/pull/58959))
- **Core:** Exit after 10 seconds when shutdown hangs and report pending work. ([#58817](https://github.com/anomalyco/opencode/pull/58817))
- **Core:** Keep the models catalog fresh without redownloading it when unchanged. ([#58813](https://github.com/anomalyco/opencode/pull/58813))
- **Core:** Send xAI Responses `top_k` settings and stop sending unsupported penalties. ([#58868](https://github.com/anomalyco/opencode/pull/58868))
- **Core:** Honor shared parallel tool-call and service-tier settings for Groq. ([#58871](https://github.com/anomalyco/opencode/pull/58871))
- **Core:** Retry throttled requests instead of misreporting them as context overflows. ([#58866](https://github.com/anomalyco/opencode/pull/58866))
- **Core:** Preserve streamed text and reasoning that arrive after an OpenAI Chat finish reason. ([#58851](https://github.com/anomalyco/opencode/pull/58851))
- **Core:** Classify AWS REST JSON errors consistently regardless of where the error type appears. ([#58770](https://github.com/anomalyco/opencode/pull/58770))
- **Core:** Validate large base64 attachments without slowdowns or hangs. ([#58811](https://github.com/anomalyco/opencode/pull/58811))
- **Core:** Retry Bedrock throttling errors as rate limits instead of context overflows. ([#58759](https://github.com/anomalyco/opencode/pull/58759), [@Irish-Joseph](https://github.com/Irish-Joseph))
- **Core:** Keep working MCP tools available when a server returns malformed ones. ([#58350](https://github.com/anomalyco/opencode/pull/58350))
- **Core:** Match absolute instruction-file globs across directories. ([#58749](https://github.com/anomalyco/opencode/pull/58749), [@heimoshuiyu](https://github.com/heimoshuiyu))
- **Core:** Use configured provider regions in Bedrock endpoint URLs. ([#58538](https://github.com/anomalyco/opencode/pull/58538))
- **Core:** Handle unknown OpenAI Chat finish reasons without failing the response. ([#58608](https://github.com/anomalyco/opencode/pull/58608))
- **Core:** Avoid unnecessary Azure model updates when endpoint transforms make no change. ([#58600](https://github.com/anomalyco/opencode/pull/58600))
- **Core:** Prefer JPEG for opaque browser screenshots, reducing attachment size. ([#56990](https://github.com/anomalyco/opencode/pull/56990))
- **Core:** Detect generated image types from their bytes when compatible hosts omit the format. ([#58475](https://github.com/anomalyco/opencode/pull/58475))
- **Core:** Keep project services alive while sessions run long tools or wait for input, with a 24-hour inactivity cap. ([#57274](https://github.com/anomalyco/opencode/pull/57274))
- **Core:** Prevent unrelated configuration changes and compatibility-skill update bursts from repeatedly reloading skills. ([#56260](https://github.com/anomalyco/opencode/pull/56260))
- **Terminal:** Return `opencode run --format json` server connection errors as JSON. ([#59366](https://github.com/anomalyco/opencode/pull/59366), [@andreivince](https://github.com/andreivince))
- **Terminal:** Preserve pasted prompt text when copying it back out. ([#59209](https://github.com/anomalyco/opencode/pull/59209))
- **Terminal:** Reliably update the background service on Windows when its files are briefly locked. ([#59105](https://github.com/anomalyco/opencode/pull/59105))
- **Terminal:** Keep the background service state directory out of tool shells and identify processes blocking its port. ([#58815](https://github.com/anomalyco/opencode/pull/58815))
- **Terminal:** Refresh Git branch details after switching branches. ([#58982](https://github.com/anomalyco/opencode/pull/58982))
- **Terminal:** Keep the TUI running when a plugin slot or route renders bare text. ([#58144](https://github.com/anomalyco/opencode/pull/58144), [@anmol0b](https://github.com/anmol0b), [@Tarquinen](https://github.com/Tarquinen))
- **Terminal:** Accept `--server` and `--standalone` anywhere in supported CLI commands. ([#58505](https://github.com/anomalyco/opencode/pull/58505))
- **Terminal:** Release closed and background session transcripts to prevent memory growth. ([#58434](https://github.com/anomalyco/opencode/pull/58434), [#57025](https://github.com/anomalyco/opencode/pull/57025))
- **Terminal:** Connect remote access tunnels through HTTP proxies. ([#58464](https://github.com/anomalyco/opencode/pull/58464))
- **Terminal:** Keep development builds on a separate server, database, and port from released builds. ([#58331](https://github.com/anomalyco/opencode/pull/58331))
- **Desktop:** Prevent duplicate tab shortcuts and remove uninstalled plugin commands from Shortcuts. ([#59499](https://github.com/anomalyco/opencode/pull/59499))
- **Desktop:** Keep todo items from shrinking in the todo panel. ([#59430](https://github.com/anomalyco/opencode/pull/59430))
- **Desktop:** Keep question-dock answers and controls positioned correctly when changing questions. ([#59383](https://github.com/anomalyco/opencode/pull/59383))
- **Desktop:** Keep the @ menu open while it searches. ([#59425](https://github.com/anomalyco/opencode/pull/59425))
- **Desktop:** Finish quitting after Cmd+Q on macOS. ([#59144](https://github.com/anomalyco/opencode/pull/59144), [@anmol0b](https://github.com/anmol0b))
- **Desktop:** Toggle MCP servers for the current session location from Settings. ([#59132](https://github.com/anomalyco/opencode/pull/59132))
- **Desktop:** Deliver steering messages when an earlier move was missed. ([#58984](https://github.com/anomalyco/opencode/pull/58984))
- **Desktop:** Keep session and command-palette search results stable while searching. ([#58908](https://github.com/anomalyco/opencode/pull/58908), [#57479](https://github.com/anomalyco/opencode/pull/57479))
- **Desktop:** Restrict Search projects to the project list. ([#58978](https://github.com/anomalyco/opencode/pull/58978))
- **Desktop:** Let custom Close tab shortcuts close terminal and browser tabs. ([#58945](https://github.com/anomalyco/opencode/pull/58945))
- **Desktop:** Prevent live status rows from jumping or leaving gaps above the composer. ([#58691](https://github.com/anomalyco/opencode/pull/58691), [#58697](https://github.com/anomalyco/opencode/pull/58697))
- **Desktop:** Keep browser tabs still behind open dialogs. ([#58958](https://github.com/anomalyco/opencode/pull/58958))
- **Desktop:** Keep side-panel content and browser pages visible while the sidebar or panel moves. ([#58202](https://github.com/anomalyco/opencode/pull/58202), [#58185](https://github.com/anomalyco/opencode/pull/58185))
- **Desktop:** Render session diffs reliably.
- **Desktop:** Keep keyboard focus in terminals, side panels, dialogs, and the composer when appropriate. ([#57980](https://github.com/anomalyco/opencode/pull/57980), [#57297](https://github.com/anomalyco/opencode/pull/57297), [#56273](https://github.com/anomalyco/opencode/pull/56273))
- **Desktop:** Preserve empty browser and side-panel tabs instead of closing them automatically. ([#58440](https://github.com/anomalyco/opencode/pull/58440))
- **Desktop:** Reduce desktop memory use by releasing closed transcripts, discarded tool-result images, retained UI batches, and aborted timeline work. ([#57025](https://github.com/anomalyco/opencode/pull/57025), [#58434](https://github.com/anomalyco/opencode/pull/58434), [#58427](https://github.com/anomalyco/opencode/pull/58427), [#58560](https://github.com/anomalyco/opencode/pull/58560), [#58447](https://github.com/anomalyco/opencode/pull/58447), [#58439](https://github.com/anomalyco/opencode/pull/58439), [#58432](https://github.com/anomalyco/opencode/pull/58432))
- **Desktop:** Restore horizontal scrolling and sticky change badges in the file tree. ([#58117](https://github.com/anomalyco/opencode/pull/58117))
- **Desktop:** Show live Thinking for reasoning-only turns. ([#58299](https://github.com/anomalyco/opencode/pull/58299))
- **Desktop:** Stop loading older history after completing the initially visible turn and prioritize the first transcript page. ([#57700](https://github.com/anomalyco/opencode/pull/57700), [#57741](https://github.com/anomalyco/opencode/pull/57741))
- **Desktop:** Keep Home project and session lists reliable during refreshes.
- **Desktop:** Keep deleted sessions from reappearing on Home. ([#55349](https://github.com/anomalyco/opencode/pull/55349))
- **Desktop:** Find sessions immediately in @ mentions, including multi-word titles. ([#57683](https://github.com/anomalyco/opencode/pull/57683))
- **Desktop:** Keep queued messages editable while changes sync with the server. ([#57569](https://github.com/anomalyco/opencode/pull/57569))
- **Desktop:** Open image and video URLs in the browser pane. ([#57562](https://github.com/anomalyco/opencode/pull/57562))
- **Desktop:** Mark submitted generated forms as complete and send each response only once. ([#57537](https://github.com/anomalyco/opencode/pull/57537))
- **Desktop:** Improve file-view performance with reused views, virtualized medium files, and cached diffs. ([#57551](https://github.com/anomalyco/opencode/pull/57551))
- **Desktop:** Group untracked folders into one expandable review row. ([#57527](https://github.com/anomalyco/opencode/pull/57527))
- **Desktop:** Let you paste into the composer from the session view. ([#57545](https://github.com/anomalyco/opencode/pull/57545))
- **Desktop:** Recover failed beta background servers and preserve their required CLI versions. ([#57321](https://github.com/anomalyco/opencode/pull/57321))
- **Desktop:** Keep the running server available while beta updates install. ([#57309](https://github.com/anomalyco/opencode/pull/57309))
- **Desktop:** Make links in user messages, shell output, and Code Mode output clickable. ([#57211](https://github.com/anomalyco/opencode/pull/57211), [#57303](https://github.com/anomalyco/opencode/pull/57303))
- **Desktop:** Make Check for Updates always report its result. ([#57296](https://github.com/anomalyco/opencode/pull/57296))
- **Desktop:** Reopen the last closed side-panel tab with ⇧⌘T and open a browser tab with ⌘T. ([#57269](https://github.com/anomalyco/opencode/pull/57269), [#57156](https://github.com/anomalyco/opencode/pull/57156))
- **Desktop:** Keep OpenCode keyboard shortcuts working in the browser pane. ([#56697](https://github.com/anomalyco/opencode/pull/56697), [#55240](https://github.com/anomalyco/opencode/pull/55240))
- **Desktop:** Preview image attachments supplied by file path. ([#57249](https://github.com/anomalyco/opencode/pull/57249))
- **Desktop:** Apply configured code and UI fonts consistently. ([#57242](https://github.com/anomalyco/opencode/pull/57242))
- **Desktop:** Keep activity and busy indicators steady while switching sessions. ([#57196](https://github.com/anomalyco/opencode/pull/57196))
- **Desktop:** Reserve ⇧⌘W for closing the window so ⌘W does not. ([#57150](https://github.com/anomalyco/opencode/pull/57150))
- **Desktop:** Make image preview transitions resize smoothly without clipping or blocking clicks. ([#56997](https://github.com/anomalyco/opencode/pull/56997), [#57324](https://github.com/anomalyco/opencode/pull/57324))
- **Desktop:** Return focus to the prompt after keyboard model selection.
- **Desktop:** Keep tables visible beneath sticky headers. ([#57050](https://github.com/anomalyco/opencode/pull/57050))
- **Desktop:** Fit provider connection steps without shifting a dialog's top edge. ([#57006](https://github.com/anomalyco/opencode/pull/57006))
- **Desktop:** Give unavailable-server panels clear error styling. ([#57003](https://github.com/anomalyco/opencode/pull/57003))
- **Desktop:** Keep long Execute tool code contained and show successful Code Mode output. ([#56915](https://github.com/anomalyco/opencode/pull/56915))
- **Desktop:** Focus the most useful control when dialogs open, including Cancel in delete confirmations. ([#57453](https://github.com/anomalyco/opencode/pull/57453))
- **Desktop:** Install Windows beta, stable, and nightly builds into separate directories. ([#56904](https://github.com/anomalyco/opencode/pull/56904))
- **Desktop:** Keep session tabs recoverable when their server becomes unreachable. ([#56248](https://github.com/anomalyco/opencode/pull/56248))
- **Desktop:** Keep the composer model's provider and session-model resolution consistent with the TUI. ([#56225](https://github.com/anomalyco/opencode/pull/56225))
- **Desktop:** Reread open files without resetting their scroll position. ([#55899](https://github.com/anomalyco/opencode/pull/55899))
- **Desktop:** Hide agent names when agents are disabled. ([#57525](https://github.com/anomalyco/opencode/pull/57525))
- **Desktop:** Polish sidebar, panel, composer, activity, question-dock, loading, and motion behavior across light and dark themes. ([#57449](https://github.com/anomalyco/opencode/pull/57449), [#58013](https://github.com/anomalyco/opencode/pull/58013), [#58577](https://github.com/anomalyco/opencode/pull/58577), [#57944](https://github.com/anomalyco/opencode/pull/57944), [#58052](https://github.com/anomalyco/opencode/pull/58052), [#58494](https://github.com/anomalyco/opencode/pull/58494), [#58073](https://github.com/anomalyco/opencode/pull/58073), [#58114](https://github.com/anomalyco/opencode/pull/58114))
- **Desktop:** Polish hover states, cursors, tooltips, focus rings, scrollbars, and transitions across desktop controls. ([#57653](https://github.com/anomalyco/opencode/pull/57653), [#57787](https://github.com/anomalyco/opencode/pull/57787), [#57304](https://github.com/anomalyco/opencode/pull/57304), [#58971](https://github.com/anomalyco/opencode/pull/58971), [#57221](https://github.com/anomalyco/opencode/pull/57221), [#57192](https://github.com/anomalyco/opencode/pull/57192), [#58575](https://github.com/anomalyco/opencode/pull/58575), [#58580](https://github.com/anomalyco/opencode/pull/58580))
- **SDK:** Fix generated Promise client input types for TypeScript consumers. ([#58875](https://github.com/anomalyco/opencode/pull/58875))
- **SDK:** Let SDK clients discard inline tool-result file payloads to reduce memory use. ([#59101](https://github.com/anomalyco/opencode/pull/59101))
- **SDK:** Avoid unnecessary catalog refreshes for locations an SDK client has not loaded. ([#55237](https://github.com/anomalyco/opencode/pull/55237), [#59099](https://github.com/anomalyco/opencode/pull/59099))
- **SDK:** Restore running sessions created while an SDK client was disconnected. ([#53012](https://github.com/anomalyco/opencode/pull/53012))
- **SDK:** Release omitted tool-image payloads from memory instead of retaining their base64 data. ([#58560](https://github.com/anomalyco/opencode/pull/58560))

Released in [v2.2.0](https://github.com/anomalyco/opencode/releases/tag/v2.2.0)

## 2026-10-22

### [Upgraded the bundled Bun runtime to 1.4.4](https://opencode.ai/changelog/v1.19.4)

2026-10-22 · v1.19.4

Upgraded the bundled Bun runtime to 1.4.4, which includes [security fixes](https://bun.com/blog/bun-v1.4.4#security) for Brotli, TLS, HTTP/1.1, HTTP/2, HTTP/3, WebSocket, and `fetch`, and updates root certificates to NSS 3.131.1.

Released in [v1.19.4](https://github.com/anomalyco/opencode/releases/tag/v1.19.4)

## 2026-10-16

### [OpenCode 1 now stays on the 1.x release line](https://opencode.ai/changelog/v1.19.3)

2026-10-16 · v1.19.3, v1.19.2

OpenCode 1 now stays on the 1.x release line: update checks use only the npm `opencode-ai` latest version, so 1.x installs are never offered a 2.x build as a regular update.

#### Improvements

- **Core:** Configure model reasoning options to generate reasoning variants, replacing catalog variants while preserving your configured variant overrides.

#### Fixes

- **Core:** Upgrading to OpenCode 2 remains a separate, explicit choice through the 2.0 offer in `/update` or `opencode upgrade --major`.
- **Core:** Fix upgrades for installs managed by yarn.
- **Core:** Skip 1.x updates for Homebrew Core installs, which now track OpenCode 2, and check tap and Chocolatey availability before offering an update.
- **Core:** The install script refuses to install 2.x versions.

Released in [v1.19.3](https://github.com/anomalyco/opencode/releases/tag/v1.19.3), [v1.19.2](https://github.com/anomalyco/opencode/releases/tag/v1.19.2)

## 2026-10-15

### [Session sharing has been discontinued](https://opencode.ai/changelog/v1.19.1)

2026-10-15 · v1.19.1

Session sharing has been discontinued. Existing share links and session-sharing commands are no longer available, and importing sessions from share URLs is unsupported.

Released in [v1.19.1](https://github.com/anomalyco/opencode/releases/tag/v1.19.1)

1 / 20 · [Older updates](https://opencode.ai/changelog?page=2)

---

If something here is wrong or missing, open an issue at https://github.com/anomalyco/opencode/issues.