Skip to content

Changelog

New updates and improvements to OpenCode

  1. v2.3.1

    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

    See all highlights in v2.3.1

    Improvements 7

    • Core, SDKServer 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
    • Core, SDKExperimental 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
    • TerminalPermission 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
    • TerminalThe export dialog under the new designs can save to the system temp directory as well as the project folder. Thanks @Tarquinen.#62490
    • TerminalRemoved time to first token (ttft) from the assistant message footer. Tokens per second still shows when session.tps is on.#63759
    • ExtensionsEach 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
    • ExtensionsPlugin SessionIdleBackground items can now be { kind: "codemode", sessionID, jobID }, and GUI plugin BridgeLayout accepts an optional clip rectangle.#64343#63819

    Fixes

    • TerminalWhen another TUI sharing your tabs closes the session you're viewing, closing it here now moves to the neighbouring tab.#64261
    • TerminalFixed broken characters at the edges of the shell output viewer and the inline shell display when output is long.#63967#63984
    • SDKApps 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
    • ExtensionsThe browser extension's URL bar action buttons are now spaced 6px apart.#64214
  2. v2.3.0

    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

    See all highlights in v2.3.0

    Improvements 11

    • TerminalSession IDs found in messages can now be opened directly.
    • TerminalActivity tabs are clickable and open the correct view.
    • TerminalShell mode has its own prompt color under the new designs.
    • SDKEvent subscriptions can now receive experimental.mcp.event events from MCP event subscriptions.
    • SDKModel capability schemas now advertise supported freeform tool-input formats.
    • SDKSession throughput is now measured from the first streamed token.
    • SDKSession creation documentation now clarifies the parentID field.
    • ExtensionsPromise-based tools can cooperatively stop through ToolContext.signal.
    • ExtensionsAdded the experimental session.fork hook.
    • ExtensionsPromise plugin cleanup failures no longer prevent subsequent plugin replacements.
    • Extensions@opencode/plugin/effect now exports Tool, so an execute.before hook can reject a call with Tool.Error without importing @opencode/schema/tool.#63698

    Fixes 9

    • TerminalRestored pasted text when undo brings back its placeholder.
    • TerminalRestored the live draft after browsing prompt history.
    • TerminalFixed copying a paste from within the prompt selection.
    • TerminalPreserved the Mini composer caret when closing the command palette.
    • TerminalPrevented image bytes from being retained in transcript storage when image previews are disabled.
    • TerminalFixed paste-chip contrast across light and dark themes.
    • TerminalFixed plugin-provided themes updating live.
    • TerminalSession lists now open at the top rather than at the current session.
    • TerminalMini scrollback now shows the subagent card instead of obsolete launch instructions.
  3. v2.2.7

    The update and confirm dialogs have buttons you can move between with ←/→ and Tab/Shift+Tab

    See all highlights in v2.2.7

    Breaking changes

    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

    Improvements

    • TerminalThe model picker no longer has a Usage action; use /usage instead.#62927
    • SDKsession.generate returns tokens and cost along with text.#62835
    • SDKcredential.updated includes the integrationID and credentialID of the login that changed.#62762
    • SDKPredicate questions in client.experimental.generate.decisions accept optional criteria: { true?, false? }.#62819
    • ExtensionsACP clients can redirect a running turn with the _session/steering extension, advertised as _meta.steering.supported in initialize.#54394@smagnuso

    Fixes

    • TerminalSession exports are saved in the current working directory instead of the system temp folder.#62253
    • TerminalTyping a child session's exact ID in the open-session menu lists that session.#62262
    • TerminalThe TUI follows the terminal's current light or dark mode instead of a cached palette.#62248
  4. v2.2.6

    GUI Plugin Themes and New Slots

    GUI plugins can now add color themes, render or add actions to code blocks, and use native settings and menu components.#61485#61533#61527#61509

    See all highlights in v2.2.6

    Improvements

    • TerminalAdded Scroll on send in Settings. Choose Keep (session.submit_scroll: "keep") to retain your reading position after submitting a prompt.#61460
    • SDKAdded client.experimental.job.list() and its Effect equivalent for listing background shell, subagent, and image jobs, with session, descendant, kind, and status filters.#60698
    • SDKServer embedders can provide a custom fetch implementation for OpenCode HTTP, model, web, and remote MCP traffic.#61582

    Fixes 11

    • TerminalAllow Ctrl+Z to suspend OpenCode while a form or dialog is open.#62118
    • TerminalKeep focus on an open dialog when a question arrives and contain plugin dialogs that throw during rendering.#60365#62110
    • TerminalShow an error when Ctrl+V cannot read the clipboard. Thanks @jimmyallinai.#61094
    • TerminalPrevent session titles containing newlines from crashing the TUI. Thanks @vishalshekhar.#57523
    • TerminalImproved message spacing and prevented older history from flashing while scrolling.#62104#59236
    • TerminalJump to the first or last message with Home, End, and Ctrl+G in subagent sessions. Thanks @ricky9408.#60817
    • TerminalKeypad Home, End, Page Up, and Page Down now navigate the transcript like the main keys in terminals that use the kitty keyboard protocol. Thanks @argszero.#59770
    • Terminalopencode mini now uses the agent colors from your config. Thanks @ferdinandyb.#62067
    • TerminalReturn to the /mcp list after signing in to an MCP server, with that server still selected. Thanks @Tarquinen.#62245
    • TerminalAllow favoriting models with Ctrl+F in /models when they come from a provider declared in config or an add-on instead of a saved connection. Thanks @Tarquinen.#62244
    • ExtensionsIsolated plugin dialogs, Markdown renderers, terminal views, lazy chunks, and artifact viewers so failures do not take down their host surface.#62110#62123#61993
  5. v2.2.5

    The connect menu no longer lists MCP servers

    The connect menu no longer lists MCP servers, which are managed in their own place.#60675

    See all highlights in v2.2.5
  6. v2.2.4

    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

    See all highlights in v2.2.4

    Improvements

    • SDKExtended client.experimental.persistentPty.update to rename terminals or clear a user title, and exposed userTitle plus persistent-pty.updated events.#60329

    Fixes

    • TerminalPreserved prompt cursor styles applied by plugins when themes or unrelated prompt state change.#60599
    • TerminalAdded missing right padding to edit and patch diffs.#60614
    • TerminalExtended the vertical session-tab activity pulse across the full tab width.#60338
  7. v2.2.3

    Added lazy loading for stored image references when experimental.media_blob is enabled

    Added lazy loading for stored image references when experimental.media_blob is enabled. Images are downloaded only for previews, while undo, revert, fork, and prompt recall restore referenced attachments safely.#60116

    See all highlights in v2.2.3

    Breaking changes

    TUI plugins require OpenTUI 0.8

    @opencode/plugin now requires @opentui/core and @opentui/solid 0.8.0 or later. In OpenTUI 0.8, a ScrollBox's wrapper, viewport, content, and scrollbars are facade objects instead of renderables, and a custom RenderContext must implement clock and onAnimationTick. See the OpenTUI 0.8.0 release notes.

    #60385

    Improvements

    • TerminalAdded a distinct marker for the selected composer suggestion in the new designs.#60393
    • SDKPreserved partial LLMResponse output on AIError.partial when generation, object generation, or a tool loop fails.#60477
    • SDKUnified Effect and Promise tool declarations around tool(...), with optional output schemas and executable or declaration-only tools.#60407
    • SDKAdded typed OpenRouter debug, models, plugins, provider, and user options to the Responses route.#60044
    • ExtensionsAdded persistent-terminal renaming to the process daemon, including capability discovery and user titles that override shell-provided titles until cleared.#60324

    Fixes 10

    • TerminalFixed PHP syntax highlighting for code blocks without an opening <?php tag.#60359
    • TerminalPreserved # in file-search paths unless it introduces a valid line range.#60336
    • TerminalKept the configured default cursor style after config reloads.#60302
    • TerminalMatched the search cursor to the highlighted row when a selection dialog has no query.#60310
    • SDKMatched the Promise AI client more closely to the Effect API and accepted typed tools in loops.#60465#60390
    • SDKKept tools whose execute handler can throw available to the AI client.#60431
    • SDKContinued polling queued media generations when providers return unknown intermediate statuses.#59988
    • SDKStopped sending an incompatible filename alongside file_url on OpenAI Responses requests.#60382
    • ExtensionsPreserved null values in Code Mode text encoding.#57639@xiajiahang
    • ExtensionsTidied nested Extensions menus.#59468
  8. v2.2.2

    Unified Quotes and Annotations

    Timeline quotes, terminal quotes, and browser annotations now share a compact optional-comment editor, while source highlights remain attached to local drafts.#60164

    See all highlights in v2.2.2

    Improvements

    • SDKAdded if and until inputs for client.experimental.schedule.create, plus schedule check results and output fields.#60137
    • SDKExposed SessionInfo.time.busy for the latest execution’s start time.
    • SDKAdded optional source metadata to prompt file attachments.

    Fixes

    • TerminalPreserved captured attachments and their original source paths.#60222@OpeOginni
    • TerminalPrevented middle-truncated paths from overflowing at very narrow terminal widths.
    • TerminalImproved Go usage-limit messages with the reset time and account page link.
    • TerminalCorrectly typed and displayed Go and ChatGPT usage-limit errors.
    • ExtensionsCorrected visible flowchart edges connected through Merman subgraphs.
  9. 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

    See all highlights in v2.2.1

    Improvements

    • SDKAdd client.experimental.schedule.{create,list,get,pause,resume,delete} for managing scheduled prompts.#59457
    • SDKGroup experimental generated-client methods under client.experimental; previous locations remain as deprecated aliases until the next minor release.#59072
    • SDKExpose compaction through the Promise AI client.#59987
    • SDKAdd freeform tool support and Responses routes for OpenRouter, DigitalOcean, and Venice.#59963#59991
    • ExtensionsLet Code Mode extension globals return Effects and declare required services.#59948

    Fixes

    • TerminalShow execution failures that occur before the first model step.#60079
    • TerminalKeep the activity spinner visible while a continued subagent runs.#59950
    • TerminalSend pasted image and PDF paths correctly when connected to a local server.#59833
    • TerminalImprove spacing in an empty /usage dialog.#59918@Tarquinen
  10. v2.2.0

    Create, install and share Desktop plugins (experimental)

    See all highlights in v2.2.0

    Breaking changes

    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

    • 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 15

    • TerminalReturn opencode run --format json server 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 --server and --standalone anywhere 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