Changelog
New updates and improvements to OpenCode
v2.2.0 Create, install and share Desktop plugins (experimental)
Add experimental image and decision generation APIs to plugins and sdk
Add experimental image and decision generation APIs to plugins and sdk, allowing image generation or decision model (think typesafe, clef, etc) workflows.#59190#59380#58758
Plugins can now attach and update keyed session instructions with ctx.session.instructions.entry.put/list/remove
Plugins can now attach and update keyed session instructions with ctx.session.instructions.entry.put/list/remove. Instead of editing the system prompt and busting the prompt cache, each change is added as a small update at the next step. The entries also survive compaction and reverts, and they don't start an extra model turn.#56550
See all highlights in v2.2.0Add configurable prompt cache TTLs per provider/model
Breaking changes
TUI plugins require OpenTUI 0.7
#59295@opencode/pluginnow requires@opentui/coreand@opentui/solid0.7.0, up from 0.6.8 or later. Plugins that depend on OpenTUI 0.6 fail to install until they upgrade. In OpenTUI 0.7, custom renderables read their hooks from their class at construction: assignrenderBefore,renderAfter, andonLifecyclePassin the constructor instead of as class fields, callrefreshHooks()after adding a hook by reflection, and replacedefineNativeIntegration()with astatic nativeIntegrationdeclaration. See the OpenTUI 0.7.0 release notes.Improvements 27
- CoreImprove integration rebuild performance.#59402
- CoreLet custom model configuration set a model type.#59388
- CoreLet model-list API requests filter by type.#59355
- CoreMake external-directory permission checks use the project's filesystem.#59089
- CoreReduce memory use when code search finds very large lines.#59205
- CoreLet plugins filter event subscriptions by type.#58864
- CoreMove image resizing off the main process and release idle image memory.#58820
- CoreReduce repeated session-history loading during a step.#59091
- CoreAdd an experimental API for session media and opt-in media URI support.#59103
- CoreAdd the machine hostname to
/api/info.#59090 - CoreAdd experimental content-addressed blob storage for session media behind
experimental.media_blob.#58656#58741 - CoreStart session history from the latest completed compaction.#59020
- CoreReduce work encoding durable event payloads that are not persisted.#58923
- CoreExpose MCP server titles from
serverInfo.#58950 - CoreApply OpenCode Console workspace configuration as a configuration layer.#57703
- CoreReplace experimental evaluations with Decision APIs in the AI pkg, including OpenAI Decisions, System One, and Cloudflare Run models.#58758#58382#58379#58381
- CoreConvert tool schemas once to speed up tool execution.#58798#58848
- CoreMake Git project discovery faster while recognizing repository changes.#58616
- CoreShow OpenCode Console budget limits and Go usage where they block you.#58694#58714
- CoreRecord provider-reported session costs.#58562
- CoreFind Git more reliably on macOS.#58602
- CoreResolve model details once per prompt step.#58601
- CoreAdd GPT-6.1 Terra and GPT-6.1 Terra Fast to Sign in with ChatGPT.#59359
- TerminalReduce CPU use while animated session-tab pulses are visible.#59235
- TerminalList OpenCode Console before OpenCode Go in the integration picker.#59107
- TerminalAdd
/usage, model-picker, prompt, sidebar, warning, and error details for OpenCode Console usage limits.#58731 - TerminalMake CLI service registration more reliable when concurrent processes update its files.#59105
Fixes 59
- CoreWait for plugins to finish reloading before each session step and tool call.#51133@kernel-oops@Tarquinen
- CoreSize session compaction from the provider's reported token count to preserve usable context.#59441
- CoreSkip unavailable models.dev API entrypoints instead of failing model catalog updates.#59475
- CoreReturn a server error with a reference ID when the server cannot encode a response.#59459
- CoreAvoid warming a session while its model request is running.#59325
- CorePreserve legacy MCP
codemodesettings during migration.#59126@tneemo - CoreUse the correct Vertex AI endpoints for the
euandusmulti-regions.#59335 - CoreAccept Databricks hosts that include
http://orhttps://.#59334 - CoreKeep files intact when patch edits move a file onto itself.#59197
- CorePreserve literal
$0and$ARGUMENTStext in custom command input.#59198 - CoreClose project locations concurrently during shutdown.#59326
- CoreTreat equivalent directory paths, including trailing slashes, as one location.#59327
- CoreSend valid tool schemas to Kimi for tuple, default, and keyword-like arguments.#59207
- CoreExpose Code Mode MCP tools directly when the
executepermission is denied.#59315 - CoreCoordinate OAuth credential refreshes across locations and processes.#54023
- CoreList and search remote Git branches correctly without bare remote names.#58597
- CoreDetect AVIF, HEIC/HEIF, QuickTime, and M4A attachments correctly.#58480#58886#58887
- CoreReduce memory retained by long-running tool calls and unchanged hooked model requests.#58448#58449
- CoreLoad session diffs without reading every message, improving performance for large sessions.#57686
- CoreKeep active locations alive when session events use an equivalent directory path.#56259
- CoreReload compatibility skills only when their own sources change.#59086
- CoreAvoid publishing redundant catalog updates when configuration is unchanged.#56267
- CoreAvoid booting idle or deleted project locations while polling session forms.#59083
- CoreWait for plugins before returning agent and provider lists, preventing incomplete catalogs.#59082
- CoreManage sessions and instruction entries after their project directory is deleted.#58997
- CoreStart fuzzy file search only on first use, reducing project startup work.#58959
- CoreExit after 10 seconds when shutdown hangs and report pending work.#58817
- CoreKeep the models catalog fresh without redownloading it when unchanged.#58813
- CoreSend xAI Responses
top_ksettings and stop sending unsupported penalties.#58868 - CoreHonor shared parallel tool-call and service-tier settings for Groq.#58871
- CoreRetry throttled requests instead of misreporting them as context overflows.#58866
- CorePreserve streamed text and reasoning that arrive after an OpenAI Chat finish reason.#58851
- CoreClassify AWS REST JSON errors consistently regardless of where the error type appears.#58770
- CoreValidate large base64 attachments without slowdowns or hangs.#58811
- CoreRetry Bedrock throttling errors as rate limits instead of context overflows.#58759@Irish-Joseph
- CoreKeep working MCP tools available when a server returns malformed ones.#58350
- CoreMatch absolute instruction-file globs across directories.#58749@heimoshuiyu
- CoreUse configured provider regions in Bedrock endpoint URLs.#58538
- CoreHandle unknown OpenAI Chat finish reasons without failing the response.#58608
- CoreAvoid unnecessary Azure model updates when endpoint transforms make no change.#58600
- CorePrefer JPEG for opaque browser screenshots, reducing attachment size.#56990
- CoreDetect generated image types from their bytes when compatible hosts omit the format.#58475
- CoreKeep project services alive while sessions run long tools or wait for input, with a 24-hour inactivity cap.#57274
- CorePrevent unrelated configuration changes and compatibility-skill update bursts from repeatedly reloading skills.#56260
- TerminalReturn
opencode run --format jsonserver connection errors as JSON.#59366@andreivince - TerminalPreserve pasted prompt text when copying it back out.#59209
- TerminalReliably update the background service on Windows when its files are briefly locked.#59105
- TerminalKeep the background service state directory out of tool shells and identify processes blocking its port.#58815
- TerminalRefresh Git branch details after switching branches.#58982
- TerminalKeep the TUI running when a plugin slot or route renders bare text.#58144@anmol0b@Tarquinen
- TerminalAccept
--serverand--standaloneanywhere in supported CLI commands.#58505 - TerminalRelease closed and background session transcripts to prevent memory growth.#58434#57025
- TerminalConnect remote access tunnels through HTTP proxies.#58464
- TerminalKeep development builds on a separate server, database, and port from released builds.#58331
- SDKFix generated Promise client input types for TypeScript consumers.#58875
- SDKLet SDK clients discard inline tool-result file payloads to reduce memory use.#59101
- SDKAvoid unnecessary catalog refreshes for locations an SDK client has not loaded.#55237#59099
- SDKRestore running sessions created while an SDK client was disconnected.#53012
- SDKRelease omitted tool-image payloads from memory instead of retaining their base64 data.#58560
v1.19.4 Upgraded the bundled Bun runtime to 1.4.4
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, and updates root certificates to NSS 3.131.1.v1.19.3 Improvements
Improvements
- CoreConfigure model reasoning options to generate reasoning variants, replacing catalog variants while preserving your configured variant overrides.
v1.19.2 OpenCode 1 now stays on the 1.x release line
OpenCode 1 now stays on the 1.x release line: update checks use only the npm
opencode-ailatest version, so 1.x installs are never offered a 2.x build as a regular update.Fixes
- CoreUpgrading to OpenCode 2 remains a separate, explicit choice through the 2.0 offer in
/updateoropencode upgrade --major. - CoreFix upgrades for installs managed by yarn.
- CoreSkip 1.x updates for Homebrew Core installs, which now track OpenCode 2, and check tap and Chocolatey availability before offering an update.
- CoreThe install script refuses to install 2.x versions.
- CoreUpgrading to OpenCode 2 remains a separate, explicit choice through the 2.0 offer in
v1.19.1 Session sharing has been discontinued
Session sharing has been discontinued. Existing share links and session-sharing commands are no longer available, and importing sessions from share URLs is unsupported.
v1.19.0 Run
opencode upgrade --majorto upgrade to OpenCode 2Improvements
- TerminalUse
/updateto install OpenCode updates or upgrade to OpenCode 2; updates are no longer installed automatically.
Fixes
- CoreAllow the OpenAI
ultrafastservice tier. - CoreValidate PTY connection origins and tickets before checking whether a PTY exists.
- TerminalUse
v1.18.35 Added canonical redirects and JSON and Markdown data formats for agent-readable stats
Fixes
- CorexAI tool results now include supported images, while unsupported image formats are skipped.@Jaaneek
v1.18.34 Send namespaced session and parent-session identity headers with model requests
Fixes
- CoreRe-sign locally compiled macOS binaries so they run reliably on macOS 27+.@ryangamerdev
- CoreSign macOS CLI release binaries with a Developer ID.
v1.18.33 Cloudflare AI Gateway models now honor provider response and stream timeouts
Fixes
- CoreMCP browser launch failures are now reported when the launcher exits immediately.
- CoreDebug configuration output now redacts credentials and sensitive headers.
- CoreGemini thinking defaults and effort options now match the supported controls across model generations.@markmcd
v1.18.32 Fixed Bedrock image attachments so they are only hoisted for Claude, Nova, and Llama 4 models
Fixes
- CoreFixed Together AI streaming usage reporting.