Highlights

• Background Subagents by Default: Subagents now return immediately, continue in the background, and report back whenever they become idle. You can keep working in the parent session while multiple subagents run concurrently. (#63382)
• Quieter Transcripts by Default: The TUI now summarizes each run of tool calls and thoughts into one collapsible activity row, so the answer is easier to follow. To see every step again, set Verbosity to medium or high in settings, or set session.verbosity in your TUI config; an existing setting is kept. (#63207)
• Jump to an Earlier Prompt: In the desktop app, open Jump to message from the command palette or press Cmd+Alt+G (Ctrl+Alt+G on Windows and Linux) to search prompts across the current session and jump directly to one. (#63585)

Core

Improvements

• Subagents now always run in the background, return their session ID immediately, and report results to their parent whenever they become idle. (#63382)
• Added experimental support for MCP events, behind the mcp_events flag. (#63254, #63261, #63269)
• Shell commands now survive server handoffs and keep their output when interrupted.
• Added experimental support for moving a shell command to the background when its timeout expires, behind the shell_timeout_background flag. With the flag on, an explicit timeout on a background command stops it. (#63024, #63703)
• Local Windows shell commands now run through the process daemon.
• Added support for freeform tool input on compatible models.
• Added LM Studio decision-model support.
• Agents are now told when their session is a fork. Thanks @hasta84. (#63235)
• Tool output truncation now keeps the beginning of the output and preserves a usable preview if the full output cannot be saved.
• Tail reads no longer load the entire file into memory.
• Providers can present a client certificate for gateways that require mutual TLS. Set settings.tls with cert, key and an optional passphrase on the provider; values accept {file:} and {env:} like apiKey. (#61832)
• When a subagent goes idle while its own background work is still running, its report to the parent now says it is still running, so the parent waits for the final report instead of treating the partial answer as done. (#63675)
• Code Mode gets simpler structured results from file and skill tools: write and edit return their confirmation as a string, patch returns an empty result, and skill returns the skill's directory and content. (#63616, #63635, #63618, #63623)

Bug fixes

• Fixed case-only file renames in patches on case-insensitive filesystems.
• Fixed stale thinking being retained after Claude Agent prompts or tools change.
• Fixed directly driven child sessions not resuming after a restart.
• Fixed plugin replacement stopping when cleanup of an earlier plugin fails.
• Fixed MCP OAuth refreshes and localhost redirects when a server rewrites 127.0.0.1.
• Fixed saved API keys being omitted from local-model discovery.
• Local model discovery (Ollama, LM Studio, vLLM) waits up to 15 seconds per request instead of 1, so remote or tunnelled endpoints list their models, and a slow endpoint no longer delays other endpoints or config reloads. (#63700)
• In Code Mode, calling a namespace as if it were a tool now suggests up to three real tools under it. (#63697)
• Fixed retryable provider streams losing completed work when interrupted.
• Fixed GitHub Copilot requests using the wrong endpoint before models finish loading.
• Fixed exhausted request rate limits being treated as terminal. Thanks @Kyle-j-bush. (#59816)
• Fixed LM Studio models with a null context length and accepted decision-type models. Thanks @tomzhu1024. (#56214)

TUI

Improvements

• Transcript verbosity now defaults to low, which summarizes each run of tools and thoughts into one activity row. A session.verbosity you already set is kept. (#63207)
• Session IDs found in messages can now be opened directly.
• Activity tabs are clickable and open the correct view.
• Shell mode has its own prompt color under the new designs.

Bug fixes

• Restored pasted text when undo brings back its placeholder.
• Restored the live draft after browsing prompt history.
• Fixed copying a paste from within the prompt selection.
• Preserved the Mini composer caret when closing the command palette.
• Prevented image bytes from being retained in transcript storage when image previews are disabled.
• Fixed paste-chip contrast across light and dark themes.
• Fixed plugin-provided themes updating live.
• Session lists now open at the top rather than at the current session.
• Mini scrollback now shows the subagent card instead of obsolete launch instructions.

Desktop

Improvements

• Added Jump to message to the command palette with Cmd+Alt+G / Ctrl+Alt+G, including prompts not yet loaded in the timeline. Thanks @usrnk1. (#63585)
• Added the experimental Recent sessions sidebar, with cross-server recency, local pins, reordering, and standard session-row actions.
• Recent sessions are limited to the last seven days and 30 rows, and can be hidden or muted.
• Added an experimental customizable sessions sidebar.
• Mermaid diagrams can now be maximized for zooming and panning. (#59250)
• Added Alt+Enter to place a follow-up first in the queue and Mod+Enter to steer the next queued prompt.
• Holding the modifier key now shows tab shortcut numbers.
• Each server’s terminal shell can be selected from its menu.
• Added a free-limit panel in place of the composer when applicable.
• Session IDs are easier to find and copy.

Bug fixes

• Recent sessions now keep stable recency ordering through list reloads, renames, and completed runs.
• Fixed browser panes not retrying after server plugins finish loading.
• Fixed mention suggestions being recreated while typing.
• Fixed SSH prompts failing to advance or close after connection.
• Fixed pasted provider-auth redirect URLs being rejected.
• Restored message footers in the New timeline.
• Fixed links whose labels contain inline code.
• Fixed the desktop main process freezing while probing the login-shell environment.
• Fixed the drag region after changing layout direction.
• Fixed vertical-tab previews snapping to the wrong tab.
• Fixed the file-tree sidebar opening animation.
• Fixed pairing QR-code contrast in light themes. Thanks @ssskay. (#63220)
• Fixed activity-tab navigation and click handling. Thanks @OpeOginni. (#60168)

SDK

Improvements

• Event subscriptions can now receive experimental.mcp.event events from MCP event subscriptions.
• Model capability schemas now advertise supported freeform tool-input formats.
• Session throughput is now measured from the first streamed token.
• Session creation documentation now clarifies the parentID field.

Extensions

Improvements

• Promise-based tools can cooperatively stop through ToolContext.signal.
• Added the experimental session.fork hook.
• Promise plugin cleanup failures no longer prevent subsequent plugin replacements.
• @opencode/plugin/effect now exports Tool, so an execute.before hook can reject a call with Tool.Error without importing @opencode/schema/tool. (#63698)

opencode-pty 0.5.2 (protocol 8) from packages/process-daemon, published to npm as @opencode/pty@0.5.2.

Highlights

• GitHub Copilot Auto: Pick Auto in the model picker when your Copilot account has an Auto pool, and Copilot's router chooses the model for each session at the Auto discount. If routing fails, OpenCode falls back to the account's default chat model. (#62997)
• Side Panel Tab Shortcuts: Right-click a side panel tab and choose Close tabs to the right. ⌘W now closes side panel tabs wherever focus is, ⌥⌘W or Ctrl+Alt+W always closes the session tab, and ⌘⇧T reopens the last closed tab of either kind where it was. (#62922)
• Mark Sessions Read or Unread: Open the menu on a tab, Home row, project row or inbox card and choose Mark as unread to keep its dot until you next visit. (#62889)

Breaking changes

@opencode/ai: ImageResponse.image is removed

This affects code that imports @opencode/ai directly. Read response.images[0] instead of response.image. (#63011)

SDK: fewer endpoints wait for plugins to load

On a Location that is still loading plugins, agent.list returns the agents loaded so far, and integration.list, usage.limits, vcs.init, rpc.call and artifact.* no longer wait up to 5 seconds. Entries and actions that a plugin provides appear when it finishes loading, so refresh on the matching *.updated event. Model, provider, generate.*, voice.* and websearch.query endpoints still wait. (#62796, #63040)

Core

Improvements

• MCP Logins Stay Signed In: Remote MCP servers that rotate refresh tokens no longer sign you out when several clients refresh at once or the token endpoint fails for a moment. (#62827, #63012)
• read accepts a negative offset to read from the end of a file, such as -50 for the last 50 lines. An offset past the end returns the last lines and the file's line count instead of failing. (#62147)
• When read can't find a file, it suggests close names: different capitalization, another extension, a small typo, or the matching path inside the project. (#62147)
• Shell results end with Exit code: N. Commands killed by a signal show the signal name, and timeouts say how long they waited and suggest a larger timeout. (#62141)
• Prompt cache warming times its pings from the model's cache.ttl by default (interval: "auto"), or every 4 minutes without a TTL. Models whose cache outlasts the warming duration are no longer pinged. (#62831)
• When MCP servers connect, disconnect or change tools, Code Mode sends the model a short list of what changed instead of the whole tool catalog. (#62176)

Bug fixes

• GitHub Copilot session costs use the amount Copilot charged instead of the catalog estimate, and content-filter errors name the filter that blocked the response. (#62034)
• GitHub Copilot picks up a new API endpoint after a plan change on its next model refresh, so you no longer have to sign in again. (#62171)
• Remote MCP servers that rotate refresh tokens no longer log you out when the TUI, desktop app, background service or several projects refresh the same login at once. (#62827)
• A temporary failure while refreshing an MCP OAuth token keeps your login for the next try instead of marking the server needs_auth. (#63012)
• MCP tool calls no longer fail when the server's result doesn't match the tool's own output schema, so completed actions aren't reported as failed. (#61254)
• MCP prompts stay available when refreshing a server's prompt list fails. (#62266)
• With background_compaction on, a background summary no longer stops a running Claude Agent session mid tool call. (#63025)
• After opencode auth logout on a .well-known integration, its remote providers and policies stop applying until you log back in. (#62760)
• OpenCode Console workspace policies still apply when Console's instructions or skills fail to load. (#62702)
• Cloudflare AI Gateway providers set up with only gatewayApiKey now send that key. (#62574)
• A v1 model override that sets only some capabilities no longer resets the others, so catalog capabilities like PDF input are kept. (#62573)
• A v1 provider config that sets both api and options.baseURL keeps options.baseURL. (#62570)
• Legacy model references with an inline variant, such as "openai/gpt-5#high", keep the variant. (#62254)
• A fresh install imports saved provider credentials from the legacy auth.json, and skips an invalid one with a warning instead of stopping setup. (#62568)
• Cache warming stops for a session when a ping rebuilds the cache instead of reading it, counts its interval from when a request was sent, and no longer pings during compaction or after the session is deleted. (#62926, #62941, #62972)
• Tokens and cost from session.generate requests, including cache warming pings, count toward the session's totals. (#63006)
• Under zsh, a glob that matches nothing, like rm *.tmp, is passed through as bash does instead of stopping the command. (#62141)
• Truncated shell output that starts mid-line drops the partial first line, so the "showing lines X–Y" notice is exact. (#62141)
• On Windows, multi-line commands no longer lose everything after the first line with PowerShell 7 from the Microsoft Store. (#62522)
• read no longer cuts an emoji in half when it shortens a long line. (#62575)
• Generated session titles no longer include the model's commentary. Thanks @shanebishop1. (#62267)
• Markdown agents whose description starts with a bracketed tag, like [Beta] Reviews code, now load. (#62250)
• Markdown agent and command files that fail to load log a warning with the file path and frontmatter error. (#62464, #62251)
• Markdown agent discovery skips node_modules. (#62571)
• Failed plugin installs from git show git's own error instead of "An unknown git error occurred". (#62261)

TUI

Improvements

• The update and confirm dialogs have buttons you can move between with ←/→ and Tab/Shift+Tab. (#62906)
• The model picker no longer has a Usage action; use /usage instead. (#62927)

Bug fixes

• Session exports are saved in the current working directory instead of the system temp folder. (#62253)
• Typing a child session's exact ID in the open-session menu lists that session. (#62262)
• The TUI follows the terminal's current light or dark mode instead of a cached palette. (#62248)

Desktop

Improvements

• Right-click a side panel tab to Close tabs to the right. ⌘W closes side panel tabs wherever focus is, the new Close session tab command (⌥⌘W or Ctrl+Alt+W) always closes the session tab, and ⌘⇧T reopens the last closed side panel or session tab where it was. (#62922)
• Added Mark as read and Mark as unread to the menus for tabs, Home rows, project rows and inbox cards, and Rename to inbox cards. (#62889)
• The answer you pick in the question dock shows as a raised card. (#62896)
• Inline rename and custom-answer fields no longer show a focus border. (#62919)

Bug fixes

• On Windows and Linux, Ctrl+Shift+R toggles the review panel again instead of reloading the window. (#62567)
• Closing the last side panel tab slides the panel shut. (#62758)
• Selects, menus, tooltips and toasts opened from a dialog are reachable by screen readers. ([#62913](https://github.co...

Highlights

• Shared MCP Connections: Turn on pooling for an MCP server to share one connection across projects with the same setup, so you run fewer processes and start faster. (#61185)
• GUI Plugin Themes and New Slots: GUI plugins can now add color themes, render or add actions to code blocks, and use native settings and menu components. (#61485, #61533, #61527, #61509)
• Mobile Composer Dock: On phones and tablets, composer actions now sit in a touch dock above the keyboard with larger buttons. (#61773)
• Scripted Runs in Worktrees: Run opencode run -w to start the session in a new git worktree, or --worktree=<name> to name it. (#60712)
• Automatically Archived Runs: Add --archived to opencode run to keep scripted and CI sessions out of your inbox and session lists. (#61270)

Core

Improvements

• Added opt-in MCP connection sharing through pool: true. (#61185)
• Added opencode run --archived, which creates the session already archived so scripted and CI runs stay out of the inbox, home, and session lists. Archived sessions are also hidden from the TUI session list and skipped by --continue. (#61270)
• Added opencode run --worktree (-w), which starts the session in a new git worktree. Use --worktree=<name> to choose the worktree name. It cannot be combined with --continue or --session. (#60712)
• Added provider- and model-specific session warming settings, including an interval: "auto" mode based on cache TTL. (#60025, #60969)
• Added the websearch.use policy action and switches for enabling all feature flags with OPENCODE_FLAGS=all or experimental.all_flags. (#61557, #61826)
• Added an experimental bytecode VM for Code Mode. It is off by default; turn it on with experimental.codemode_vm: true or OPENCODE_FLAGS=codemode_vm. (#62358)
• Added support for Microsoft Store installations of PowerShell 7 on Windows. (#61952)
• Added Azure Messages support for Foundry Claude models. (#60934)

Bug fixes

• opencode run now waits for the background shell commands, subagents, and image jobs that its prompt started, then lets the model respond to their results before it exits. While it waits, it prints waiting for N background job(s) (a background_wait event with --format json). There is no time limit: a job that never exits, such as a dev server or file watcher, keeps the run open until you press Ctrl+C or send SIGTERM, so set a timeout on CI jobs. (#60699, #61911)
• Reworked noninteractive opencode run execution so arguments, cancellation, compiled WebSocket upgrades, and service shutdown complete reliably. SIGTERM now cancels the session and its background jobs and exits with code 143. (#61911, #61721, #61518, #61564)
• Serve file reads and media from the server API as sandboxed downloads, and refuse cross-site browser navigations and requests from disallowed origins to /api/*, so a file in your project cannot run scripts on the server's origin. (#62422)
• Webfetch and Code Mode fetch now reject URLs that contain credentials and ignore the #fragment when matching permission rules, and Code Mode fetch checks every redirect against your webfetch rules. (#60502, #61701, #62373)
• Ask for external_directory permission before session_move leaves the current project. (#62204)
• Wait up to 2 seconds for MCP servers that are still connecting before a model call, so tools from servers that connect quickly reach the first prompt and opencode run. Also expand ~ in local MCP working directories, handle legacy stdio servers, and send logo_uri during dynamic registration. (#60490, #61496, #61817, #59031)
• Time out OpenCode Console config requests after 5 seconds, so startup no longer hangs when the Console accepts the connection but never answers. (#62404)
• Retry provider requests while their host is unreachable and recover prematurely ended Cohere streams. (#61880, #61184)
• Keep legacy custom providers whose models set only part of limit, such as only limit.context, instead of dropping the whole provider without an error. Thanks @Tarquinen. (#62240)
• opencode acp now removes a session that a client creates with session/new and closes without prompting, so IDE integrations no longer leave empty sessions behind. (#62189)
• Prevent repeated zsh q flags from freezing shell permission scanning. Thanks @yangguan-xue. (#60791)
• Allow npm upgrade install scripts again. Thanks @renatomoselli. (#51554)

TUI

Improvements

• Added Scroll on send in Settings. Choose Keep (session.submit_scroll: "keep") to retain your reading position after submitting a prompt. (#61460)

Bug fixes

• Allow Ctrl+Z to suspend OpenCode while a form or dialog is open. (#62118)
• Keep focus on an open dialog when a question arrives and contain plugin dialogs that throw during rendering. (#60365, #62110)
• Show an error when Ctrl+V cannot read the clipboard. Thanks @jimmyallinai. (#61094)
• Prevent session titles containing newlines from crashing the TUI. Thanks @vishalShekhar. (#57523)
• Improved message spacing and prevented older history from flashing while scrolling. (#62104, #59236)
• Jump to the first or last message with Home, End, and Ctrl+G in subagent sessions. Thanks @ricky9408. (#60817)
• Keypad Home, End, Page Up, and Page Down now navigate the transcript like the main keys in terminals that use the kitty keyboard protocol. Thanks @argszero. (#59770)
• opencode mini now uses the agent colors from your config. Thanks @ferdinandyb. (#62067)
• Return to the /mcp list after signing in to an MCP server, with that server still selected. Thanks @Tarquinen. (#62245)
• Allow favoriting models with Ctrl+F in /models when they come from a provider declared in config or an add-on instead of a saved connection. Thanks @Tarquinen. (#62244)

Desktop

Improvements

• Added a mobile composer dock for touch devices, with 44px action targets and predictable multiline input. (#61773)
• Added close-other-tabs and close-tabs-after actions to the tab menu. (#61631)
• Added unread-session grouping in Inbox and failed-run indicators on tabs. (#61691, #62077)
• MCP sign-in now accepts a pasted redirect URL when automatic redirection is unavailable. (#61706)
• Markdown file previews now display frontmatter as a properties list. (#60333)
• The command palette shows a date instead of "Xd ago" for sessions 7 or more days old. Hover the time to see the full date and time. (#62314)
• Prompt history now keeps up to 200 prompts. Past the newest 100, only prompts without attachments are kept. (#62313)

Bug fixes

• Improved prompt submission and timeline behavior during loading, reconnects, retries, scrolling, compaction, and optimistic delivery. (#62025, [#6203...

opencode-pty 0.5.0 (protocol 8) from packages/process-daemon, published to npm as @opencode/pty@0.5.0.

Highlights

• Worktree and Shell Mode Shortcuts: 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)
• 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)
• 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)

Core

Improvements

• compaction.buffer accepts a percentage of the model's context window, such as "20%", in addition to a token count. (#60647)
• When read misses because a folder is missing, the error names that folder and the nearest one that exists. (#60688)
• When edit can't find oldString, the error shows the file's closest lines, or says the change is already there. (#60689)
• 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)

Bug fixes

• MCP servers that send stdio messages larger than 10 MiB no longer get disconnected, and large messages are read much faster. (#60694)
• Idle locations no longer restart their MCP servers right after shutting down. (#60668)
• Compaction now caps its prompt at the model's context window when the input limit is larger. (#60660)
• LiteLLM context window errors now trigger compaction instead of stopping the session. (#60692)
• 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)

TUI

Bug fixes

• The connect menu no longer lists MCP servers, which are managed in their own place. (#60675)

Desktop

Improvements

• Added keyboard shortcuts to choose a worktree and its base branch, shown in tooltips, and a shortcut to toggle shell mode. The worktree path can be selected to copy the full directory. (#60713)
• Hold ⌘ or Ctrl in the quote popup to send a quote and its comment directly. (#60640)
• Added flat input surfaces and a compact input size. (#60598)

Bug fixes

• The connect menu no longer lists MCP servers. (#60675)
• Added the missing top inset to the search field in the recently closed menu. (#60652)

Highlights

• Persistent Desktop Terminals: 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)
• 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)
• 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)
• 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)

Core

Improvements

• Added opt-in artifacts with artifact_create, artifact_read, artifact_update, and artifact_delete, including a built-in local static-file provider. (#60351)
• 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)
• Raised OpenCode Go limits for DeepSeek V4.1 Flash. (#60625)

Bug fixes

• Allowed user, project, and remote configuration to override Console-supplied provider names, limits, variants, settings, and headers. (#60597)
• Kept local OpenCode service requests out of environment-configured proxies. (#60441)
• Replaced Claude Code’s misleading /login instruction with claude auth login. Thanks @Tarquinen. (#60592)

TUI

Bug fixes

• Preserved prompt cursor styles applied by plugins when themes or unrelated prompt state change. (#60599)
• Added missing right padding to edit and patch diffs. (#60614)
• Extended the vertical session-tab activity pulse across the full tab width. (#60338)

Desktop

Improvements

• Moved terminals to persistent session PTYs shared with the TUI and other windows, with restored scrollback, server-side renaming, and restart persistence. (#60346)
• Added guided Claude Agent installation, sign-in, connection checking, and recovery from Needs sign-in. (#60603)
• Added Choose base branch to the command palette and shortcuts, bound to ⌘⌥. or Ctrl+Alt+.. (#60579)
• Simplified the session location popover and made long paths easier to read. (#60492)

Bug fixes

• Kept terminal tab clicks and rename fields attached to the intended tab. (#60645)
• Listed matching commands before sessions in command-palette search. (#60616)
• Restored copying user messages from an open actions menu. (#60576)
• Reduced repeated work and allocations while streaming Markdown, especially in long sessions. (#60549, #60562, #60577)

SDK

Improvements

• Added client.experimental.artifacts.providers, list, create, get, update, delete, and view. (#60351)
• Extended client.experimental.persistentPty.update to rename terminals or clear a user title, and exposed userTitle plus persistent-pty.updated events. (#60329)

Extensions

Improvements

• Added ctx.experimental.artifact.transform(...) to Effect and Promise plugins for registering artifact providers, capabilities, prompts, and the default provider. (#60351)

Highlights

• Use Claude Code in OpenCode: Install Claude Code, run claude auth login, then select Claude Agent in /connect to use your Claude Code login and models. (#58782)
• Faster Long Sessions in Desktop: Streaming replies and long conversations now do much less rendering work. (#60489, #60521, #60513, #60481)
• Desktop Stability Fixes: Fixes side-panel tabs, repeated "Session not found" toasts, and Open file over HTTP. (#60430, #60436, #60459, #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. (#60385)

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. (#60315)

Core

Improvements

• Added the built-in Claude Agent provider. Install Claude Code, run claude auth login, and select Claude Agent in /connect; OPENCODE_CLAUDE_PATH can override the Claude executable. Thanks @Tarquinen. (#58782)
• Added Code Mode JavaScript checks to experimental schedules, including statically authorized tool calls, persistent state, and custom wake messages. (#60140)
• Added separate managed-policy actions for connecting to integrations and using integrations, MCP servers, skills, and plugins. (#60315)

Bug fixes

• Preserved plugin-provided model variants and delayed dynamic provider fallback until external SDK hooks have run. (#60097, #60380)
• Preserved permission reasons and feedback in MCP failures, and made Code Mode failures match direct tool-call failures. (#60102, #60109)
• Fixed invalid Code Mode schedule checks so creation fails immediately and existing invalid checks pause without repeated execution. (#60349)
• Removed a session’s persistent terminals when the session is deleted. (#60322)
• Kept nested tool progress from replacing the parent execute call rows. (#60480)

TUI

Improvements

• 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)
• Added a distinct marker for the selected composer suggestion in the new designs. (#60393)

Bug fixes

• Fixed PHP syntax highlighting for code blocks without an opening <?php tag. (#60359)
• Preserved # in file-search paths unless it introduces a valid line range. (#60336)
• Kept the configured default cursor style after config reloads. (#60302)
• Matched the search cursor to the highlighted row when a selection dialog has no query. (#60310)

Desktop

Improvements

• Added a Desktop spellcheck toggle under Settings → General and system-language dictionary selection on Windows and Linux. (#59129)
• Added PageUp and PageDown timeline paging from the composer without moving the draft cursor or focus. (#59426)
• Added independently configurable question notifications and sounds under Settings → Notifications → Questions. Thanks @YuriNek0. (#60358)
• Added separate project and worktree actions to the new-session control. (#60486)
• Added one-click version copying in Settings → About. (#52356)
• Grouped added projects in workspace settings. (#60221)
• Made question-answer text selectable. (#60372)
• Adapted the session header to narrow timeline widths. (#59512)

Bug fixes

• Side-panel tabs close again and New tab launchers respond to clicks, fixing a 2.2.2 regression. (#60430, #60436)
• Open file in the side panel works again in the web app over HTTP. (#60462)
• Kept question options and submit controls reachable on mobile. (#60335)
• Preserved simultaneous request notifications and inbox scroll position when opening sessions. (#60378, #60356)
• Fixed consecutive dropped files so every file mention is inserted into the composer. (#60463)
• Kept the current @ and command-menu selection stable while results update under a stationary pointer. (#59434, #60368)
• Fixed ⌘W side-panel closing and focus restoration when no closable tabs remain. (#59002, #60435)
• Kept the mobile session drawer open while a session loads. (#59427)
• Restored maximized windows on their saved display and retained renderer permissions across shared-session windows. (#60482, #60458)
• Fixed timeline growth, zoom-end scrolling, highlighting, and DOM-observer performance issues in long sessions. (#60489, #60481, #60488, #60513, #60521)
• Kept models with unknown release dates visible. Thanks @joe-ieta. (#60496)
• Fixed reasoning-capability detection for models that expose reasoning through variants or compatibility metadata. (#60457)
• Evicted deleted sessions after a 404 instead of retrying or showing repeated errors. (#60459)
• Fixed the macOS application icon and added the required folder-access description to the app bundle. (#60020, #60503)

SDK

Improvements

• Preserved partial LLMResponse output on AIError.partial when generation, object generation, or a tool loop fails. (#60477)
• Unified Effect and Promise tool declarations around tool(...), with optional output schemas and executable or declaration-only tools. (#60407)
• Added typed OpenRouter debug, models, plugins, provider, and user options to the Responses route. (#60044)
• Added withMediaRefs, mediaHashFromUri, and MediaRequestOptions to the Promise client for experimental stored-media references. (#60116)

Bug fixes

• Matched the Promise AI client more closely to the Effect API and accepted typed tools in loops. (#60465, #60390)
• Kept tools whose execute handler can throw available to the AI client. (#60431)
• Continued polling queued media generations when providers return unknown intermediate statuses. ([#59988](https://github.com/ano...

Highlights

• Image Generation by Default: 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)
• 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)
• 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)

Core

Improvements

• Enabled experimental_image_generate by default when an image-capable provider is connected. (#60258)
• Recorded the start time of each session’s latest execution.

Bug fixes

• Rejected persistent terminal requests whose working directory no longer exists.
• Preserved media when sessions are forked or imported.
• Associated image-generation notices with the correct background job.

TUI

Bug fixes

• Preserved captured attachments and their original source paths. Thanks @OpeOginni. (#60222)
• Prevented middle-truncated paths from overflowing at very narrow terminal widths.
• Improved Go usage-limit messages with the reset time and account page link.
• Correctly typed and displayed Go and ChatGPT usage-limit errors.

Desktop

Improvements

• Made the Git branch on the new-session screen open the current project’s worktree picker directly. (#60263)
• Unified timeline quotes, terminal quotes, and browser annotations around one optional-comment workflow. (#60164)
• Restored classic question cards by default and added Settings → Experimental → New question UI for the redesigned keyboard-oriented dock. (#59723)
• Added a side-panel tab menu and kept close buttons visible when tabs overflow.
• Moved user-message actions into a compact menu.
• Redesigned the active todo pill to show the current task and concurrent work more clearly.
• Added consistent styling for searchable dialogs and composer pills.

Bug fixes

• Stopped queued prompts from dropping frames as their content grows.
• Counted queued quotes and browser annotations as attachments.
• Reported failures to persist composer attachments through the normal error UI.
• Made Markdown fragment links scroll to the referenced heading.
• Kept each tab’s timeline state when switching directories.
• Ordered the inbox’s Working shelf by execution start time.
• Fixed side-panel launchers and automatic closing when the final tab is removed.
• Focused the matching navigation arrow while reviewing changes.
• Preserved pending model labels only when a queued prompt actually changes models.
• Added reset details, an account link, and a composer tray for Go usage limits.

SDK

Improvements

• Added if and until inputs for client.experimental.schedule.create, plus schedule check results and output fields. (#60137)
• Exposed SessionInfo.time.busy for the latest execution’s start time.
• Added optional source metadata to prompt file attachments.

Extensions

Improvements

• Added optional title and subtitle fields to composer notes, source-relative quote positioning, and focus options for composer integrations. (#60164)

Bug fixes

• Corrected visible flowchart edges connected through Merman subgraphs.

Highlights

• Keep Working Toward a Goal: 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)
• 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, #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)
• New Default Model Picker: Search favorites, recent models, providers, and variants from the redesigned model picker, which is now the default in Desktop. (#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. (#59977)
• 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. (#59506)
• 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. (#59765)

Core

Improvements

• Add /goal <objective> with pause, resume, and clear controls, plus automatic progress review until the objective is met. (#59437)
• Add opt-in scheduled prompts through /schedule, agent tools, and experimental.schedules. (#59401, #59457)
• Add the opt-in image_generate tool for background image creation and editing, with automatic or configured model selection. (#59939, #60096)
• Offer GPT Image 2 after Codex sign-in and add MiniMax and Meta Muse image generation support. (#60085, #59929, #60081)
• Add Responses API support for OpenRouter, DigitalOcean, and Venice, including freeform tools. (#59991, #59963)
• Improve snapshot performance by coalescing captures and avoiding repeated ignore-file work. (#59419)

Bug fixes

• Preserve more context headroom when fitting tool output into the context window. (#59934)
• Retry provider throttling correctly instead of reporting it as context overflow. (#59649)
• Send image-edit references and image sizes in the formats expected by OpenRouter, Google, and Vercel Grok. (#60067, #59927)
• Keep credential metadata and prompt-cache settings out of model settings and variants. (#60057, #59500)
• Keep Git snapshots working in repositories that use a split index. (#59417)
• Expose Console web search only when the workspace enables it. (#59592)
• Improve Code Mode diagnostics for parse errors, stalled awaits, and promise-like search results. (#59834, #59749, #59981)

TUI

Improvements

• Show /goal status below the prompt and provide a dialog for pausing, resuming, or clearing it. (#59437)

Bug fixes

• Show execution failures that occur before the first model step. (#60079)
• Keep the activity spinner visible while a continued subagent runs. (#59950)
• Send pasted image and PDF paths correctly when connected to a local server. (#59833)
• Improve spacing in an empty /usage dialog. Thanks @Tarquinen. (#59918)

Desktop

Improvements

• Add /reload to reload configuration without restarting. (#59887)
• Make the redesigned searchable model picker the default, with dedicated Favorites and Recent sections and keyboard-accessible provider controls. (#59997)
• Show live output and a Stop action when you select a background shell from the activity pill. (#59496)
• Show /goal state and actions in a composer pill. (#59437)
• Redesign the integrations dialog and always include OpenCode free models in the model picker. (#59976, #60047)
• Add project, worktree, open-in-app, and terminal actions to the session location menu. (#59607)
• Refine project and worktree selection, command search, prompt-history focus, composer model labels, and artifact preview controls. (#59397, #59604, #59626, #59735, #59657)
• Highlight quoted timeline content while you write its first comment. (#59286)
• Keep draft attachment bytes local when using experimental media URIs. (#59104)

Bug fixes

• Follow each plugin server’s configured endpoint when connecting to its event stream. (#60087)
• Treat the reachable scroll boundary as the end when Desktop zoom is active. (#60034)
• Prevent shell text from showing through copy buttons and avoid restyling the transcript when closing a side panel. (#59901, #59878)
• Keep rendering malformed tool metadata instead of crashing the timeline. (#59736)
• Make dropdowns open immediately and keep the new-session location shortcut working after tooltip interactions. (#59268, #59680)
• Remove edge halos from macOS application icons. (#59900)

SDK

Improvements

• Add client.experimental.schedule.{create,list,get,pause,resume,delete} for managing scheduled prompts. (#59457)
• Group experimental generated-client methods under client.experimental; previous locations remain as deprecated aliases until the next minor release. (#59072)
• Expose compaction through the Promise AI client. (#59987)
• Add freeform tool support and Responses routes for OpenRouter, DigitalOcean, and Venice. (#59963, #59991)

Extensions

Improvements

• Add the experimental experimental.idle Session hook so plugins can continue work before a session goes idle. (#59437)
• Let Code Mode extension globals return Effects and declare required services. (#59948)
• Add custom composer-pill popovers for GUI plugins. (#59437)