Skip to content

Changelog

New updates and improvements to OpenCode

  1. v2.2.0

    Create, install and share Desktop plugins (experimental)

    Refreshed the desktop app experience

    #56898#58865#55838#57962

    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

    #59092

    Add configurable prompt cache TTLs per provider/model

    #59157

    Breaking changes

    @opencode/ai root is now the Promise API

    @opencode/ai now works like @opencode/sdk and @opencode/client: the package root exports the Promise API, and the Effect API moved to @opencode/ai/effect. @opencode/ai/promise is removed, and the wildcard subpath export is replaced with an explicit list of provider and protocol entry points.

    -import { AI } from "@opencode/ai/promise"
    -import { LLM } from "@opencode/ai"
    +import { AI } from "@opencode/ai"
    +import { LLM } from "@opencode/ai/effect"
    #58847#59183

    The OpenCode GitHub Action is removed

    The OpenCode GitHub Action is no longer published. Remove it from your workflows.

    #59032

    TUI plugins require OpenTUI 0.7

    @opencode/plugin now requires @opentui/core and @opentui/solid 0.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: assign renderBefore, renderAfter, and onLifecyclePass in the constructor instead of as class fields, call refreshHooks() after adding a hook by reflection, and replace defineNativeIntegration() with a static nativeIntegration declaration. See the OpenTUI 0.7.0 release notes.

    #59295

    Improvements 78

    78 more improvements

    Fixes 112

    112 more fixes
  2. 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.

  3. 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-ai latest 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 /update or opencode 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.
  4. 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.

  5. v1.19.0

    Run opencode upgrade --major to upgrade to OpenCode 2

    Improvements

    • TerminalUse /update to install OpenCode updates or upgrade to OpenCode 2; updates are no longer installed automatically.

    Fixes

    • CoreAllow the OpenAI ultrafast service tier.
    • CoreValidate PTY connection origins and tickets before checking whether a PTY exists.
  6. 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
  7. 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.
  8. 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
  9. v1.18.32
  10. 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.