OpenCode v1.4.0 → v2.3.0: what changed

132 releases shipped between v1.4.0 (April 8, 2026) and v2.3.0 (November 13, 2026).

Changelog entries in this range

• v1.4.1 — April 9, 2026: Core - Fix clangd choosing CMakeLists.txt or Makefile as the project root in C and C++ workspaces. (@nonbanana) - Add permission prompts for GitLab Duo Workflow
• v1.4.2 — April 9, 2026: TUI - Fix subagents not being clickable until finished Desktop - Removed the forced loading delay while the app connects
• v1.4.3 — April 10, 2026: Core - Fixed agent create for OpenAI accounts authenticated with OAuth. - Interrupted Bash commands now keep their final output and truncation details instead o
• v1.4.4 — April 15, 2026: Core - Restored instance and logger context during prompt runs so prompt-time tools and logging behave correctly. - Kept GitHub Copilot compaction requests vali
• v1.4.5 — April 15, 2026: Core - Export AI SDK telemetry spans to OTLP trace backends. - Expose the experimental question API schema and OpenAPI spec from @opencode-ai/server. - Expose a
• v1.4.6 — April 15, 2026: Core - Fixed snapshot staging for very long file lists and improved staging performance. - Fixed OTEL header parsing when a header value contains =. Desktop - F
• v1.4.7 — April 16, 2026: Core - GitHub Copilot gpt-5-mini now uses low reasoning effort for better request compatibility. (@thakrarsagar) - Fixed Github Copilot overbilling issue - Work
• v1.4.8 — April 17, 2026: Core - Fixed a crash when experimental mode was enabled. - Let plugin tools return metadata in execute results. (@jquense) - Show real filenames instead of /dev
• v1.4.9 — April 17, 2026: Core - Added LLM Gateway as a provider, including config support and model usage reporting. (@smakosh) - Limited GitHub Copilot Opus 4.7 models to medium reason
• v1.4.10 — April 17, 2026: Core - Restored workspace history on connect so existing sessions catch up before live sync resumes - Passed OTEL exporter settings into managed workspaces so t
• v1.4.11 — April 18, 2026: Core - Fixed workspace routing so requests reach the correct workspace instance. - Stopped share sync attempts for sessions that were never shared.
• v1.14.17 — April 19, 2026: Core - Preserve executable permissions before Docker builds when artifacts lose their exec bits. - Fix plugins reinstalling more often than needed. - Use displa
• v1.14.18 — April 19, 2026: Core - Restore the native ripgrep backend so file search and file listing work reliably again. Thank you to 1 community contributor: - @ariane-emory: - docs: do
• v1.14.19 — April 20, 2026: Core - Prevented compiled binaries from failing on startup because of a circular session schema dependency. - Renamed the compaction setting to preserverecentto
• v1.14.20 — April 21, 2026: Core - Fixed a system theme regression in the TUI. - Added GET /config to the experimental HTTP API. - Fixed local dynamic imports on Windows when running under
• v1.14.21 — April 23, 2026: Core - Support pull diagnostics from LSP servers that use them, including C and Kotlin. - Fix project detection and caching for bare Git repos and worktrees. (@
• v1.14.22 — April 23, 2026: Core - Respect .npmrc settings during npm installs. - Let projects store a custom icon override so the chosen icon persists correctly. Desktop - Fix session vie
• v1.14.23 — April 24, 2026: Core - Respect custom .npmrc registry settings when checking package versions and updates. TUI - Render all non-synthetic text in a user message instead of show
• v1.14.24 — April 24, 2026: Core - Fixed DeepSeek assistant messages so reasoning is always included, avoiding provider formatting failures. - Fixed inherited model configs so interleaved-
• v1.14.25 — April 25, 2026: Core - Fixed permission config preserving rule order and exposes full IntelliSense for tool permission keys - LSP permission prompts now include request details
• v1.14.26 — April 26, 2026: Core - Fixed config parsing to preserve permission rule order. - Fixed OpenRouter DeepSeek reasoning output handling. - Sent an opencode/<version> User-Agent he
• v1.14.27 — April 27, 2026: Core - Added a configurable default shell for terminals and agent shell commands, with a Desktop setting to manage it. - Reduced extra terminal noise while crea
• v1.14.28 — April 27, 2026: Core - Fixed issue with opencode upgrade failing for bun installs unless in a directory with package.json
• v1.14.29 — April 28, 2026: Core - Sessions now keep a relative workspace path. - Moonshot and Kimi tool schemas are sanitized to avoid rejected tool calls. - MCP OAuth errors now match th
• v1.14.30 — April 29, 2026: Core - Fixed missing sessions in Desktop caused by path mismatches, including recovery for existing stored data. - Fixed Azure Responses defaults to avoid reaso
• v1.14.31 — May 1, 2026: Core - Azure setup now prompts for the resource name when needed and saves it with the API key. - Task child sessions now preserve parent externaldir and deny p
• v1.14.32 — May 2, 2026: Core - Shell mode in the prompt stays editable, so backspace, cursor movement, and other editing keys work again. - Fixed HTTP API workspace adapters losing ins
• v1.14.33 — May 2, 2026: Core - Fix issue with custom agents in plugins not loading Thank you to 3 community contributors: - @jerome-benoit: - fix(nix): remove stale packages/shared fil
• v1.14.34 — May 4, 2026: Core Improvements - Add PTY connection tickets so authenticated terminal websockets work more reliably across clients. - Add v2 session failure events so client
• v1.14.35 — May 5, 2026: Core Bugfixes - Preserve diff patch boundaries so session diffs keep rendering correctly when file contents include diff --git text.
• v1.14.37 — May 5, 2026: Core Bugfixes - Canceling a task now also cancels child subtask sessions. Improvements - Improved v2 session rendering with cleaner tool states, better compacti
• v1.14.38 — May 5, 2026: Core Bugfixes - Embedded UI requests now work with arbitrary connect-src origins under the default CSP. Desktop Bugfixes - Desktop now trusts system CA certific
• v1.14.39 — May 5, 2026: Desktop Bugfixes - Respect HTTPPROXY and related proxy environment variables in the desktop app. - Return null instead of failing when the desktop app cannot re
• v1.14.40 — May 7, 2026: Core Improvements - Support .well-known/opencode configs that point to a separate remote config file. Bugfixes - Preserve assistant text when replaying signed r
• v1.14.41 — May 7, 2026: Core Bugfixes - Restored formatter output handling so formatting still works when formatters write to stdout or stderr. (@ferdinandyb) Improvements - Warping a
• v1.14.42 — May 9, 2026: Core Improvements - Added HTTP API response compression for large non-streaming responses. - Added the Scout agent for repo research, docs lookup, and dependenc
• v1.14.43 — May 9, 2026: Core Bugfixes - Keep provider and config API responses working when auth loaders add non-JSON options to providers. - Include tool image attachments in ACP upda
• v1.14.44 — May 9, 2026: Core Bugfixes - Fixed upgrades failing for existing workspaces when adding the timeused field.
• v1.14.45 — May 10, 2026: Core Bugfixes - Provider configs and API responses now accept models marked as active. - Read tool permission rules now match worktree-relative paths, so read a
• v1.14.46 — May 10, 2026: 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
• v1.14.47 — May 11, 2026: Core Bugfixes - Restored prompt editing keybindings in the TUI textarea, including aliases like esc and enter - Model changes now persist reliably across sessio
• v1.14.48 — May 11, 2026: Core Improvements - Preserve original image attachments instead of resizing them before sending them to the model
• v1.14.49 — May 13, 2026: Core Improvements - Added the v2 model and provider listing API. - Added DigitalOcean OAuth and Inference Router support. (@Spherrrical) - Create a global openc
• v1.14.50 — May 14, 2026: Core Bugfixes - Kept HTTP event streams open after the initial connect event so subscribers continue receiving instance updates. - Returned proper busy errors w
• v1.14.51 — May 15, 2026: Core Improvements - Added experimental background subagents so tasks can keep running while you continue working. - Added the required billing origin header for
• v1.15.0 — May 15, 2026: Core Improvements - Added an Effect-based core event system for more complete event delivery across sessions and integrations. Bugfixes - Ignored invalid export
• v1.15.1 — May 16, 2026: Core Improvements - Clarified how to recover when the npm package is installed without its native binary. Bugfixes - Avoid duplicate consecutive entries in prom
• v1.15.2 — May 16, 2026: Core Improvements - Reduced unnecessary prompting around shell, task, and todo flows. Bugfixes - Fixed sync events not reaching project-scoped subscribers in in
• v1.15.3 — May 16, 2026: Core Bugfixes - Reduced wasted work when reading very large files after output truncation. TUI Bugfixes - Fixed async commands losing the active instance contex
• v1.15.4 — May 17, 2026: Core Bugfixes - Fixed project-scoped bus events so file watcher and update notifications reach the right instance. - Fixed custom LSP servers not sending refres
• v1.15.5 — May 18, 2026: Core Improvements - Preview the native OpenAI runtime path behind an experimental flag - Add --replay and --replay-limit to show recent history when resuming in
• v1.15.6 — May 20, 2026: 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
• v1.15.7 — May 21, 2026: Core Improvements - Added Grok OAuth sign-in, including device-code login. (@Jaaneek) Bugfixes - V2 session APIs now return safe UnknownError responses with log
• v1.15.9 — May 22, 2026: Core Improvements - Redesigned the diff viewer with a file tree and refreshed layout. Bugfixes - Return to the previous screen when closing the diff viewer. - S
• v1.15.10 — May 23, 2026: Desktop Bugfixes - Restored the legacy production desktop flows for opening projects and starting sessions.
• 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 up
• 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 o
• v1.15.13 — May 30, 2026: Core Bugfixes - Gateway Anthropic Opus 4.7+ adaptive reasoning now keeps summarized thinking instead of returning empty thinking blocks. Improvements - Sessions
• v1.16.0 — June 5, 2026: Core Improvements - Added managed workspace cloning that keeps dirty and untracked files. - Added moving sessions between workspaces and directories. - Added pr
• v1.16.2 — June 5, 2026: Core Bugfixes - Reasoning summaries now only run on providers that support them, avoiding GPT-5 request failures on compatible backends. - Edit operations now r
• v1.17.0 — June 10, 2026: Core Improvements - Faster file search across large projects with the new fff-backed search tools. (@dmtrKovalenko) - Added X-Session-Id headers for proxy setup
• v1.17.1 — June 10, 2026: Core Improvements - References can include usage descriptions for agents, show up in the new docs, and be hidden from @ autocomplete when needed. Bugfixes - Dep
• v1.17.2 — June 10, 2026: 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 thei
• v1.17.3 — June 10, 2026: Fixed issue with 1.17.2 desktop crashing
• v1.17.4 — June 12, 2026: Core Improvements - Added cwd support for local MCP servers so they can start from a workspace-relative directory. (@Grantmartin2002) - Added connector-based au
• v1.17.5 — June 13, 2026: Core Improvements - Added external browser OAuth for the Snowflake Cortex provider (@santigc6) - Improved project copy management and move-session flows in v2 B
• v1.17.6 — June 13, 2026: Core Bugfixes - Improved MCP server compatibility by declaring OpenCode's supported client capabilities.
• v1.17.7 — June 14, 2026: 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 w
• v1.17.8 — June 17, 2026: Core Improvements - Session timelines load much faster and avoid flicker or scroll jumps. Bugfixes - OpenAI-compatible providers now accept MCP tool schemas tha
• v1.17.9 — June 21, 2026: 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
• v1.17.10 — June 24, 2026: Core Improvements - Added MCP server instructions to session context. (@Arcadi4) - Added Opencode-managed provider integration support. - Added MCP resource tem
• v1.17.11 — June 25, 2026: Core Improvements - Add session snapshots and revert controls so you can roll a session back to an earlier message, including file changes. Bugfixes - Always pr
• v1.17.12 — June 30, 2026: Core Bugfixes - Enable adaptive thinking for Claude Sonnet 5. - Prefer MCP content responses over structured output when both are present. - Reconnect MCP serve
• v1.17.13 — July 1, 2026: Core Bugfixes - Force reasoning mode for OpenAI-compatible reasoning models so reasoning settings apply reliably on custom deployments - Stop replaying stale Gi
• v1.17.14 — July 6, 2026: Core Improvements - Added a code mode MCP adapter for running confined orchestration scripts against connected MCP tools. - Hid the execute tool unless code mod
• v1.17.15 — July 7, 2026: Core Bugfixes - Better classify Z.ai context-window overflow errors so oversized requests surface the right failure mode (@fengjikui) - Handle unavailable confi
• v1.17.16 — July 9, 2026: Core Bugfixes - Exposed reasoning effort variants for Grok models. - Improved xAI prompt cache routing and PDF file support in Responses models. Desktop Improve
• v1.17.17 — July 9, 2026: Core Bugfixes - Improved Meta model handling for reasoning variants and provider requests. Desktop Bugfixes - Fixed clipped descenders in model selector labels.
• v1.17.18 — July 9, 2026: Core Bugfixes - Prevent crashes and bad pricing data when GitHub Copilot returns models with a zero billing batch size. Improvements - Add a model-specific syst
• v1.17.19 — July 13, 2026: Core Bugfixes - Supported OpenAI pro reasoning mode. - Disabled response storage by default for xAI Responses. (@geraint0923) - Added OAuth support for Luna Res
• v1.17.20 — July 13, 2026: Core Bugfixes - Removed an obsolete Codex workaround that could interfere with OpenAI Luna Responses Lite requests. Improvements - Updated Azure AI support for
• v1.18.0 — July 14, 2026: Desktop Improvements - Completed the Desktop v2 migration, including upgrade handling for the new layout and first-launch onboarding. - Added a setting to switc
• v1.18.1 — July 14, 2026: Desktop Bugfixes - Fixed spacing between model provider sections in Settings.
• v1.18.2 — July 15, 2026: Core Bugfixes - Stopped subagents from launching nested subagents by default, with a configurable subagentdepth limit when needed. - Improved default reasoning
• v1.18.3 — July 16, 2026: Core Improvements - Added an Up Arrow shortcut to close the subagent picker when the first item is selected. Desktop Bugfixes - Fixed home page scrolling so sti
• v1.18.4 — July 20, 2026: Core Improvements - Use adaptive thinking controls for Kimi models on Anthropic-compatible providers, with summarized reasoning output by default. (@chouqin) Bu
• v1.18.5 — July 24, 2026: Core Bugfixes - Improve Claude adaptive thinking handling across more response shapes. - Avoid OpenAI Responses phase handling that could break some conversatio
• v1.18.6 — July 27, 2026: Core Bugfixes - Fixed branch-specific repository caches so refreshing one reference no longer moves another branch checkout. Desktop Improvements - Improved com
• v1.18.7 — July 27, 2026: Desktop Bugfixes - Remove the extra titlebar inset in fullscreen on macOS. - Keep command palette entries from reappearing incorrectly when shadowed commands ar
• v1.18.8 — July 28, 2026: Core Improvements - Improved compatibility with newer MCP servers and OAuth flows. Bugfixes - Reconnects MCP servers after expired SDK sessions, including concu
• v1.18.9 — July 28, 2026: Core Bugfixes - Restored compatibility with legacy MCP SDK clients. Desktop Bugfixes - Fixed a Solid cleanup crash that could break navigation in the desktop ap
• v1.18.10 — July 30, 2026: Core - Discover available Modal models automatically. (@devennavani) Desktop Improvements - Prevent adding the same attachment more than once. - Always show the
• v1.18.11 — August 1, 2026: Core Bugfixes - Stopped MCP SSE connections from getting stuck in reconnect loops after server error responses. - Fixed provider model configs that use interlea
• v1.18.12 — August 4, 2026: Core Bugfixes - Fixed Azure GPT-5.5+ completion requests failing when reasoning is enabled. (@frederiknsgo) Desktop Bugfixes - Reduced composer lag when drafts
• v1.18.13 — August 4, 2026: TUI Bugfixes - GitHub pull request reviews now include the pull request number and URL in context. Desktop Bugfixes - Fixed several right-to-left layout issues
• v1.18.14 — August 5, 2026: Core Improvements - Simplified xAI login to a single device-code flow that works better in headless and remote environments. Bugfixes - Preserved structured mid
• v1.18.15 — August 7, 2026: Core Bugfixes - Chronological message ordering now stays correct even when imported or legacy message IDs are out of order. - Revert and fork actions now use re
• v1.18.16 — August 10, 2026: Core Bugfixes - Ignore unknown top-level config fields instead of failing config parsing - Register projects opened from Home so they are available to the rest
• v1.18.17 — August 12, 2026: Core Bugfixes - Made session compaction keep complete recent turns and produce clearer summaries for smaller models. - Added MERGE Gateway reasoning variants so
• v1.18.18 — August 13, 2026: Core Bugfixes - Select the Kimi system prompt correctly for official Moonshot and Kimi providers - Fix xhigh reasoning effort for xai models
• v1.18.19 — August 20, 2026: Core Improvements - Added native OpenAI and Anthropic passthroughs for Cloudflare AI Gateway models. - Matched Codex rate limits more closely to ChatGPT subscri
• v1.18.20 — August 21, 2026: Core Bugfixes - Surface failed subagent tool calls with a resumable taskid. - Retry provider responses that end with finishreason: networkerror. - Retry more ne
• v1.18.21 — August 21, 2026: Core Bugfixes - Continue responses when a model reports an unknown finish reason instead of stopping early - Route Vertex AI eu and us multi-region Gemini reque
• v1.18.22 — August 24, 2026: Core Bugfixes - Removed outdated OpenCode Go first-month discount messaging and pricing. - Fixed OpenCode device login links when servers return relative verifi
• v1.18.23 — August 25, 2026: Core Bugfixes - Fixed Cloudflare AI Gateway routing for third-party providers so non-Workers models work through the gateway's REST API. (@superhighfives) - Fix
• v1.18.24 — August 28, 2026: Core Bugfixes - Bedrock reasoning responses no longer get cached into unreplayable empty messages. Improvements - Azure providers can now sign in with Microsoft
• v1.18.25 — August 28, 2026: Core Bugfixes - Fixed Azure authentication so Azure CLI sign-in works without requiring Bun.
• v1.18.26 — September 1, 2026: Core Bugfixes - Claude 5 sessions now tolerate stale thinking blocks instead of failing after prompt or tool changes. - Bedrock GPT-5.6 models now accept none r
• v1.18.27 — September 2, 2026: Core Bugfixes - Default provider header timeouts to five minutes so slow model startups fail less often. - Default streamed chunk timeouts to five minutes, with
• v1.18.28 — September 4, 2026: Core Improvements - Send the session ID as GitHub Copilot's interaction header to improve request tracking across a session. Desktop Bugfixes - Use the desktop
• v1.18.29 — September 4, 2026: Core Bugfixes - Allow Codex OAuth model filtering to recognize integer GPT versions like gpt-6 - Fixes issue of gpt-6-astra not showing up for openai subscripti
• v1.18.30 — September 9, 2026: Core Improvements - Added the Astra system prompt for GPT-6 models. Bugfixes - Preserved Bedrock DeepSeek model IDs, including ARN-based IDs, so they resolve co
• v1.18.31 — September 14, 2026: Core Bugfixes - Restored ACP session model, effort, mode, and reasoning chunk boundaries when loading, resuming, or forking sessions. (@JacobNWolf) TUI Bugfixes
• v1.18.32 — September 21, 2026: Core Bugfixes - Fixed Bedrock image attachments so they are only hoisted for Claude, Nova, and Llama 4 models. - Fixed Together AI streaming usage reporting. Th
• v1.18.33 — September 28, 2026: Core Bugfixes - Cloudflare AI Gateway models now honor provider response and stream timeouts. (@danlapid) - MCP browser launch failures are now reported when th
• v1.18.34 — September 30, 2026: Core Bugfixes - Send namespaced session and parent-session identity headers with model requests. - Re-sign locally compiled macOS binaries so they run reliably
• v1.18.35 — October 6, 2026: Core Improvements - Added canonical redirects and JSON and Markdown data formats for agent-readable stats. Bugfixes - xAI tool results now include supported ima
• v1.19.0 — October 11, 2026: Core Improvements - Run opencode upgrade --major to upgrade to OpenCode 2. Bugfixes - Allow the OpenAI ultrafast service tier. - Validate PTY connection origins
• v1.19.1 — October 15, 2026: Core Bugfixes - Session sharing has been discontinued. Existing share links and session-sharing commands are no longer available, and importing sessions from sh
• v1.19.2 — October 16, 2026: Core Bugfixes - OpenCode 1 now stays on the 1.x release line: update checks use only the npm opencode-ai latest version, so 1.x installs are never offered a 2.x
• v1.19.3 — October 16, 2026: Core Improvements - Configure model reasoning options to generate reasoning variants, replacing catalog variants while preserving your configured variant overri
• v1.19.4 — October 22, 2026: Core Improvements - Upgraded the bundled Bun runtime to 1.4.4, which includes security fixes for Brotli, TLS, HTTP/1.1, HTTP/2, HTTP/3, WebSocket, and fetch, an
• v2.2.0 — October 27, 2026: OpenCode 2.2.0 is here: build and share Desktop plugins, plus new keyed session instructions that keep your prompt cache intact. Breaking changes inside, so che
• v1.19.5 — October 28, 2026: Ever had OpenCode freeze when a TUI worker request failed? In 1.19.5, failed requests now return a proper error instead of hanging. Thanks to @Nowaker for the f
• v2.2.1 — October 29, 2026: OpenCode 2.2.1 lets your session keep going until a reviewer confirms the goal is met. Plus image generation, a smarter model picker, and live background shells
• v2.2.2 — October 29, 2026: OpenCode 2.2.2 is here: image generation works out of the box with supported providers, the Git branch on new sessions opens your worktree picker in one click,
• v2.2.3 — October 30, 2026: OpenCode 2.2.3 lets you use your Claude Code login and models right inside OpenCode, and long Desktop sessions now run smoother. Breaking changes hit @opencode/
• v2.2.4 — October 30, 2026: Desktop terminals now survive restarts with scrollback intact, and agents can publish HTML artifacts. Claude Agent setup got a guided walkthrough too. Curious w
• v2.2.5 — October 30, 2026: OpenCode 2.2.5 is here: percentage compaction buffers, one-key worktree switching, and send-quote shortcuts. Shell calls now just work too. Curious what else ch
• v2.2.6 — November 6, 2026: Share one MCP connection across projects, run scripted sessions in fresh git worktrees, and keep CI runs out of your inbox. OpenCode 2.2.6 is here. Want to see
• v2.2.7 — November 10, 2026: Let Copilot pick the model for you with Auto, close side panel tabs faster, and mark sessions unread so they stay flagged. OpenCode 2.2.7 is out. What else did
• v2.3.0 — November 13, 2026: OpenCode 2.3.0 is here: subagents now run quietly in the background while you keep working, transcripts collapse into tidy activity rows, and you can jump to an

All OpenCode releases · v1.4.0 release · v2.3.0 release