OpenCode

Core Bugfixes Honor configured agent step limits by forcing a final text response instead of failing mid-run. Fix Devstral model detection when provider IDs use different casing. ( @Robin1987China ) Pass configured custom headers to Copilot model requests. Improvements Add high and max thinking variants for GLM-5.2 across supported providers. ( @imranshaiedi-byte ) Stop wrapping follow-up user messages in a steering reminder so prompt caching stays effective. TUI Bugfixes Only show the background subagent shortcut when the server supports it. Thank you to 4 community contributors: @Grantmartin...

Core Improvements Session timelines load much faster and avoid flicker or scroll jumps. Bugfixes OpenAI-compatible providers now accept MCP tool schemas that previously failed validation. ( @jquense ) Cloudflare AI Gateway now receives the configured API key correctly. ( @keefetang ) MCP tools without declared schema properties now work with providers that expect object properties. Long-running MCP tools now keep their timeout alive when they report progress. ( @Nomadcxx ) The MCP OAuth callback server now shuts down once authorization finishes or is cancelled. MCP tool failures now surface th...

Core Bugfixes Plugin client requests now reuse the active server instead of assuming the default local port. ACP shell tool calls now show the command and working directory from the start. Plugin-provided shell environment variables now apply to PTY sessions. Improvements MCP servers can now receive the current workspace as a client root. TUI Bugfixes MCP debug now uses the SDK's latest protocol version. Desktop Bugfixes The new session route now stays scoped to its own draft server, so prompts and state target the right workspace. SDK Improvements SDK clients now refresh model and provider av...

Core Improvements Added external browser OAuth for the Snowflake Cortex provider ( @santigc6 ) Improved project copy management and move-session flows in v2 Bugfixes Recovered expired MCP sessions instead of leaving MCP tools disconnected Cleared closed MCP clients so stale MCP connections do not linger Returned structured MCP tool output in a readable form Fixed duplicate renderable IDs that could break TUI rendering Fixed commands using $ARGUMENTS so file contents are not injected twice ( @verdverm ) TUI Bugfixes Added auth headers to RunCommand fetch requests ( @OpeOginni ) Desktop Improvem...

Core Bugfixes Improved MCP server compatibility by declaring OpenCode's supported client capabilities.

Core Improvements Added cwd support for local MCP servers so they can start from a workspace-relative directory. ( @Grantmartin2002 ) Added connector-based authentication flows and support for stored provider credentials. Added v2 API endpoints to create and fetch sessions, list session questions, and resolve the active location. File reads now return raw content with the correct content type for API and SDK clients. MCP server log notifications are now surfaced in opencode logs. Bugfixes Fixed Gemini tool schemas that used multi-type fields so compatible tools keep working. ( @Killusions ) Co...

