OpenCode

v1.17.18

July 9, 2026

• •Prevent crashes and bad pricing data when GitHub Copilot returns models with a zero billing batch size.
• •Add a model-specific system prompt for Meta Muse Spark.

v1.17.17

July 9, 2026

• •Improved Meta model handling for reasoning variants and provider requests.
• •Fixed clipped descenders in model selector labels.
• •Added a dismissible tabs intro popup and refreshed the help entry point.
• •Updated sub-agent task rows to match the v2 session design more closely.
• •Restyled the revert dock in v2 sessions for clearer restore actions.
• •Added a v2 free-model selector with faster access to more providers.

v1.17.16

July 9, 2026

• •Exposed reasoning effort variants for Grok models.
• •Improved xAI prompt cache routing and PDF file support in Responses models.
• •Added an Open containing folder action for projects on the home screen.
• •Added a composer add menu for files, commands, context, and shell mode without losing draft text.
• •Added a provider setup tip on new sessions when no external providers are connected.
• •Remember review panel mode and selected file per session.
• •Added inline file browser tabs for opening and previewing files from the side panel.
• •Updated desktop translations.
• •Kept the review pane usable on wide screens by reserving its minimum width.
• •Fixed hidden session panes staying mounted and causing side-panel glitches.
• •Routed legacy drafts back to the session page.
• •Loaded full review diffs for large patches when the initial diff is capped.
• •Removed the first-open flash in the command palette.
• •Routed the new session shortcut through tabs in the new layout.
• •Kept session routes inside the correct layout when opening legacy session URLs.

v1.17.15

July 7, 2026

