opencode Updates & Release Notes

Core

Improvements

Added a code mode MCP adapter for running confined orchestration scripts against connected MCP tools.

Hid the execute tool unless code mode is enabled.

Bugfixes

Fixed paginated MCP tool catalogs losing tool metadata and output schema validation.

Preserved low reasoning effort for OpenRouter small-model variants instead of disabling it.

Fixed GitHub Copilot model routing to honor each model's advertised chat or responses endpoint.

Fixed session lists to match equivalent instance directories reliably.

Fixed Cerebras reasoning replay so earlier assistant reasoning is sent back in the provider-supported field.

TUI

Bugfixes

Fixed spinner registration so loading indicators keep rendering across TUI surfaces.

Desktop

Improvements

Show draft server status in the title bar.

Unified the provider connect flow across the app.

Improved the integrated terminal experience. (@arvsrn)

Added reopening for closed tabs and background tab opening. (@usrnk1)

Improved model search in picker dialogs. (@arvsrn)

Added recently closed projects to Home. (@usrnk1)

Made tab navigation respond on mouse down in the new layout.

Overhauled the v2 review panel. (@arvsrn)

Refined the session tab preview popover. (@usrnk1)

Bugfixes

Fixed new sessions from Home using the wrong project.

Fixed first-launch onboarding so it only appears when appropriate.

Improved large review pane performance.

Fixed timeline loads that started on assistant replies by backfilling the missing user turn.

Restored typing in the composer while the window is unfocused.

Fixed dropdown search behavior. (@arvsrn)

Kept the v2 review pane mounted when switching session tabs.

Kept the terminal mounted when switching session tabs in a workspace.

Fixed session tab busy indicators to stay scoped to the correct server.

Fixed child-session navigation and lineage resolution during tab transitions.

Kept desktop window tabs after closing and reopening the app.

Thank you to 3 community contributors:

@usrnk1:

feat(desktop): refine session tab preview popover (#34792)

feat(desktop): add recently closed projects to home (#34926)

feat(desktop): papercut fixes (#34939)

feat(desktop): reopen closed tabs and background tab open (#35010)

@arvsrn:

feat(app): v2 review panel overhaul (#31882)

feat(app): align subagent UI with v2 (#34931)

feat(app): improvements to model search (#34954)

feat(app): dropdown search fix (#34961)

feat(app): terminal improvements (#34747)

@StarpTech:

feat(tui): add debug info dialog with copy to clipboard (#35004)

Original source

Core

Bugfixes

Force reasoning mode for OpenAI-compatible reasoning models so reasoning settings apply reliably on custom deployments

Stop replaying stale GitHub Copilot response item IDs, avoiding follow-up request failures

Desktop

Bugfixes

Let question prompts be minimized and restored without dismissing them (@arvsrn)

Clean up stale empty and old draft store files to reduce desktop state buildup

Keep pending question requests open while reviewing them, instead of dismissing them accidentally (@eXamadeus)

Keep session page failures scoped to the affected tab instead of breaking the whole app

Improvements

Improve markdown and message layout alignment in the v2 session UI (@arvsrn)

Add a searchable v2 model picker and model management flow in the composer (@arvsrn)

Show a hover preview for session tabs with the project, path, branch, and server (@usrnk1)

Streamline WSL server setup with clearer distro checks and install flows (@arvsrn)

Keep desktop tabs scoped to each window so windows restore their own tab sets

Thank you to 3 community contributors:

@arvsrn:

feat(app): v2 wsl ui (#34233)

feat(app): composer improvements (#34720)

feat(app): more v2 ui alignment (#34465)

feat(app): minor fixes (#34748)

@eXamadeus:

fix(app): question UI fixes and UX improvements (#34116)

@usrnk1:

feat(desktop): session tab hover preview popover (#34678)

feat(desktop): improve markdown heading spacing in session timeline (#34738)

Original source

Core

Bugfixes

Enable adaptive thinking for Claude Sonnet 5.

Prefer MCP content responses over structured output when both are present.

Reconnect MCP servers after OAuth even if the server was disabled. (@MaxAnderson95)

Request MCP refresh-token scope during OAuth.

Show MCP OAuth completion errors instead of a generic failure.

Refresh cached remote skills.

Preserve skill resource paths.

Pick better default small models across providers.

Scope MCP auth status to each server URL.

TUI

Improvements

Add a yolo mode to auto-approve permissions.

Pass ServerAuth headers through external served TUI connections. (@OpeOginni)

Desktop

Improvements

Autocomplete MCP resources in the composer.

Add workspace controls when starting a new session.

Show stored token and cost totals in the session context. (@OpeOginni)

Bugfixes

Autocomplete configured references in prompts.

Restore the prompt cursor when the composer regains focus.

Remember the last active desktop URL across restarts.

Preserve the selected model when promoting a session. (@usrnk1)

Keep session pages in sync during concurrent events.

Support normal auth input prompts in the desktop connect-provider dialog. (@OpeOginni)

Prevent hidden terminal tabs from hanging or resizing incorrectly.

Re-enable auto-accept in session settings.

Keep session tabs scoped to the correct server.

Remember the selected home project and server.

SDK

Improvements

Add a live event subscription stream.

Add SDK access to active sessions.

Restore session runtime operations such as event streaming, interrupts, and message lookup.

Add paged durable session history.

Add session permission request create and fetch endpoints.

Bugfixes

Preserve V2Event names in SSE streams.

Wake embedded session execution after new prompts.

Improve V2 runtime tool results and avoid duplicate model switch events.

Resolve MIME types for prompt attachments sent by URI.

Thank you to 11 community contributors:

@usrnk1:

feat(app): refine session UI styling (#33860)

fix(desktop): preserve selected model during session promotion (#34466)

fix(desktop): context menu button / tab intermittent issue (#34420)

feat(desktop): add hover background to session title and single-click edit (#34589)

feat(app): hide separators around active tabs (#34591)

feat(desktop): polish inline session title editing (#34607)

feat(desktop): make error view draggable (#34627)

feat(desktop): polish tooltips and session search (#34632)

@arvsrn:

feat(app): updates to design system (#34066)

feat(app): update home screen alignment + markdown styles (#34172)

feat(app): minor visual updates (#34205)

feat(app): new debug bar (#34237)

feat(app): sticky session list header (#34220)

feat(app): show loader on session hover (#34224)

feat(app): new timeline header (#34192)

feat(app): improve projects sidebar reactivity (#34391)

feat(app): update message part ui to v2 (#34394)

feat(app): align slash popover to v2 tokens (#34286)

@ariane-emory:

docs(providers): document blacklist and whitelist model filtering (#33792)

@Slickstef11:

docs: route enterprise contact links (#34080)

@affanali2k3:

fix(app): slow tooltip display for models (#30745)

@OpeOginni:

fix(desktop): recognize normal auth metadata input prompts in connect provider dialog (#33024)

feat(desktop): Display stored totals for Tokens and Cost in Desktop Session Context (#28887)

feat(tui): integrate ServerAuth headers into transport configuration for external served TUI thread (#29876)

@BenGu3:

fix(tui): register prompt.skills keybinds (#34180)

@neriousy:

fix(app): disable add project when given server is offline (#34294)

fix(app): disable empty server chevron (#34292)

@MaxAnderson95:

fix(mcp): reconnect after OAuth even when server is disabled

@StarpTech:

fix(console): cancel upstream provider requests (#34467)

@runvip:

fix(docs): fix Russian translation for index.mdx (#34001)

Original source

Core

Improvements

Add session snapshots and revert controls so you can roll a session back to an earlier message, including file changes.

Bugfixes

Always print the MCP OAuth URL so manual sign-in still works when opening the browser flow.

Desktop

Improvements

Add Chrome-style tab cycle shortcuts with mod+1 through mod+9.

Add draggable tabs. (@arvsrn)

Improve the empty home state when you have no sessions. (@arvsrn)

Restyle the jump-to-latest button in the v2 session view. (@arvsrn)

Improve the redesigned desktop layout, including better titlebar tabs and archived sessions. (@arvsrn)

Bugfixes

Keep prompt drafts attached to the correct project server.

Restore consistent titlebar tab sizing and layout.

Restore home actions when session lists are empty or still loading.

Keep todo docks in place when switching between sessions.

Automatically close tabs for sessions that no longer exist.

Keep provider dialogs, prompt rollbacks, and async attachments tied to the session where they started.

Clear late session notifications after you open the session.

Remove the session loading stripe.

Thank you to 2 community contributors:

@isaachuangGMICLOUD:

docs: add GMI Cloud provider entry to providers directory (#32914)

@arvsrn:

feat(app): draggable tabs (#31364)

feat(app): ui improvements (#32438)

fix(app): update all v1 new-session icons (#32017)

feat(app): no sesssions empty state (#33315)

feat(app): restyle v2 jump-to-latest button (#33809)

Original source

Core

Improvements

Added MCP server instructions to session context. (@Arcadi4)

Added Opencode-managed provider integration support.

Added MCP resource template listing.

Added MCP resource read tools.

Added a --mini CLI mode.

Bugfixes

Hid MCP resource template tools when access is denied.

Prevented MCP resource tools from colliding when servers expose the same keys.

Emitted skill base directories as filesystem paths instead of file:// URLs. (@shyuan)

Restored legacy MCP tool names for existing integrations.

Restored v1 account config loading.

Bound MCP OAuth callbacks to IPv4 loopback for better local auth reliability. (@he-yufeng)

Preserved structured error details in surfaced failures.

Fixed snapshots from subdirectories so they only include the right files and paths.

Fixed ACP resource text sourcing on Windows and other cross-platform path cases.

Preserved file source paths in ACP resource text.

Waited for plugins before loading reference-backed config and system context.

Hid gpt-5.5-pro when using Codex OAuth.

TUI

Improvements

Added a configurable keybind to open the diff viewer.

Added diff viewer support for comparing against the main branch.

Bugfixes

Prevented worker rejections from breaking the TUI process.

Desktop

Improvements

Kept draft prompt state per tab.

Added a new session progress indicator. (@arvsrn)

Added mobile bottom navigation.

Added collapsible server sections. (@arvsrn)

Added server-aware session routes to keep same-session navigation separated across servers.

Bugfixes

Always applied safe-area insets.

Made session navigation more stable and faster.

Routed new sessions through tabs correctly.

Cleared viewed session notifications reliably.

Scoped drafts created from Home to the right server and project.

Throttled directory tree loading.

Persisted drafts and prompt state more reliably.

Improved iOS PWA shell behavior.

Refined the mobile session layout.

Added the server button dropdown. (@arvsrn)

Restored review line comments.

Improved the mobile home layout.

SDK

Improvements

Exposed provider integration IDs in the SDK.

Extensions

Improvements

Added namespaced plugin hook APIs.

Added the V2 plugin API for Effect and Promise plugins.

Thank you to 6 community contributors:

@remorses:
feat(llm): add video and audio media support to Gemini protocol (#31889)

@arvsrn:
feat(app): collapsible servers (#33384)
fix(app): add server button dropdown (#33358)
feat(app): new session progress indicator (#32662)
feat(app): update all components to use v2 tokens (#33598)

@ReStranger:
fix: Skip bun version check for nix version (#33166)

@he-yufeng:
fix(mcp): bind oauth callback to IPv4 loopback (#30022)

@shyuan:
fix(skill): emit base directory as filesystem path, not file:// URL (#33580)

@Arcadi4:
feat(mcp): append server instructions to context (#32490)

Original source

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:

@Grantmartin2002:

fix(core): fix command docs in customize-opencode skill (#32718)

@Robin1987China:

fix(opencode): use toLowerCase for Devstral model detection (#33109)

@kimnamu:

fix(experimental llm pkg): forward topK to Converse via additionalModelRequestFields (#33030)

@imranshaiedi-byte:

feat(opencode): expose High/Max thinking variants for GLM-5.2 (#32446)

Original source

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 the server's error text instead of a generic failure.

MCP OAuth error pages now escape provider error text correctly.

Desktop

Improvements

Added a Home tab toggle so you can quickly switch between Home and your last tab.

The new desktop file and folder picker is faster and easier to navigate in the v2 layout.

Thank you to 3 community contributors:

@Nomadcxx:

fix(mcp): enable progress timeout resets (#32477)

@keefetang:

fix(provider): pass apiKey to createUnified for Cloudflare AI Gateway (#32052)

@jquense:

fix(opencode): sanitize OpenAI MCP tool schemas (#32489)

Original source

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 availability when integrations change, and credential update and remove calls accept location.

Original source

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

Improvements

• Brought v2 visibility settings to the web app
• Refreshed the oc-2 color theme (@arvsrn)

Bugfixes

• Made the terminal resize gutter easier to grab
• Faded overflowing titlebar tabs instead of clipping them abruptly

Thank you to 5 community contributors:

@verdverm:

• fix(tui): double file content injection in commands using $ARGUMENTS (#31245)

@arvsrn:

• feat(app): update oc-2 colors (#31071)

@Slickstef11:

• docs: update North Mini Code privacy terms (#32096)

@santigc6:

• feat(opencode): add external browser OAuth for snowflake cortex provider (#31700)

@OpeOginni:

• fix(opencode): add authorization header to fetch requests in RunCommand (#29877)

Original source

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)

Content-filtered model responses now surface as visible errors instead of failing silently. (@kkdawkins)

Fixed MCP auth and debug requests dropping configured headers.

Snapshot creation now reuses source Git objects to avoid long re-hashing delays on huge repos. (@dmtrKovalenko)

Fixed MCP catalog request timeouts not applying when listing prompts, resources, or tools.

Thank you to 5 community contributors:

@dmtrKovalenko:
fix(snapshot): reuse source git objects to avoid re-hashing huge repos (#31798)

@tobwen:
fix(tui): preserve exit epilogue during scoped shutdown (#31805)

@kkdawkins:
fix(opencode): surface content-filter finish reason as visible error (#31745)

@Killusions:
fix(gemini): prevent gemini incompatibility with some tools (#31877)

@Grantmartin2002:
feat(opencode): support cwd on local MCP servers (#30676)

Original source

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 identity (#31709)

Original source

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 your prompt and project selection together until you start the session.

Bugfixes

Restored macOS auto-updates.

Original source