Core Bugfixes Recover from expired remote config auth by prompting you to log in again instead of failing to load config ( @Ayushlm10 ) Let subagents use their own configured permissions again Desktop Bugfixes Restore Linux launcher and icon identity so pinned apps keep opening correctly ( @neriousy ) Restore the device attachment picker ( @rexdotsh ) Thank you to 3 community contributors: @Ayushlm10 : fix: recover from expired enterprise auth on remote config load ( #31661 ) @rexdotsh : fix(app): restore device attachment picker ( #31707 ) @neriousy : fix(desktop): restore linux launcher iden...

Fixed issue with 1.17.2 desktop crashing

Core Improvements References can include usage descriptions for agents, show up in the new docs, and be hidden from @ autocomplete when needed. Bugfixes Deprecated reference config entries continue to load under the newer references config key. MCP prompt and resource requests now respect configured server timeouts. Anthropic fallback responses are handled correctly again. MCP servers that fail during client setup now fail cleanly instead of leaving a broken connection behind. Desktop Improvements The new desktop session flow now has a dedicated /new-session route with draft tabs that keep you...

fix(github): enforce existing git author identity ( #30507 )

Image assets for PR #29948 .

fix: stats dockerfile

Unify declared instance HTTP API endpoints under typed middleware routing, including event streaming and PTY WebSocket connect handling.\n\nPreserve PTY connect compatibility by checking missing PTYs before parsing optional cursor and ticket query fields, with regression coverage.

Desktop Bugfixes Restored the legacy production desktop flows for opening projects and starting sessions.

Core Improvements Added a diff viewer in the TUI for reviewing changes. Collapsed single-child directories in the diff viewer file tree. Added shell mode to the run prompt. Replaced subagent tabs with an on-demand picker in run . Plugin file load errors no longer break the rest of plugin loading. Anthropic API-key models now use the native runtime. The v2 HTTP API now exposes structured public error schemas. Bugfixes Zed editor context now only activates inside Zed terminals. The v2 HTTP API now exposes catalog errors. The v2 HTTP API now exposes request errors. The v2 OpenAPI spec now preserv...

Core Improvements Preview the native OpenAI runtime path behind an experimental flag Add --replay and --replay-limit to show recent history when resuming interactive runs Bugfixes Fix plugin tools using ask so tool calls complete correctly Reduce missed /event updates caused by a subscription race Sort the v2 session list by most recently updated TUI Improvements Refresh the prompt layout after pasting content Bugfixes Keep file references scoped to the current workspace Preserve pasted prompt content when copying Collapse very long tool output lines to keep the layout readable Use a higher-co...

Core Bugfixes Fixed project-scoped bus events so file watcher and update notifications reach the right instance. Fixed custom LSP servers not sending refresh events after they initialize. Hid background subagent task instructions unless experimental background mode is enabled. TUI Improvements Made Markdown H1 headings easier to distinguish. Thank you to 1 community contributor: @necropheus : docs: update README.es.md ( #27739 )

Core Bugfixes Reduced wasted work when reading very large files after output truncation. TUI Bugfixes Fixed async commands losing the active instance context, which could break agent generation and GitHub-driven runs.

Core Improvements Reduced unnecessary prompting around shell, task, and todo flows. Bugfixes Fixed sync events not reaching project-scoped subscribers in injected instances. TUI Improvements Newly pinned sessions now stay at the end of the pinned list instead of jumping to the top. Bugfixes Fixed opencode run --agent resolving project-local agents. Thank you to 1 community contributor: @gigamonster256 : feat(nix): add opencode-electron derivation ( #16163 )

Core Improvements Added an Effect-based core event system for more complete event delivery across sessions and integrations. Bugfixes Ignored invalid exports in custom tool modules instead of failing tool loading. Ignored project instruction lookup errors so sessions keep loading when project instruction discovery fails. Fixed versioned event projector lookups so event replay uses the right handlers. Desktop Improvements Auto-hide the menu bar on Linux and Windows. ( @shi-gg ) Bugfixes Fixed archived sessions being reprocessed when their archive state did not change. SDK Bugfixes Restored miss...

Core Bugfixes Kept HTTP event streams open after the initial connect event so subscribers continue receiving instance updates. Returned proper busy errors when a session is already running prompt or shell work. Let invalid small_model config values fall back cleanly instead of breaking small-model selection. Improved missing-model errors with suggestions across CLI and typed callers. TUI Improvements Restored markdown rendering for session output by default. SDK Improvements Added instance.directory and instance.workspace query support to the v2 model and provider calls.

Core Improvements Added the v2 model and provider listing API. Added DigitalOcean OAuth and Inference Router support. ( @Spherrrical ) Create a global opencode.jsonc automatically when no config exists. Enable customize-opencode by default with a linked full schema. Autocomplete configured @mentions in prompts. Parse fenced Markdown code blocks in patch diffs by default. Bugfixes Fix keymap fallback priority and make TUI config errors clearer. Restore model suggestions for unloaded providers and missing models. Preserve layered permission rule order in config merges. ( @asuffield ) Preserve at...

Core Improvements Preserve original image attachments instead of resizing them before sending them to the model

Core Bugfixes Restored prompt editing keybindings in the TUI textarea, including aliases like esc and enter Model changes now persist reliably across session activity HTTP API schema validation errors now return a readable 400 response body Improvements Scout can now materialize configured reference repositories up front so they are ready to search Large image attachments are now auto-resized before sending, with configurable size limits TUI File and directory paths now render relative to the session directory when possible

Core Improvements Added a built-in customize-opencode skill so opencode config edits are less likely to break startup. Bugfixes Fixed numeric HTTP API query parameters in the generated OpenAPI spec and SDK for session and file endpoints. Fixed boolean HTTP API query handling so SDK types and runtime validation stay aligned. Tolerated legacy stored numeric values in sessions, diffs, and retry events instead of failing to load old data. Fixed old sessions with negative token counts causing message loads and Desktop startup to fail. Fixed MCP tool discovery when a server publishes broken outputSc...

Core Bugfixes Keep provider and config API responses working when auth loaders add non-JSON options to providers. Include tool image attachments in ACP updates and session replays. ( @SteffenDE ) Thank you to 1 community contributor: @SteffenDE : fix(acp): include tool image attachments in updates ( #25128 )

Core Bugfixes Fixed upgrades failing for existing workspaces when adding the time_used field.

Core Bugfixes Provider configs and API responses now accept models marked as active . Read tool permission rules now match worktree-relative paths, so read allowlists and denylists apply correctly. Workspace-routed HTTP API endpoints no longer reject valid directory and workspace query params. TUI Bugfixes Startup errors now report every failed bootstrap request instead of only the first one. Opening a session no longer crashes when the messages request fails. Desktop Bugfixes Older migrated sessions with missing diff file details load again. Older migrated sessions with missing diff patches l...

Core Bugfixes Restored formatter output handling so formatting still works when formatters write to stdout or stderr. ( @ferdinandyb ) Improvements Warping a session to another workspace can now carry over your uncommitted file changes. TUI Bugfixes Restored custom provider setup in /connect . Desktop Bugfixes Added a macOS Settings menu entry. ( @jessedi0n ) Improvements Moved the desktop app's local server into a separate utility process for more reliable startup and shutdown. Extensions Improvements ACP clients now restore the last model, mode, and effort when loading sessions, and can clos...

Core Bugfixes Canceling a task now also cancels child subtask sessions. Improvements Improved v2 session rendering with cleaner tool states, better compaction summaries, and more accurate timing. Warp a session into another workspace or back to the local project. Desktop Bugfixes Run the desktop migration on startup so existing installs transition correctly after the desktop packaging move. Stabilized the Windows titlebar when changing zoom levels.

Core Bugfixes Embedded UI requests now work with arbitrary connect-src origins under the default CSP. Desktop Bugfixes Desktop now trusts system CA certificates for HTTPS connections.

Desktop Bugfixes Respect HTTP_PROXY and related proxy environment variables in the desktop app. Return null instead of failing when the desktop app cannot read a stored value.

Core Bugfixes Preserve diff patch boundaries so session diffs keep rendering correctly when file contents include diff --git text.

Core Improvements Add PTY connection tickets so authenticated terminal websockets work more reliably across clients. Add v2 session failure events so clients can detect and show failed runs. Improve shell command handling for Bash, PowerShell, and cmd sessions. Bugfixes Return structured error bodies from the effect HTTP server instead of empty failures. Reload server auth environment variables correctly for each new HTTP listener. Stop worktree creation from hanging while bootstrap commands run. Fix Azure Anthropic model resolution when using the Anthropic SDK. Fix the web UI proxy so public ...

Core Fix issue with custom agents in plugins not loading Thank you to 3 community contributors: @jerome-benoit : fix(nix): remove stale packages/shared filter ( #24930 ) @OpeOginni : docs: CLI docs for current commands and flags ( #25399 ) @HyeokjaeLee : fix(instance): restore InstanceBootstrap init parameter for non-Effec… ( #25449 )

Core Azure setup now prompts for the resource name when needed and saves it with the API key. Task child sessions now preserve parent external_dir and deny permissions. ( @remorses ) Invalid remote MCP URLs now fail with a clear error instead of breaking setup. Desktop Restoring saved messages no longer crashes the app when a model is missing. Thank you to 1 community contributor: @remorses : fix(opencode): preserve external_dir and deny parent permissions in task child sessions ( #23290 )