• •Better classify Z.ai context-window overflow errors so oversized requests surface the right failure mode (@fengjikui)
• •Handle unavailable config directories more gracefully when reading config files
• •Restore model details tooltips in the model picker (@arvsrn)
• •Refresh the v2 command palette to better match the rest of the new desktop UI (@arvsrn)
• •Make terminal shortcuts take priority when the terminal is focused
• •Show unread state on tabs with pending questions
• •Keep session tab titles available after reloads while session data is still loading
• •Apply theme changes only after you select them in Settings
• •Fix macOS titlebar appearance mismatches in Sequoia and adjust traffic light placement (@arvsrn)
• •*Thank you to 3 community contributors:**
• •feat(app): align cmd k menu with v2 styles (#35152)
• •feat(app): visual improvements (#35134)
• •feat(app): reintroduce model context tooltip in model selector (#35087)
• •feat(app): change traffic light position, fix sequoia bug (#35081)
• •@StarpTech:

v1.17.14

July 6, 2026

• •Added a code mode MCP adapter for running confined orchestration scripts against connected MCP tools.
• •Hid the execute tool unless code mode is enabled.
• •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.
• •Fixed spinner registration so loading indicators keep rendering across TUI surfaces.
• •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.

v1.17.13

July 1, 2026

• •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
• •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
• •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:**
• •feat(app): v2 wsl ui (#34233)
• •feat(app): composer improvements (#34720)
• •feat(app): more v2 ui alignment (#34465)

v1.17.12

June 30, 2026

• •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.
• •Add a yolo mode to auto-approve permissions.
• •Pass ServerAuth headers through external served TUI connections. (@OpeOginni)
• •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)
• •Autocomplete configured references in prompts.

v1.17.11

June 25, 2026

• •Add session snapshots and revert controls so you can roll a session back to an earlier message, including file changes.
• •Always print the MCP OAuth URL so manual sign-in still works when opening the browser flow.
• •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)
• •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.

v1.17.10

June 24, 2026

• •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.
• •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.

v1.17.9

June 21, 2026

• •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.
• •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.
• •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)
• •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)

v1.17.8

June 17, 2026

• •Session timelines load much faster and avoid flicker or scroll jumps.
• •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.
• •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:**
• •fix(mcp): enable progress timeout resets (#32477)
• •@keefetang:
• •fix(provider): pass apiKey to createUnified for Cloudflare AI Gateway (#32052)
• •fix(opencode): sanitize OpenAI MCP tool schemas (#32489)

v1.17.7

June 14, 2026

• •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.
• •MCP servers can now receive the current workspace as a client root.
• •MCP debug now uses the SDK's latest protocol version.
• •The new session route now stays scoped to its own draft server, so prompts and state target the right workspace.
• •SDK clients now refresh model and provider availability when integrations change, and credential update and remove calls accept location.

v1.17.6

June 13, 2026

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

v1.17.5

June 13, 2026

• •Added external browser OAuth for the Snowflake Cortex provider (@santigc6)
• •Improved project copy management and move-session flows in v2
• •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)
• •Added auth headers to RunCommand fetch requests (@OpeOginni)
• •Brought v2 visibility settings to the web app
• •Refreshed the oc-2 color theme (@arvsrn)
• •Made the terminal resize gutter easier to grab
• •Faded overflowing titlebar tabs instead of clipping them abruptly
• •*Thank you to 5 community contributors:**
• •fix(tui): double file content injection in commands using $ARGUMENTS (#31245)
• •feat(app): update oc-2 colors (#31071)

v1.17.4

June 12, 2026

• •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.
• •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)
• •fix(tui): preserve exit epilogue during scoped shutdown (#31805)
• •@kkdawkins:

v1.17.3

June 10, 2026

Fixed issue with 1.17.2 desktop crashing

v1.17.2

June 10, 2026

• •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
• •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)
• •fix(app): restore device attachment picker (#31707)
• •fix(desktop): restore linux launcher identity (#31709)

v1.17.1

June 10, 2026

• •References can include usage descriptions for agents, show up in the new docs, and be hidden from @ autocomplete when needed.
• •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.
• •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.
• •Restored macOS auto-updates.

v1.17.0

June 10, 2026

• •Faster file search across large projects with the new fff-backed search tools. (@dmtrKovalenko)
• •Added X-Session-Id headers for proxy setups that need sticky routing. (@songchaow)
• •Added Cohere North model support.
• •Added reasoning as an interleaved field option for vLLM providers. (@delta9000)
• •mcp add now works in non-interactive flows.
• •auth logout now supports search when choosing an account.
• •Improved MCP connection status messages so failures are easier to act on.
• •Added Claude Fable reasoning support.
• •MCP tool calls now receive abort signals, so cancellations stop more reliably.
• •MCP catalogs now paginate correctly instead of truncating larger lists.
• •OpenRouter reasoning variants now generate for all models. (@AnthonyMLau)
• •Added MiniMax M3 thinking toggle support.
• •Java multi-module Maven workspaces now resolve JDTLS from the topmost pom.xml. (@areyouok)
• •MCP servers now respect advertised capabilities.
• •Session lists now respect directory filters in workspace setups. (@rexdotsh)

v1.16.2

June 5, 2026

• •Reasoning summaries now only run on providers that support them, avoiding GPT-5 request failures on compatible backends.
• •Edit operations now refuse loose matches that could overwrite the wrong code or replace an existing file by mistake.
• •Fixed Bedrock sessions hanging before a model response starts. (@alblez)
• •Diff viewer now supports next and previous hunk navigation.
• •Terminal themes now refresh after live terminal reloads without stale colors or broken highlighting.
• •Running subagents can now be sent to the background so you can keep working.
• •Sessions now persist system context updates during long-running conversations.
• •Added Snowflake Cortex provider support. (@kameshsampath)
• •Fixed the external editor fallback so attach-mode sessions still open when the original project path is unavailable locally. (@pcadena-lila)
• •Permission replies now route through the correct session directory.
• •/mo now prefers the models command in slash autocomplete.
• •Fixed crashes from malformed path or diff metadata in permission and session views.
• •Fixed titlebar tab overflow clipping.
• •Fixed overflowed titlebar tabs so scrolling and drag regions behave correctly.
• •Improved tab closing and navigation so the next tab is selected more reliably.

v1.16.0

June 5, 2026

• •Added managed workspace cloning that keeps dirty and untracked files.
• •Added moving sessions between workspaces and directories.
• •Added proper OpenAI model support through AWS Bedrock.
• •Added skill discovery and file-based agent loading.
• •Updated GitHub Copilot usage tracking for token-based billing.
• •Added run --replay for interactive session replay.
• •Improved startup time. (@StarpTech)
• •Added Vue syntax highlighting.
• •Restored full ACP session replay when loading saved sessions. (@imnotlxy)
• •Fixed shell cancellation races.
• •Fixed SAP AI Core OpenAI reasoning variants. (@jerome-benoit)
• •Fixed delegated tasks losing their selected reasoning variant.
• •Fixed OpenAI websocket sessions getting stuck idle.
• •Fixed Windows path normalization in migrated storage.
• •Fixed prompt corruption when pasting near wide characters. (@dauphinYan)

v1.15.13

May 30, 2026

• •Gateway Anthropic Opus 4.7+ adaptive reasoning now keeps summarized thinking instead of returning empty thinking blocks.
• •Sessions can now store custom metadata through the API and SDK. (@shantur)
• •Config now loads from the opened location upward, so directory-specific settings and provider policies apply more predictably.
• •Wrapped inline tool rows now stay aligned, and failed inline tools can expand their error details in place.
• •*Thank you to 1 community contributor:**
• •feat(core): add session metadata support (#23068)

v1.15.12

May 28, 2026

## Core ### Improvements - ACP integrations can now send prompts, slash commands, and usage updates through acp-next - Added WebSocket transport for OpenAI responses on supported channels (set OPENCODE_EXPERIMENTAL_WEBSOCKETS=true) ### Bugfixes - Enabled adaptive reasoning controls for Anthropic Opus 4.7+ models - Allowed colons in passwords (@neriousy) - Sped up warm acp-next model and config switches - Improved first-session acp-next startup time - Kept OpenAI WebSocket response timeouts active - Retried failed OpenAI WebSocket streams before falling back - Handled acp-next permission prompts correctly - Used the persisted session directory for existing-session requests - Forwarded remote workspace request bodies correctly - Supported custom base URLs for OpenAI WebSocket responses (@Tarquinen) ## TUI ### Improvements - Added a workspace management dialog ### Bugfixes - Kept session navigation working while prompt modes are open - Restored the thinking spinner - Surfaced subagent retry status - Fixed opening editors from non-Git project paths (@OpeOginni) ## Desktop ### Improvements - Added a setting to switch tab layouts ### Bugfixes - Improved the home empty state and fixed V2 font usage - Fixed tab close buttons not showing reliably Thank you to 5 community contributors: - @OpeOginni: - fix(tui): handle non-git project paths when opening editor (#29180) - @gotjoshua: - docs: fix ts error in math examples (#18244) - @Tarquinen: - fix(openai): support websocket custom base URLs (#29636) - @24KaratAu: - docs: fix grammar in config.mdx (#29683) - @neriousy: - fix(core): allow colons inside passwords (#29576)

v1.15.11

May 27, 2026

## Core ### Improvements - Added headerTimeout config for provider requests, with a 10s default for default OpenAI setups. - Experimental background agents now push updates without polling. - You can now set only modalities.input or modalities.output in config. (@robposch) - Remote-backed projects now resolve a stable project identity. ### Bugfixes - Dynamically added MCP servers now disconnect cleanly when removed. - DigitalOcean inference now uses your OAuth token directly instead of creating a MAK. (@Spherrrical) - Config loading now falls back cleanly when user info is unavailable. - Fixed Google tool calling after the upstream tool ID regression. - Experimental flags can now override the umbrella experimental flag. - Resumed sessions no longer continue orphaned interrupted tools. (@edevil) - OpenAI reasoning summaries now render as separate blocks. - Updated Google Vertex support for reasoning signatures. - The shell tool now advertises your configured timeout to the model. ## TUI ### Improvements - Made the prompt resize with terminal width and added prompt size config. (@bjschafer) ### Bugfixes - Accelerated diff viewer scrolling. - External editors now open from the worktree directory when available. ## Desktop ### Improvements - Refined the Desktop v2 home screen, prompt, status popover, and session controls. ### Bugfixes - Fixed V2 titlebar errors when a session sync cache was deleted. (@Eric-Guo) - Web deployments no longer run desktop health checks. - Duplicate server connections are now merged in the server list. - Stabilized virtualized session timeline interactions. - Fixed the white flash when restoring the desktop window. ## Extensions ### Improvements - Added a dispose hook for plugins. ### Bugfixes - Fixed Codex plugin requests to send the expected session ID header. Thank you to 7 community contributors: - @jerome-benoit: - fix(nix): re-inherit patches in desktop, ad-hoc sign .app on darwin (#27869) - @edevil: - fix(session): exclude orphaned interrupted tools from run-loop continuation (#26178) - @bjschafer: - feat(tui): make prompt size responsive and configurable (#28255) - @robposch: - tweak (config): make modalities input/output fields optional so that u can specify one without both being required (#29268) - @Eric-Guo: - fix(app): handle deleted session sync cache in V2 titlebar (#29328) - @StarpTech: - docs(web): update LSP docs wording (#29435) - docs: add tip to lsp section (#29444) - @Spherrrical: - fix(digitalocean): use OAuth token directly for inference instead of creating MAK (#28897)

v1.15.10

May 23, 2026

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

v1.15.9

May 22, 2026

• •Redesigned the diff viewer with a file tree and refreshed layout.
• •Return to the previous screen when closing the diff viewer.
• •Show clearer errors when a default model is invalid or unavailable.
• •Surface missing PTY session errors instead of failing generically.
• •Improve diff viewer empty states and context handling.
• •Show clearer errors when a skill invocation fails as expected.
• •Show clearer errors when an installation upgrade fails.
• •Show clearer project not found errors from the HTTP API.
• •Return PTY error bodies from the HTTP API.
• •Enable the diff viewer by default.
• •Return MCP server not found errors from the HTTP API.
• •Let MCP OAuth configs set a callback port and include configured scopes in client metadata. (@sebin)
• •Use working Vertex Anthropic endpoints for us and eu multi-region setups. (@JPFrancoia)
• •Return session busy error bodies from the HTTP API.
• •Preserve native reasoning continuation metadata across turns.

v1.15.7

May 21, 2026

• •Added Grok OAuth sign-in, including device-code login. (@Jaaneek)
• •V2 session APIs now return safe UnknownError responses with log reference IDs when stored messages are corrupt.
• •Generic API 500s no longer expose config details from server errors.
• •Unknown API errors now include reference IDs so you can match responses to server logs.
• •V2 session APIs now return 503 ServiceUnavailableError for mutations that are not available yet.
• •V2 session APIs now return SessionNotFoundError for missing sessions.
• •Deduped concurrent Codex OAuth refreshes to avoid repeated refresh failures. (@cooper-oai)
• •Restored native OpenAI OAuth requests.
• •Tool schema failures now surface as friendly tool errors.
• •Added PDF attachment support for Grok.
• •Restored OpenAI reasoning streams.
• •Collapsed thinking labels now use clearer punctuation.
• •New sessions now default to the local project.
• •Single-select question checkmarks no longer run into option labels.
• •Added a pinch zoom setting for the desktop app.

v1.15.6

May 20, 2026

• •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.
• •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 preserves endpoint error responses.
• •opencode login now defaults to https://console.opencode.ai.
• •Agent and command names now resolve correctly from relative config paths.
• •Invalid OPENCODE_PERMISSION JSON no longer crashes startup.
• •Plugin tools with missing args no longer break tool loading.

v1.15.5

May 18, 2026

• •Preview the native OpenAI runtime path behind an experimental flag
• •Add --replay and --replay-limit to show recent history when resuming interactive runs
• •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
• •Refresh the prompt layout after pasting content
• •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-contrast paste summary badge color in some themes (@kagura-agent)
• •Allow desktop notifications from the renderer
• •Show free-limit and usage-exceeded dialogs in Desktop
• •Speed up large session timelines
• •Fix question dock overflow and message layout clipping
• •Hide the prompt placeholder when the input only contains whitespace (@ShrootBuck)

v1.15.4

May 17, 2026

• •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.
• •Made Markdown H1 headings easier to distinguish.
• •*Thank you to 1 community contributor:**
• •@necropheus:
• •docs: update README.es.md (#27739)