Skip to content
  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

    • 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
    • DesktopAdd a persistent desktop zoom setting.#59277
    • DesktopCapture heap snapshots in desktop debug builds on SIGUSR2 when explicitly enabled.#58317
    • DesktopShow the open session title in the browser tab.#59131
    • DesktopLoad session history once when returning to a session tab.#59166
    • DesktopAnswer questions with number keys and show multi-select choices as checkboxes.#58595
    • DesktopLet you edit line comments and copy shell output.#58970#58974
    • DesktopRender Mermaid diagrams in messages much faster, sized to fit the column.#57483#57004
    • DesktopAdd opt-in memory logging and remote debugging for desktop debug builds.#58315
    • DesktopShow web sources for a turn behind the experimental Sources setting.#58307
    • DesktopJump from a completed shell notification to its shell output.#58663
    • DesktopKeep the composer usable while the voice-call panel floats.#58587
    • DesktopUse the Soft Radar activity spinner by default and provide experimental variations.#58010#57903
    • DesktopAdd an experimental new model picker.#58413
    • DesktopAdd experimental Console voice calls in Desktop beta.#58249
    • DesktopAdd a timeline width setting.#58308
    • DesktopImprove command, session, and model search lists with sticky sections.#58222
    • DesktopAdd search to recently closed sessions.#55721
    • DesktopOpen extension configuration and skills in side tabs.#58023
    • DesktopOpen session extension lists on hover and follow keyboard navigation.#58021
    • DesktopAdd video previews with zoom controls.#57924
    • DesktopAdd generated project avatars and an experimental avatar-style switcher.#57871#57930
    • DesktopAdd recently closed side tabs to the new-tab view.#57863
    • DesktopAdd a searchable prompt history picker.#57716
    • DesktopFind settings from the command palette.#57651
    • DesktopGroup queued and steered messages, and group consecutive user messages under one metadata line.#57561#57552
    • DesktopImprove file-tree and folder-picker performance.#57573#57557
    • DesktopKeep branch search results visible while new results load.#57531
    • DesktopAdd a session-details menu to the session header.#57528
    • DesktopShow a subagent's model, status, and elapsed time in its composer area.#57473
    • DesktopLet you delete sessions from tab menus and rename the current session with Ctrl+R.#57453#57423
    • DesktopRestore session summary and project menu actions.#57781
    • DesktopAdd text-rendering controls to the debug bar.#57326
    • DesktopShow elapsed time for background work.#57218
    • DesktopImprove streamed Markdown rendering reliability and performance.#57016
    • DesktopSplit the side pane and add a draggable bottom pane with tabs.#56960
    • DesktopOpen multiple file tabs at once and open side-panel content in tabs.#57182#57094
    • DesktopMove running work to the background when you steer a session.#57142
    • DesktopLet the timeline scroll beneath the composer while keeping its content visible.#57141
    • DesktopQuote selected timeline or terminal text into the composer.#55664#58420
    • DesktopAdd a Reduce motion appearance setting.#57103
    • DesktopAttach the new-session location picker below the composer.#56952
    • DesktopOpen image previews directly from message and composer thumbnails.#56896
    • DesktopAdd a sidebar toggle for vertical tabs.#55646
    • DesktopAdd ⌘1–9 and ⇧⌘[ / ⇧⌘] shortcuts for side-panel tabs.#57301
    • DesktopLet you choose a new directory or worktree when a session location is unavailable.#56087
    • DesktopRefresh the Manage models, MCP, and fork dialogs with compact searchable lists.#56029#56028
    • DesktopInstall future Windows desktop updates in about a second.#55933
    • DesktopShow individual Code Mode tool calls in Execute rows.#55649
    • DesktopAdd a Commentary timeline category and display setting.#55248
    • DesktopSupport @ links to other sessions in messages.#57480
    • DesktopPolish spacing, alignment, borders, and typography across the session header, titlebar, composer, file tree, browser pane, timeline, and Settings.#58195#57776#57570#57782#57336#57363#58100#58979

    Fixes

    • 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 codemode settings during migration.#59126@tneemo
    • CoreUse the correct Vertex AI endpoints for the eu and us multi-regions.#59335
    • CoreAccept Databricks hosts that include http:// or https://.#59334
    • CoreKeep files intact when patch edits move a file onto itself.#59197
    • CorePreserve literal $0 and $ARGUMENTS text 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 execute permission 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_k settings 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 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
    • DesktopPrevent duplicate tab shortcuts and remove uninstalled plugin commands from Shortcuts.#59499
    • DesktopKeep todo items from shrinking in the todo panel.#59430
    • DesktopKeep question-dock answers and controls positioned correctly when changing questions.#59383
    • DesktopKeep the @ menu open while it searches.#59425
    • DesktopFinish quitting after Cmd+Q on macOS.#59144@anmol0b
    • DesktopToggle MCP servers for the current session location from Settings.#59132
    • DesktopDeliver steering messages when an earlier move was missed.#58984
    • DesktopKeep session and command-palette search results stable while searching.#58908#57479
    • DesktopRestrict Search projects to the project list.#58978
    • DesktopLet custom Close tab shortcuts close terminal and browser tabs.#58945
    • DesktopPrevent live status rows from jumping or leaving gaps above the composer.#58691#58697
    • DesktopKeep browser tabs still behind open dialogs.#58958
    • DesktopKeep side-panel content and browser pages visible while the sidebar or panel moves.#58202#58185
    • DesktopRender session diffs reliably.
    • DesktopKeep keyboard focus in terminals, side panels, dialogs, and the composer when appropriate.#57980#57297#56273
    • DesktopPreserve empty browser and side-panel tabs instead of closing them automatically.#58440
    • DesktopReduce desktop memory use by releasing closed transcripts, discarded tool-result images, retained UI batches, and aborted timeline work.#57025#58434#58427#58560#58447#58439#58432
    • DesktopRestore horizontal scrolling and sticky change badges in the file tree.#58117
    • DesktopShow live Thinking for reasoning-only turns.#58299
    • DesktopStop loading older history after completing the initially visible turn and prioritize the first transcript page.#57700#57741
    • DesktopKeep Home project and session lists reliable during refreshes.
    • DesktopKeep deleted sessions from reappearing on Home.#55349
    • DesktopFind sessions immediately in @ mentions, including multi-word titles.#57683
    • DesktopKeep queued messages editable while changes sync with the server.#57569
    • DesktopOpen image and video URLs in the browser pane.#57562
    • DesktopMark submitted generated forms as complete and send each response only once.#57537
    • DesktopImprove file-view performance with reused views, virtualized medium files, and cached diffs.#57551
    • DesktopGroup untracked folders into one expandable review row.#57527
    • DesktopLet you paste into the composer from the session view.#57545
    • DesktopRecover failed beta background servers and preserve their required CLI versions.#57321
    • DesktopKeep the running server available while beta updates install.#57309
    • DesktopMake links in user messages, shell output, and Code Mode output clickable.#57211#57303
    • DesktopMake Check for Updates always report its result.#57296
    • DesktopReopen the last closed side-panel tab with ⇧⌘T and open a browser tab with ⌘T.#57269#57156
    • DesktopKeep OpenCode keyboard shortcuts working in the browser pane.#56697#55240
    • DesktopPreview image attachments supplied by file path.#57249
    • DesktopApply configured code and UI fonts consistently.#57242
    • DesktopKeep activity and busy indicators steady while switching sessions.#57196
    • DesktopReserve ⇧⌘W for closing the window so ⌘W does not.#57150
    • DesktopMake image preview transitions resize smoothly without clipping or blocking clicks.#56997#57324
    • DesktopReturn focus to the prompt after keyboard model selection.
    • DesktopKeep tables visible beneath sticky headers.#57050
    • DesktopFit provider connection steps without shifting a dialog's top edge.#57006
    • DesktopGive unavailable-server panels clear error styling.#57003
    • DesktopKeep long Execute tool code contained and show successful Code Mode output.#56915
    • DesktopFocus the most useful control when dialogs open, including Cancel in delete confirmations.#57453
    • DesktopInstall Windows beta, stable, and nightly builds into separate directories.#56904
    • DesktopKeep session tabs recoverable when their server becomes unreachable.#56248
    • DesktopKeep the composer model's provider and session-model resolution consistent with the TUI.#56225
    • DesktopReread open files without resetting their scroll position.#55899
    • DesktopHide agent names when agents are disabled.#57525
    • DesktopPolish sidebar, panel, composer, activity, question-dock, loading, and motion behavior across light and dark themes.#57449#58013#58577#57944#58052#58494#58073#58114
    • DesktopPolish hover states, cursors, tooltips, focus rings, scrollbars, and transitions across desktop controls.#57653#57787#57304#58971#57221#57192#58575#58580
    • 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