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

    Update Plugins from Settings

    Open Settings › Extensions, click Check for updates, then Update on any plugin with a new version.#64511

    Comment on Selected Code

    Selecting code in diff and file viewers now just selects it, so you can copy it, and an Add comment toolbar appears beside the selection.#64410

    See all highlights in v2.3.1

    Improvements 20

    • 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
    • DesktopYou can check for and install plugin package updates from Settings › Extensions. Use Check for updates to look for new versions, then click Update on any plugin that has one.#64511#64525
    • DesktopCmd+F (Ctrl+F) now finds text in Markdown, Mermaid, CSV and HTML previews in the side panel, using the same find bar as the code view.#63663
    • DesktopDisconnecting a provider or removing an account in Settings → Providers now asks for confirmation first. Disconnecting OpenCode Console says how many providers will stop working.#64212
    • DesktopThe model picker's variant flyout now follows the keyboard: it opens beside the highlighted row, → enters it to pick a variant or toggle Favorite, and ← or Escape goes back. A model's Console budget and reset time now show in the flyout.#64409#64423
    • DesktopWhen New worktree is selected for a new session, the composer shows the base branch (from dev ▾). Click it to pick another base; the choice applies immediately, and Use main checkout switches back.#64228
    • DesktopRedesigned the folder picker for remote servers, with a path bar, up to three recent-project pills plus a More projects menu, and a search box that shows the selected folder.#64241
    • Desktop `latex and `math code fences now render as display math once complete.#64380
    • DesktopThe new icon set is now the default, and the New icons experiment has been removed.#64466#64451
    • DesktopThe copy button under assistant messages is now always visible. Message metadata still appears on hover.#64478
    • DesktopText files opened in side-panel tabs now have the same copy and download actions as other files.#64463
    • DesktopManage models now shows every provider as a card with a ⋯ menu, whether or not you're signed in to OpenCode Console.#64235
    • DesktopThe connect provider dialog has a cleaner layout for every sign-in step: breadcrumbs, method icons, full-width device codes, and a "Signing in from another device?" row for pasting a redirect URL.#63829
    • DesktopCollapse long messages is no longer experimental. It is now a setting under Timeline preferences.#64441
    • DesktopSettings now opens on your client preferences, which are listed first, pairing is grouped with Servers, and there's a Help & feedback link.#64440#64220
    • DesktopPairing QR codes can carry a server name, which becomes the paired server's default name.#64139
    • DesktopImage attachment thumbnails are larger, with a 3:2 crop, and a failed image no longer moves the message below it when retried.#64215
    • DesktopThe Hex voice tip no longer appears when Hex is already installed, its copy now says what Hex is, and tips wait an hour after first launch before the first one shows.#64130#64131#63974#63760
    • DesktopAdded missing translations for every non-English language, about 920 strings each.#64205

    Fixes 12

    • DesktopFixed the desktop app failing to start when drafts.sqlite was a symlink to or copy of the CLI's opencode.db. The desktop now moves that file aside and creates its own, leaving the CLI database untouched.#64203
    • DesktopSwitching session tabs with a keyboard shortcut now focuses the composer.#64418
    • DesktopLong prompts now stay folded while a new session is being created.#64452
    • DesktopOn macOS, the browser pane stays live while you resize panels instead of showing a still image.#64443
    • DesktopSubmenus now open one at a time and swap without blinking, and stay open while you move the pointer across other items to reach them.#63739
    • DesktopPressing a button now dismisses its tooltip until you hover it again, and copy buttons show "Copied" for two seconds, including in the /btw panel.#63834
    • DesktopDialogs now use consistent sizes, corner radius and row styles across the command palette, session search, model picker, location picker and other lists.#63432#64216#64206
    • DesktopSessions on OpenCode Go no longer show a $0.00 cost.#63744
    • DesktopUse main checkout now stays on one line in the branch picker, and wrapped question descriptions have better spacing.#64450#64446
    • DesktopRestyled the Timeline detail slider and visibility buttons in settings so they read as clickable.#64186
    • DesktopPolished small details: animated counts no longer look faded at rest, the sidebar resize pill is hidden, the sidebar peek insets match, subagent breadcrumbs show a hover background, and screen readers name the redirect URL field after its label only.#64155#64219#64192#63742#63885
    • 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
  2. v1.19.6

    OpenCode 1 now offers the upgrade to OpenCode 2.0

    OpenCode 1 now offers the upgrade to OpenCode 2.0. OpenCode 2 downloads in the background and installs only when you choose: Restart to upgrade, Upgrade on quit, or Later. Your sessions, projects, and settings are kept. Plugins made for OpenCode 1 need an update.

  3. v2.3.0

    Jump to an Earlier Prompt

    In the desktop app, open Jump to message from the command palette or press Cmd+Alt+G (Ctrl+Alt+G on Windows and Linux) to search prompts across the current session and jump directly to one.#63585

    See all highlights in v2.3.0

    Improvements 13

    • DesktopAdded the experimental Recent sessions sidebar, with cross-server recency, local pins, reordering, and standard session-row actions.
    • DesktopRecent sessions are limited to the last seven days and 30 rows, and can be hidden or muted.
    • DesktopAdded an experimental customizable sessions sidebar.
    • DesktopMermaid diagrams can now be maximized for zooming and panning.#59250
    • DesktopAdded Alt+Enter to place a follow-up first in the queue and Mod+Enter to steer the next queued prompt.
    • DesktopHolding the modifier key now shows tab shortcut numbers.
    • DesktopEach server’s terminal shell can be selected from its menu.
    • DesktopAdded a free-limit panel in place of the composer when applicable.
    • DesktopSession IDs are easier to find and copy.
    • 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.

    Fixes 13

    • DesktopRecent sessions now keep stable recency ordering through list reloads, renames, and completed runs.
    • DesktopFixed browser panes not retrying after server plugins finish loading.
    • DesktopFixed mention suggestions being recreated while typing.
    • DesktopFixed SSH prompts failing to advance or close after connection.
    • DesktopFixed pasted provider-auth redirect URLs being rejected.
    • DesktopRestored message footers in the New timeline.
    • DesktopFixed links whose labels contain inline code.
    • DesktopFixed the desktop main process freezing while probing the login-shell environment.
    • DesktopFixed the drag region after changing layout direction.
    • DesktopFixed vertical-tab previews snapping to the wrong tab.
    • DesktopFixed the file-tree sidebar opening animation.
    • DesktopFixed pairing QR-code contrast in light themes. Thanks @ssskay.#63220
    • DesktopFixed activity-tab navigation and click handling. Thanks @OpeOginni.#60168
  4. v2.2.7

    Side Panel Tab Shortcuts

    Right-click a side panel tab and choose Close tabs to the right. ⌘W now closes side panel tabs wherever focus is, ⌥⌘W or Ctrl+Alt+W always closes the session tab, and ⌘⇧T reopens the last closed tab of either kind where it was.#62922

    Mark Sessions Read or Unread

    Open the menu on a tab, Home row, project row or inbox card and choose Mark as unread to keep its dot until you next visit.#62889

    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

    • DesktopThe answer you pick in the question dock shows as a raised card.#62896
    • DesktopInline rename and custom-answer fields no longer show a focus border.#62919
    • 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

    Fixes 7

    • DesktopOn Windows and Linux, Ctrl+Shift+R toggles the review panel again instead of reloading the window.#62567
    • DesktopClosing the last side panel tab slides the panel shut.#62758
    • DesktopSelects, menus, tooltips and toasts opened from a dialog are reachable by screen readers.#62913
    • DesktopAn error appears when a path can't be opened in its default app.#62572
    • DesktopCut, Copy, Paste and Select All in the right-click menu follow the app language.#62252
    • DesktopUkrainian tool titles use nouns.#62263
    • DesktopScrolling titlebar search results no longer jumps back when late results arrive, the inbox no longer announces already-running sessions as working on load, and the quote toolbar comes back after Escape.#62597
  5. v2.2.6

    Mobile Composer Dock

    On phones and tablets, composer actions now sit in a touch dock above the keyboard with larger buttons.#61773

    See all highlights in v2.2.6

    Improvements 8

    • DesktopAdded close-other-tabs and close-tabs-after actions to the tab menu.#61631
    • DesktopAdded unread-session grouping in Inbox and failed-run indicators on tabs.#61691#62077
    • DesktopMCP sign-in now accepts a pasted redirect URL when automatic redirection is unavailable.#61706
    • DesktopMarkdown file previews now display frontmatter as a properties list.#60333
    • DesktopThe command palette shows a date instead of "Xd ago" for sessions 7 or more days old. Hover the time to see the full date and time.#62314
    • DesktopPrompt history now keeps up to 200 prompts. Past the newest 100, only prompts without attachments are kept.#62313
    • 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 10

    • DesktopImproved prompt submission and timeline behavior during loading, reconnects, retries, scrolling, compaction, and optimistic delivery.#62025#62037#61932#62151
    • DesktopSurface loading and offline failures in review previews, file search, details, Word pages, and review diffs instead of showing empty or clean results.#62114#61862
    • DesktopFixed provider connection, MCP sign-in, settings, and plugin loading flows that could become stuck after failures.#62102#61917#61580
    • DesktopPreserve drafts, focus, caret position, queued prompts, and selected terminal tabs across failed or concurrent transitions.#61579#61969#61852
    • DesktopRestart plugins after failed update handoffs and recover the renderer, storage, event stream, and background-service connection from transient failures.#61649#61908#61804#61748
    • DesktopCorrected V2 file labels and mention syntax. Thanks @velmet and @cheapredwine.#55677#60737
    • DesktopAttach only the @mentions in a line comment that match an existing file or folder, so a comment such as Check @here no longer fails the send. Render partial diffs in the review pane when it shows all lines, instead of a blank pane. Thanks @Tarquinen.#62242#62241
    • DesktopKeep pasted images sendable after the clipboard tool deletes its temporary file. Thanks @lfscqk67.#62057
    • DesktopWhile an input method is composing text, Escape, Enter, and Tab go to the input method instead of stopping the agent or picking a suggestion.#62318
    • DesktopFixed padding in the WSL distribution picker, the position of worktree and branch labels in Home search results, and the selected ring on the Interface layout setting. Thanks @inuyume.#53676#62317#62309
  6. v2.2.5

    Worktree and Shell Mode Shortcuts

    Press ⌘⌥O on macOS or Ctrl+Alt+O on Windows and Linux to choose a worktree, and ⌘⌥B or Ctrl+Alt+B to choose its base branch. ⌘⇧X or Ctrl+Shift+X now toggles shell mode in the composer.#60713

    Send Quotes From the Comment Popup

    Hold ⌘ or Ctrl in the quote popup to turn its checkmark into send, or press ⌘Enter or Ctrl+Enter, to send just that quote and comment while leaving the rest of the composer untouched.#60640

    See all highlights in v2.2.5

    Improvements

    • DesktopAdded flat input surfaces and a compact input size.#60598

    Fixes

    • Terminal, DesktopThe connect menu no longer lists MCP servers, which are managed in their own place.#60675
    • DesktopAdded the missing top inset to the search field in the recently closed menu.#60652
  7. v2.2.4

    Persistent Desktop Terminals

    Desktop terminals now belong to the session, survive server restarts with their scrollback, and stay synchronized with the TUI and other windows. Renamed terminals also keep their names across restarts.#60346

    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

    Guided Claude Agent Setup

    Select Claude Agent from the provider picker to copy claude auth login, install Claude Code, and verify the connection before continuing to model selection.#60603

    Choose a Base Branch Quickly

    While creating a worktree, open Choose base branch with ⌘⌥. on macOS or Ctrl+Alt+. on Windows and Linux. The command is also available in the command palette and Settings › Shortcuts.#60579

    Improvements

    • DesktopSimplified the session location popover and made long paths easier to read.#60492
    • SDKExtended client.experimental.persistentPty.update to rename terminals or clear a user title, and exposed userTitle plus persistent-pty.updated events.#60329

    Fixes

    • DesktopKept terminal tab clicks and rename fields attached to the intended tab.#60645
    • DesktopListed matching commands before sessions in command-palette search.#60616
    • DesktopRestored copying user messages from an open actions menu.#60576
    • DesktopReduced repeated work and allocations while streaming Markdown, especially in long sessions.#60549#60562#60577
  8. v2.2.3

    Faster Long Sessions in Desktop

    Streaming replies and long conversations now do much less rendering work.#60489#60521#60513#60481

    Desktop Stability Fixes

    Fixes side-panel tabs, repeated "Session not found" toasts, and Open file over HTTP.#60430#60436#60459#60462

    See all highlights in v2.2.3

    Improvements 12

    • Terminal, SDKAdded 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
    • DesktopAdded a Desktop spellcheck toggle under Settings → General and system-language dictionary selection on Windows and Linux.#59129
    • DesktopAdded PageUp and PageDown timeline paging from the composer without moving the draft cursor or focus.#59426
    • DesktopAdded independently configurable question notifications and sounds under Settings → Notifications → Questions.#60358@YuriNek0
    • DesktopAdded separate project and worktree actions to the new-session control.#60486
    • DesktopAdded one-click version copying in Settings → About.#52356
    • DesktopGrouped added projects in workspace settings.#60221
    • DesktopMade question-answer text selectable.#60372
    • DesktopAdapted the session header to narrow timeline widths.#59512
    • 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

    Fixes 15

    • DesktopKept question options and submit controls reachable on mobile.#60335
    • DesktopPreserved simultaneous request notifications and inbox scroll position when opening sessions.#60378#60356
    • DesktopFixed consecutive dropped files so every file mention is inserted into the composer.#60463
    • DesktopKept the current @ and command-menu selection stable while results update under a stationary pointer.#59434#60368
    • DesktopFixed ⌘W side-panel closing and focus restoration when no closable tabs remain.#59002#60435
    • DesktopKept the mobile session drawer open while a session loads.#59427
    • DesktopRestored maximized windows on their saved display and retained renderer permissions across shared-session windows.#60482#60458
    • DesktopFixed timeline growth, zoom-end scrolling, highlighting, and DOM-observer performance issues in long sessions.#60489#60481#60488#60513#60521
    • DesktopKept models with unknown release dates visible.#60496@joe-ieta
    • DesktopFixed reasoning-capability detection for models that expose reasoning through variants or compatibility metadata.#60457
    • DesktopFixed the macOS application icon and added the required folder-access description to the app bundle.#60020#60503
    • 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
  9. v2.2.2

    Faster Worktree Selection

    On the new-session screen, click the current Git branch to open that project’s “Run session in” worktree picker directly.#60263

    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 8

    • DesktopRestored classic question cards by default and added Settings → Experimental → New question UI for the redesigned keyboard-oriented dock.#59723
    • DesktopAdded a side-panel tab menu and kept close buttons visible when tabs overflow.
    • DesktopMoved user-message actions into a compact menu.
    • DesktopRedesigned the active todo pill to show the current task and concurrent work more clearly.
    • DesktopAdded consistent styling for searchable dialogs and composer pills.
    • 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 10

    • DesktopStopped queued prompts from dropping frames as their content grows.
    • DesktopCounted queued quotes and browser annotations as attachments.
    • DesktopReported failures to persist composer attachments through the normal error UI.
    • DesktopMade Markdown fragment links scroll to the referenced heading.
    • DesktopKept each tab’s timeline state when switching directories.
    • DesktopOrdered the inbox’s Working shelf by execution start time.
    • DesktopFixed side-panel launchers and automatic closing when the final tab is removed.
    • DesktopFocused the matching navigation arrow while reviewing changes.
    • DesktopPreserved pending model labels only when a queued prompt actually changes models.
    • DesktopAdded reset details, an account link, and a composer tray for Go usage limits.
  10. 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

    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

    See all highlights in v2.2.1

    Improvements 10

    • DesktopAdd /reload to reload configuration without restarting.#59887
    • DesktopRedesign the integrations dialog and always include OpenCode free models in the model picker.#59976#60047
    • DesktopAdd project, worktree, open-in-app, and terminal actions to the session location menu.#59607
    • DesktopRefine project and worktree selection, command search, prompt-history focus, composer model labels, and artifact preview controls.#59397#59604#59626#59735#59657
    • DesktopHighlight quoted timeline content while you write its first comment.#59286
    • DesktopKeep draft attachment bytes local when using experimental media URIs.#59104
    • 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

    Fixes

    • DesktopFollow each plugin server’s configured endpoint when connecting to its event stream.#60087
    • DesktopTreat the reachable scroll boundary as the end when Desktop zoom is active.#60034
    • DesktopPrevent shell text from showing through copy buttons and avoid restyling the transcript when closing a side panel.#59901#59878
    • DesktopKeep rendering malformed tool metadata instead of crashing the timeline.#59736
    • DesktopMake dropdowns open immediately and keep the new-session location shortcut working after tooltip interactions.#59268#59680
    • DesktopRemove edge halos from macOS application icons.#59900