Skip to content

Changelog

New updates and improvements to OpenCode

  1. v2.2.1

    Keep Working Toward a Goal

    Run /goal <objective> in the TUI or Desktop to let the session continue until a reviewer confirms the objective is met. Use /goal pause, /goal resume, or /goal clear to control it.#59437

    Generate Images

    Enable experimental.image_generate to let agents create or edit images with the new image_generate tool. You can optionally set its default model with experimental.image_generate.model.#59939#60096

    Inspect Background Shells

    Click a running shell in the Desktop activity pill to see its live output and stop it without leaving the menu.#59496

    New Default Model Picker

    Search favorites, recent models, providers, and variants from the redesigned model picker, which is now the default in Desktop.#59997

    Breaking changes

    @opencode/ai provider removals and renames

    These changes affect code that imports @opencode/ai directly. They don't change the CLI, Desktop, or the HTTP API.

    • The fal, Black Forest Labs, Replicate, and Stability providers are removed, along with their ./providers/fal, ./providers/black-forest-labs, ./providers/replicate, and ./providers/stability entry points.
    • Five legacy entry points are removed. Import the nested paths instead, which 2.2.0 already exports: ./providers/amazon-bedrock-mantle → ./providers/amazon-bedrock/mantle, and ./providers/google-vertex-chat, -interactions, -mistral, and -responses → ./providers/google-vertex/chat, /interactions, /mistral, and /responses.
    • Each provider's configure() input type is now named Config, for example Groq.LanguageModelOptions → Groq.Config, and model() settings are optional when every setting is optional.
    #59977#59506#59765

    Improvements 15

    15 more improvements

    Fixes 17

    17 more fixes
  2. v1.19.5
  3. 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
  4. 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.

  5. 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.
  6. 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.

  7. 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.
  8. 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
  9. 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.
  10. 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