Changelog
New updates and improvements to OpenCode
v2.2.0 Create, install and share Desktop plugins (experimental)
Refreshed the desktop app experience
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
Restored the Todo tool in desktop via opt-in
Add configurable prompt cache TTLs per provider/model
Breaking changes
@opencode/airoot is now the Promise API@opencode/ainow works like@opencode/sdkand@opencode/client: the package root exports the Promise API, and the Effect API moved to@opencode/ai/effect.@opencode/ai/promiseis removed, and the wildcard subpath export is replaced with an explicit list of provider and protocol entry points.
#58847#59183-import { AI } from "@opencode/ai/promise" -import { LLM } from "@opencode/ai" +import { AI } from "@opencode/ai" +import { LLM } from "@opencode/ai/effect"The OpenCode GitHub Action is removed
The OpenCode GitHub Action is no longer published. Remove it from your workflows.
#59032TUI 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.
78 more improvementsImprovements 78
112 more fixesFixes 112
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 +1 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.Improvements
- CoreConfigure model reasoning options to generate reasoning variants, replacing catalog variants while preserving your configured variant overrides.
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.
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.
v1.18.31 Request summarized adaptive thinking for GitHub Copilot models
Fixes
- CoreRestored ACP session model, effort, mode, and reasoning chunk boundaries when loading, resuming, or forking sessions.@JacobNWolf
- TerminalShow remote config authentication errors during startup and exit with a failure status.