Skip to content

OpenCode Release Notes

Anomaly and contributors · Open-source AI coding agent desktop client for local project work, coding sessions and configurable model providers; separate from the terminal CLI.

CaskDeveloper ToolsAuto-updates 228K
Install command
brew install --cask opencode-desktop
30-day installs
12,446
#34 in App
1-year installs
100.3K
Last 365 days
Latest version
2.3.2
Download size
338MB
dmg
Release cadence
Daily
22 releases in 30 days
  1. 2.3.2

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    OpenCode 2.3.2 stops GPT-6.2 from re-billing the system prompt as uncached input.

    Caching
    GPT-6.2 no longer re-bills the system prompt as uncached input.On Copilot gpt-6.2-sol, uncached input per step fell from about 14,000 to 3.Compaction through /responses/compact now reads the same cached prefix.
    Fixes
    webfetch no longer repeats the url and format it was called with.

    OpenCode 2.3.2, published on November 18, 2026, is a desktop coding agent for people using GPT-6.2. This release stops every step from re-billing the system prompt as uncached input.

    Source: https://github.com/anomalyco/opencode/releases/tag/v2.3.2

    • GPT-6.2 no longer re-bills the system prompt as uncached input.
    • On Copilot gpt-6.2-sol, uncached input per step fell from about 14,000 to 3.
    • Compaction through /responses/compact now reads the same cached prefix.
    • webfetch no longer repeats the url and format it was called with.
  2. 2.3.1

    Expand

    GitHub Release

    Highlights

    • Timed-Out Shell Commands Keep Running: A shell command still running when its timeout expires now moves to the background instead of being killed, so long builds and test runs finish and report back. A foreground timeout: 0 now means the default 120 seconds. (#63699)
    • Compaction Without the Wait: As a session nears automatic compaction, the summary is now written in the background, so your next prompt doesn't pause for it. Set compaction.background: false to turn it off; a background summary that ends up unused still costs tokens. (#64290)
    • GPT 6.2 with ChatGPT Sign-In: GPT 6.2 Sol and GPT 6.2 Astra, plus their fast variants, now show up in the model picker when you sign in with ChatGPT. (#64508)
    • Update Plugins from Settings: Open Settings › Extensions, click Check for updates, then Update on any plugin with a new version. (#64511)
    • Comment on Selected Code: Selecting code in diff and file viewers now just selects it, so you can copy it, and an Add comment toolbar appears beside the selection. (#64410)

    Core

    Improvements

    • Shell commands still running when their timeout expires now move to the background instead of being killed, in every build. The shell_timeout_background flag is gone; configs that still set it keep loading. A foreground timeout: 0 now uses the default 120 second timeout instead of waiting until the command exits. (#63699)
    • Background compaction is now on by default: as a session nears automatic compaction, the summary is written in the background so the next prompt doesn't wait for it. Turn it off with compaction.background: false; a background summary that is never used still costs tokens. The experimental.background_compaction setting is removed. (#64290)
    • OpenCode again reads CLAUDE.md in any directory that has no AGENTS.md, and falls back to ~/.claude/CLAUDE.md when the global AGENTS.md is missing. This also applies to instructions found when the agent reads nested files. Set OPENCODE_DISABLE_CLAUDE_CODE or OPENCODE_DISABLE_CLAUDE_CODE_PROMPT to skip every CLAUDE.md. (#64474, #64533)
    • Added GPT 6.2 Sol and GPT 6.2 Astra, plus their fast variants, to the ChatGPT model list. (#64508)
    • websearch now returns a flat list of results, each with its url, title, content and published date. (#64471)
    • Code Mode and plugins get a simpler structured result from read: text (with offset, lineCount and next), directory (entry names) or media (a URI instead of base64). What the model sees is unchanged. (#64361)
    • Code Mode programs can use Node's Buffer for encoding and decoding bytes. (#64365)
    • In Code Mode, search("issues") now works as shorthand for search({ query: "issues" }). (#64347)
    • Code Mode tool summaries in the catalog can now be up to 500 characters instead of 120, so the model sees more of each tool's description. (#64341)
    • The glob and grep tools now report a malformed filename glob (for example [) as an error that names the parameter to fix, instead of returning no results. (#63960)
    • Server requests that crash now return a 500 with a readable JSON UnknownError body instead of an empty one. Storage problems name the cause (for example "Storage is full" or "Storage is read-only"); other crashes include a ref you can find in the server log. (#64022)
    • The shell tool description now tells the model that its session ID is in the OPENCODE_SESSION_ID environment variable. (#63718)
    • Experimental schedules are now automations, behind the automations flag (the old schedules flag still works). An automation runs on a time, an interval, a cron or a pushed MCP event, and either sends a prompt (to the creating session, another session or a new subagent) or runs a Code Mode program that decides whether to send one. Use /automation or the automation_* tools. Active or paused plain prompt schedules carry over; schedules with a condition or run limit, and finished ones, are dropped. (#64160)

    Bug fixes

    • Fixed finished shell commands leaving zombie processes under opencode-pty. The process daemon now cleans each command up when it exits. Background processes started by a successful command (cmd &) keep running, and a failed command's leftovers are stopped. (#64266, #64251)
    • Fixed ChatGPT and OpenAI subscription logins losing their sharing-limit safeguards and context caps when a token refresh failed. (#64470)
    • Fixed Claude Agent models falling back to a 200K context window when Claude Code adds or renames a model. Thanks @Tarquinen. (#64107)
    • Fixed requests being rejected after switching models mid-session on OpenAI-compatible providers. Models that declare a different reasoning field (such as reasoning_content) no longer receive reasoning_details from earlier turns. (#64243)
    • Rejecting a permission request now rejects only the other pending requests from the same step, not every pending request in the session. (#64343)
    • Fixed a finished subagent being reported to its parent as still running when its answer quoted the "Background work still running" heading. (#64026)
    • Fixed ACP clients missing turns that a background shell woke after the original turn ended. (#64262)
    • Reading a small text file now applies the default line and byte limits, so a short file with very many lines is paged instead of returned whole. (#63810)
    • Paged reads that select a single blank line now return that line instead of an empty result. (#63809)
    • read now rejects limit: 0 with "Limit must be a positive integer". (#63808)
    • Text files that start with BM are no longer mistaken for BMP images, and only real GIF87a/GIF89a headers count as GIFs, so these files read as text again. (#63822, #63811)
    • Fixed shell output pages, grep previews, generated titles, read lines and shell output tails splitting emoji and other multi-byte characters, which showed up as �. (#63984, #63967)
    • Shell commands using unknown ANSI-C escapes such as $'\q' are now read the same way Bash and Zsh read them, so permission rules can match them. (#64263)
    • Session title search is now case-insensitive for non-ASCII letters, such as Cyrillic and accented text. (#64259)
    • Fixed grep results being dropped when a matching line or path is not valid UTF-8. Thanks @Tarquinen. (#62249)
    • The @ file picker now finds files in hidden folders such as .github/ and dotfiles such as .env.example when file search uses ripgrep (the default on Windows and outside git repos). .git and gitignored files stay excluded. Thanks @Tarquinen. (#62577)
    • An unreachable well-known integration source is now skipped instead of dropping every well-known source. Thanks @Tarquinen. (#62578)
    • A corrupt cached project ID is now ignored instead of being used. Thanks @Tarquinen. (#62576)
    • Plugin tool renames from tool.execute.before now apply to calls inside Code Mode programs, and a renamed call returns the new tool's structured result. (#63633, #64333)
    • In Code Mode, calling a tool that doesn't exist now returns a rejected promise, so .catch and Promise.allSettled can handle it instead of the whole script failing. (#64510)
    • A Code Mode program that only logs no longer shows a stray null line before its logs. (#64344)

    TUI

    Improvements

    • Permission prompts from a subagent, and from that subagent's own subagents, now appear while you view the subagent's session. Prompts also show in front of an open composer. (#64343)
    • The export dialog under the new designs can save to the system temp directory as well as the project folder. Thanks @Tarquinen. (#62490)
    • Removed time to first token (ttft) from the assistant message footer. Tokens per second still shows when session.tps is on. (#63759)

    Bug fixes

    • When another TUI sharing your tabs closes the session you're viewing, closing it here now moves to the neighbouring tab. (#64261)
    • Fixed broken characters at the edges of the shell output viewer and the inline shell display when output is long. (#63967, #63984)

    Desktop

    Improvements

    • You can check for and install plugin package updates from Settings › Extensions. Use Check for updates to look for new versions, then click Update on any plugin that has one. (#64511, #64525)
    • Selecting code in diff and file viewers now just selects text, so you can copy it. An Add comment toolbar appears next to the selection to comment on those lines; line numbers and the gutter + still start a comment directly. (#64410)
    • Cmd+F (Ctrl+F) now finds text in Markdown, Mermaid, CSV and HTML previews in the side panel, using the same find bar as the code view. (#63663)
    • Disconnecting a provider or removing an account in Settings → Providers now asks for confirmation first. Disconnecting OpenCode Console says how many providers will stop working. (#64212)
    • The model picker's variant flyout now follows the keyboard: it opens beside the highlighted row, → enters it to pick a variant or toggle Favorite, and ← or Escape goes back. A model's Console budget and reset time now show in the flyout. (#64409, #64423)
    • When New worktree is selected for a new session, the composer shows the base branch (from dev ▾). Click it to pick another base; the choice applies immediately, and Use main checkout switches back. (#64228)
    • Redesigned the folder picker for remote servers, with a path bar, up to three recent-project pills plus a More projects menu, and a search box that shows the selected folder. (#64241)
    • ```latex and ```math code fences now render as display math once complete. (#64380)
    • The new icon set is now the default, and the New icons experiment has been removed. (#64466, #64451)
    • The copy button under assistant messages is now always visible. Message metadata still appears on hover. (#64478)
    • Text files opened in side-panel tabs now have the same copy and download actions as other files. (#64463)
    • Manage models now shows every provider as a card with a ⋯ menu, whether or not you're signed in to OpenCode Console. (#64235)
    • The connect provider dialog has a cleaner layout for every sign-in step: breadcrumbs, method icons, full-width device codes, and a "Signing in from another device?" row for pasting a redirect URL. (#63829)
    • Collapse long messages is no longer experimental. It is now a setting under Timeline preferences. (#64441)
    • Settings now opens on your client preferences, which are listed first, pairing is grouped with Servers, and there's a Help & feedback link. (#64440, #64220)
    • Automatic compactions now always show as a single quiet divider; manual and failed compactions still show the full record. (#64290)
    • Pairing QR codes can carry a server name, which becomes the paired server's default name. (#64139)
    • Image attachment thumbnails are larger, with a 3:2 crop, and a failed image no longer moves the message below it when retried. (#64215)
    • The Hex voice tip no longer appears when Hex is already installed, its copy now says what Hex is, and tips wait an hour after first launch before the first one shows. (#64130, #64131, #63974, #63760)
    • Added missing translations for every non-English language, about 920 strings each. (#64205)

    Bug fixes

    • Fixed the desktop app failing to start when drafts.sqlite was a symlink to or copy of the CLI's opencode.db. The desktop now moves that file aside and creates its own, leaving the CLI database untouched. (#64203)
    • Switching session tabs with a keyboard shortcut now focuses the composer. (#64418)
    • Long prompts now stay folded while a new session is being created. (#64452)
    • On macOS, the browser pane stays live while you resize panels instead of showing a still image. (#64443)
    • Submenus now open one at a time and swap without blinking, and stay open while you move the pointer across other items to reach them. (#63739)
    • Pressing a button now dismisses its tooltip until you hover it again, and copy buttons show "Copied" for two seconds, including in the /btw panel. (#63834)
    • Dialogs now use consistent sizes, corner radius and row styles across the command palette, session search, model picker, location picker and other lists. (#63432, #64216, #64206)
    • Sessions on OpenCode Go no longer show a $0.00 cost. (#63744)
    • Use main checkout now stays on one line in the branch picker, and wrapped question descriptions have better spacing. (#64450, #64446)
    • Restyled the Timeline detail slider and visibility buttons in settings so they read as clickable. (#64186)
    • Polished small details: animated counts no longer look faded at rest, the sidebar resize pill is hidden, the sidebar peek insets match, subagent breadcrumbs show a hover background, and screen readers name the redirect URL field after its label only. (#64155, #64219, #64192, #63742, #63885)

    SDK

    Improvements

    • Unhandled server errors now return a JSON UnknownError body (message and ref) with status 500 instead of an empty body. (#64022)
    • Experimental automation endpoints replace the schedule endpoints: /api/experimental/automation and client.experimental.automation.* (create, list, get, pause, resume, delete). /api/experimental/schedule and client.experimental.schedule.* are removed. (#64160)
    • Config adds compaction.background; experimental.background_compaction and the shell_timeout_background flag are removed. (#64290, #63699)

    Bug fixes

    • Apps embedding the SDK with an in-memory database no longer import the user's legacy auth.json credentials. Only a database file opened by path imports them. (#63716)

    Extensions

    Improvements

    • Each tool call inside a Code Mode program now has its own call ID in plugin hooks and traces. Its permission requests still show on the execute call's row. (#64324)
    • Plugin SessionIdleBackground items can now be { kind: "codemode", sessionID, jobID }, and GUI plugin BridgeLayout accepts an optional clip rectangle. (#64343, #63819)

    Bug fixes

    • The browser extension's URL bar action buttons are now spaced 6px apart. (#64214)
  3. 2.3.0

    Expand

    GitHub Release Added to Homebrew

    CompatibilitymacOS 13 or later

    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)
  4. 2.2.7

    Expand

    GitHub Release Added to Homebrew

    CompatibilitymacOS 13 or later

    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)
    • An error appears when a path can't be opened in its default app. (#62572)
    • Cut, Copy, Paste and Select All in the right-click menu follow the app language. (#62252)
    • Ukrainian tool titles use nouns. (#62263)
    • Scrolling titlebar search results no longer jumps back when late results arrive, the inbox no longer announces already-running sessions as working on load, and the quote toolbar comes back after Escape. (#62597)

    SDK

    Improvements

    • session.generate returns tokens and cost along with text. (#62835)
    • credential.updated includes the integrationID and credentialID of the login that changed. (#62762)
    • Predicate questions in client.experimental.generate.decisions accept optional criteria: { true?, false? }. (#62819)

    Extensions

    Improvements

    • ACP clients can redirect a running turn with the _session/steering extension, advertised as _meta.steering.supported in initialize. Thanks @smagnuso. (#54394)
  5. 2.2.6

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Shared MCP connections and GUI plugin themes.

    OpenCode Desktop 2.2.6 was released on 2026-11-06. This update shares one MCP connection across projects and adds GUI plugin themes.

    • 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.
    • GUI plugins can add color themes, render or add actions to code blocks, and use native settings and menu components.
    • On phones and tablets, composer actions sit in a touch dock above the keyboard with larger buttons.
    • Run opencode run -w to start the session in a new git worktree, or --worktree=<name> to name it.
    • Add --archived to opencode run to keep scripted and CI sessions out of your inbox and session lists.
  6. 2.2.5

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    This version has no editorial notes yet.

    Note
    No editorial notes for this version yet.
  7. 2.2.4

    Expand

    GitHub Release Added to Homebrew

    CompatibilitymacOS 13 or later

    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)
  8. 2.2.3

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    OpenCode 2.2.3 adds a Claude Agent provider, speeds up long Desktop sessions, fixes side-panel tabs and moves TUI plugins to OpenTUI 0.8.

    Highlights

    • Added a built-in Claude Agent provider. After installing Claude Code and running claude auth login, select Claude Agent in /connect (#58782).
    • Streaming replies and long conversations in Desktop now do less rendering work (#60489, #60521, #60513, #60481).
    • Fixed side-panel tabs, repeated “Session not found” toasts and Open file over HTTP (#60430, #60436, #60459, #60462).

    Desktop

    • Spellcheck can be toggled under Settings → General, with system-language dictionary selection on Windows and Linux (#59129).
    • PageUp and PageDown page the timeline from the composer without moving the draft cursor or focus (#59426).
    • Question notifications and sounds can be configured separately under Settings → Notifications → Questions (#60358).
    • The new-session control has separate project and worktree actions (#60486), and the version can be copied in one click from Settings → About (#52356).
    • Fixed consecutive dropped files so every file mention is inserted into the composer (#60463), and side-panel tabs close again with ⌘W (#59002, #60435).

    Other changes

    • TUI plugins now require OpenTUI 0.8; @opencode/plugin needs @opentui/core and @opentui/solid 0.8.0 or later (#60385).
    • In managed policy, integration.use now covers integrations only; the new mcp.use, skill.use and plugin.use actions control MCP servers, skills and plugins, and rules with the old mcp:, skill: and plugin: prefixes are converted automatically (#60315).
    • Code Mode JavaScript checks can be added to experimental schedules (#60140), and TestSpeech, TestTranscription and TestVideo moved to @opencode/ai/experimental/testing (#60484).

    Official release notes

  9. 2.2.2

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Updated to version 2.2.2. The official release notes do not list specific changes.

  10. 2.2.1

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Adds goal-driven sessions, optional image generation, and a new default model picker.

    • Use /goal <objective> in Desktop or the TUI, with pause, resume, clear, and automatic progress review. Optional scheduled prompts use /schedule and experimental.schedules.
    • Enable experimental.image_generate for image creation and editing. Adds GPT Image 2 after Codex sign-in, MiniMax and Meta Muse support, and fixes image-edit reference formats.
    • Desktop adds /reload, searchable Favorites and Recent model lists, live background-shell output with Stop, and project and worktree actions in the session location menu.
    • Improves integration controls, command search, prompt-history focus, artifact previews, timeline rendering, zoomed scrolling, plugin event endpoints, and macOS icon edges.
    • Improves snapshots, context headroom, provider throttling retries, Code Mode diagnostics, and Responses API support for OpenRouter, DigitalOcean, and Venice.
    • TUI fixes cover early execution errors, continued-subagent activity, pasted image and PDF paths, and empty /usage spacing.
    • Direct @opencode/ai users must migrate removed fal, Black Forest Labs, Replicate, and Stability providers and legacy Bedrock/Vertex entry points; configure() input types become Config. These changes do not affect Desktop, CLI, or HTTP API use.
    • SDK adds scheduled-prompt management under client.experimental and Promise-client compaction. Extensions gain experimental.idle, Effect-returning Code Mode globals, and composer-pill popovers.

    Official release notes

  11. 2.2.0

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Introduces experimental Desktop plugins and refreshes the desktop workspace.

    • Manage plugins in Settings > Extensions > Plugins. Adds experimental image and decision APIs, keyed session instructions that survive compaction and reverts, and configurable prompt-cache TTLs.
    • Desktop adds Focus and Pro layouts, split and bottom panes, side-panel tabs, searchable model and prompt-history pickers, persistent zoom, and opt-in Todo tasks.
    • Adds project and worktree selection, cross-server session search, subagent and shell controls, message rewind and fork, editable line comments, and faster Mermaid rendering.
    • Reduces memory and repeated history loading; improves file search, Git discovery, OAuth refresh, provider throttling retries, attachment handling, MCP tools, and desktop rendering and keyboard focus.
    • Adds GPT-6.1 Terra and GPT-6.1 Terra Fast to ChatGPT sign-in, Console usage-limit displays, experimental session media, and SDK GUI-plugin APIs.
    • Breaking changes: @opencode/ai exports the Promise API at its root; Effect imports move to @opencode/ai/effect. The OpenCode GitHub Action is removed. TUI plugins require OpenTUI 0.7.0 and updated hook initialization.

    Official release notes

  12. 2.1.4

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Displays MCP input forms and adds experimental background compaction.

    MCP requests for input now display a form rather than leaving the tool call waiting for a timeout. Desktop and web support text, number, choice, multiselect, boolean and URL requests. Set experimental.background_compaction to true to prepare a session summary as it approaches the compaction threshold, reducing the wait during automatic compaction. Preparing a summary still consumes tokens even if the summary is never used. These are selected highlights; see the official changelog for the full release.

    https://opencode.ai/changelog

  13. 2.1.3

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Updated the bundled Bun runtime to 1.4.4 with security fixes and refreshed root certificates. Desktop code blocks, file views and review diffs use Pierre Highlights for faster highlighting and lower memory use on large inputs. Fixed formatted pastes when renaming session tabs and the session scrollbar jumping back to the end.

    Updated the bundled Bun runtime to 1.4.4 with security fixes and refreshed root certificates. Desktop code blocks, file views and review diffs use Pierre Highlights for faster highlighting and lower memory use on large inputs. Fixed formatted pastes when renaming session tabs and the session scrollbar jumping back to the end.

    Source: https://opencode.ai/changelog

  14. 2.1.2

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    OpenCode 2.1.2: clearer free-limit recovery

    Restores desktop free-limit recovery and keeps the current session when subscribing to OpenCode Go.

    • Restores the desktop free-limit dialog, reset-time notice, and submitted prompt after free usage is exhausted.
    • Updates the current session’s model when subscribing to OpenCode Go instead of opening another draft.
  15. 2.1.1

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Improves model-catalog refresh propagation and provider-variant construction, and refreshes the bundled model catalog.

    Selected shared-core changes in the official v2.1.1 tagged source: models.dev catalog refreshes are broadcast server-wide, provider variants are built after package normalization, and the bundled models.dev snapshot is refreshed. These core fixes also matter to the Desktop client. The comparison additionally lists TUI dialog redesign work; those interface changes concern the terminal client. This note is based on the tagged source comparison because the public website has no separate 2.1.1 changelog entry.

    Source comparison

    Catalog refresh · Provider variants

  16. 2.1.0macOS 13 or later
  17. 2.0.32

    Expand

    OpenNavo editorial Added to Homebrew

    Shared core notes for 2.0.32: fixes login crashes when no browser opener is available and retries intermittent Gemini MALFORMED_RESPONSE finishes. The TUI /copy command now copies the latest reply or compaction summary. These are not desktop-specific feature announcements.

    Shared core notes for 2.0.32: fixes login crashes when no browser opener is available and retries intermittent Gemini MALFORMED_RESPONSE finishes. The TUI /copy command now copies the latest reply or compaction summary. These are not desktop-specific feature announcements.

    Source

  18. 2.0.31
  19. 2.0.30

    Expand

    OpenNavo editorial Added to Homebrew

    Adds per-turn changed files, line counts and expandable diffs in the desktop timeline, plus keyboard session-tab navigation. Improves docked TUI diffs, MCP compatibility and compaction limits; keeps settings accessible for missing project folders.

    Adds per-turn changed files, line counts and expandable diffs in the desktop timeline, plus keyboard session-tab navigation. Improves docked TUI diffs, MCP compatibility and compaction limits; keeps settings accessible for missing project folders.

    https://opencode.ai/changelog

  20. 2.0.29

    Expand

    OpenNavo editorial Added to Homebrew

    Remote pairing, provider account management, automatic continuation and desktop fixes.

    OpenCode 2.0.29 — Release notes

    Desktop adds remote device pairing in Settings → Pairing through OpenTunnel, with a QR code and link. Provider accounts can be switched, renamed, removed or added from the connect dialog or Settings → Providers. Trackpad gestures zoom and pan image/SVG previews, and sessions show context tokens and accumulated family cost.

    Responses automatically continue after reaching an output-token limit, with bounded retries and recovery for truncated tool calls. policies becomes a top-level configuration key while experimental.policies remains compatible; centrally managed configuration takes precedence over local and user configuration.

    Refines side-panel shortcuts, the question composer, timeline notices and diff colors. Fixes immediate pending-message/attachment display, raw-media retention up to 256 MiB, lost model selections, browser-tab closing, incorrect missing-file notices and a project-store eviction loop at launch. The official entry also covers TUI, SDK and extensions; this summary focuses on desktop and shared core changes.

    Official sources