38252-videos-prerelease
LatestPre-release
PR #38252 verification videos
Before/after verification recordings for PR #38252.
Anomaly and contributors · Open-source AI coding agent desktop client for local project work, coding sessions and configurable model providers; separate from the terminal CLI.
brew install --cask opencode-desktopPR #38252 verification videos
Before/after verification recordings for PR #38252.
PR #37967 final screenshots
Final visual evidence for PR #37967.
PR #37967 screenshots
Visual evidence for PR #37967.
PR #37967 screenshots (final)
Final visual evidence for PR #37967.
OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
OpenCode 2.3.2 stops GPT-6.2 from re-billing the system prompt as uncached input.
OpenCode 2.3.2, published on November 18, 2026, is a desktop coding agent for people using GPT-6.2. This release stops every step from re-billing the system prompt as uncached input.
Source: https://github.com/anomalyco/opencode/releases/tag/v2.3.2
timeout: 0 now means the default 120 seconds. (#63699)compaction.background: false to turn it off; a background summary that ends up unused still costs tokens. (#64290)shell_timeout_background flag is gone; configs that still set it keep loading. A foreground timeout: 0 now uses the default 120 second timeout instead of waiting until the command exits. (#63699)compaction.background: false; a background summary that is never used still costs tokens. The experimental.background_compaction setting is removed. (#64290)CLAUDE.md in any directory that has no AGENTS.md , and falls back to ~/.claude/CLAUDE.md when the global AGENTS.md is missing. This also applies to instructions found when the agent reads nested files. Set OPENCODE_DISABLE_CLAUDE_CODE or OPENCODE_DISABLE_CLAUDE_CODE_PROMPT to skip every CLAUDE.md . (#64474, #64533)websearch now returns a flat list of results, each with its url, title, content and published date. (#64471)read: text (with offset, lineCount and next), directory (entry names) or media (a URI instead of base64). What the model sees is unchanged. (#64361)Buffer for encoding and decoding bytes. (#64365)search("issues") now works as shorthand for search({ query: "issues" }). (#64347)glob and grep tools now report a malformed filename glob (for example [) as an error that names the parameter to fix, instead of returning no results. (#63960)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)OPENCODE_SESSION_ID environment variable. (#63718)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)opencode-pty. The process daemon now cleans each command up when it exits. Background processes started by a successful command (cmd &) keep running, and a failed command's leftovers are stopped. (#64266, #64251)reasoning_content) no longer receive reasoning_details from earlier turns. (#64243)read now rejects limit: 0 with "Limit must be a positive integer". (#63808)BM are no longer mistaken for BMP images, and only real GIF87a/GIF89a headers count as GIFs, so these files read as text again. (#63822, #63811)�. (#63984, #63967)$'\q' are now read the same way Bash and Zsh read them, so permission rules can match them. (#64263)grep results being dropped when a matching line or path is not valid UTF-8. Thanks @Tarquinen. (#62249)@ file picker now finds files in hidden folders such as .github/ and dotfiles such as .env.example when file search uses ripgrep (the default on Windows and outside git repos). .git and gitignored files stay excluded. Thanks @Tarquinen. (#62577)tool.execute.before now apply to calls inside Code Mode programs, and a renamed call returns the new tool's structured result. (#63633, #64333).catch and Promise.allSettled can handle it instead of the whole script failing. (#64510)null line before its logs. (#64344)session.tps is on. (#63759)+ still start a comment directly. (#64410)→ 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)from dev ▾). Click it to pick another base; the choice applies immediately, and Use main checkout switches back. (#64228)```latex and ```math code fences now render as display math once complete. (#64380)⋯ menu, whether or not you're signed in to OpenCode Console. (#64235)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)/btw panel. (#63834)UnknownError body (message and ref) with status 500 instead of an empty body. (#64022)/api/experimental/automation and client.experimental.automation.* (create, list, get, pause, resume, delete). /api/experimental/schedule and client.experimental.schedule.* are removed. (#64160)compaction.background ; experimental.background_compaction and the shell_timeout_background flag are removed. (#64290, #63699)auth.json credentials. Only a database file opened by path imports them. (#63716)execute call's row. (#64324)SessionIdleBackground items can now be { kind: "codemode", sessionID, jobID }, and GUI plugin BridgeLayout accepts an optional clip rectangle. (#64343, #63819)GitHub Release Added to Homebrew
CompatibilitymacOS 13 or later
medium or high in settings, or set session.verbosity in your TUI config; an existing setting is kept. (#63207)Cmd+Alt+G (Ctrl+Alt+G on Windows and Linux) to search prompts across the current session and jump directly to one. (#63585)mcp_events flag. (#63254, #63261, #63269)shell_timeout_background flag. With the flag on, an explicit timeout on a background command stops it. (#63024, #63703)settings.tls with cert, key and an optional passphrase on the provider; values accept {file:} and {env:} like apiKey. (#61832)write and edit return their confirmation as a string, patch returns an empty result, and skill returns the skill's directory and content. (#63616, #63635, #63618, #63623)127.0.0.1 .low, which summarizes each run of tools and thoughts into one activity row. A session.verbosity you already set is kept. (#63207)Cmd+Alt+G / Ctrl+Alt+G, including prompts not yet loaded in the timeline. Thanks @usrnk1. (#63585)Alt+Enter to place a follow-up first in the queue and Mod+Enter to steer the next queued prompt.experimental.mcp.event events from MCP event subscriptions.parentID field.ToolContext.signal .session.fork hook.@opencode/plugin/effect now exports Tool, so an execute.before hook can reject a call with Tool.Error without importing @opencode/schema/tool . (#63698)GitHub Release Added to Homebrew
CompatibilitymacOS 13 or later
⌘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)@opencode/ai : ImageResponse.image is removedThis affects code that imports @opencode/ directly. Read response. instead of response.. (#63011)
On a Location that is still loading plugins, agent. returns the agents loaded so far, and integration., usage., vcs., rpc. 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 *. event. Model, provider, generate., voice. and websearch. endpoints still wait. (#62796, #63040)
read accepts a negative offset to read from the end of a file, such as -50 for the last 50 lines. An offset past the end returns the last lines and the file's line count instead of failing. (#62147)read can't find a file, it suggests close names: different capitalization, another extension, a small typo, or the matching path inside the project. (#62147)Exit code: N. Commands killed by a signal show the signal name, and timeouts say how long they waited and suggest a larger timeout. (#62141)cache.ttl by default (interval: "auto"), or every 4 minutes without a TTL. Models whose cache outlasts the warming duration are no longer pinged. (#62831)needs_auth. (#63012)background_compaction on, a background summary no longer stops a running Claude Agent session mid tool call. (#63025)opencode auth logout on a .well-known integration, its remote providers and policies stop applying until you log back in. (#62760)gatewayApiKey now send that key. (#62574)api and options.baseURL keeps options.baseURL . (#62570)"openai/gpt-5#high" , keep the variant. (#62254)auth.json , and skips an invalid one with a warning instead of stopping setup. (#62568)session.generate requests, including cache warming pings, count toward the session's totals. (#63006)rm *.tmp , is passed through as bash does instead of stopping the command. (#62141)read no longer cuts an emoji in half when it shortens a long line. (#62575)description starts with a bracketed tag, like [Beta] Reviews code, now load. (#62250)node_modules. (#62571)←/→ and Tab/Shift+Tab. (#62906)/usage instead. (#62927)⌘W closes side panel tabs wherever focus is, the new Close session tab command (⌥⌘W or Ctrl+Alt+W) always closes the session tab, and ⌘⇧T reopens the last closed side panel or session tab where it was. (#62922)Ctrl+Shift+R toggles the review panel again instead of reloading the window. (#62567)Escape. (#62597)session.generate returns tokens and cost along with text. (#62835)credential.updated includes the integrationID and credentialID of the login that changed. (#62762)client.experimental.generate.decisions accept optional criteria: { true?, false? }. (#62819)OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
Shared MCP connections and GUI plugin themes.
OpenCode Desktop 2.2.6 was released on 2026-11-06. This update shares one MCP connection across projects and adds GUI plugin themes.
opencode run -w to start the session in a new git worktree, or --worktree=<name> to name it.--archived to opencode run to keep scripted and CI sessions out of your inbox and session lists.OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
This version has no editorial notes yet.
GitHub Release Added to Homebrew
CompatibilitymacOS 13 or later
"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)claude auth login, install Claude Code, and verify the connection before continuing to model selection. (#60603)⌘⌥. on macOS or Ctrl+Alt+. on Windows and Linux. The command is also available in the command palette and Settings › Shortcuts. (#60579)artifact_create, artifact_read, artifact_update, and artifact_delete, including a built-in local static-file provider. (#60351)opencode serve and coordinated multiple server processes so a schedule fires only once. Schedules remain opt-in through experimental.schedules . (#60478)/login instruction with claude auth login. Thanks @Tarquinen. (#60592)⌘⌥. or Ctrl+Alt+.. (#60579)client.experimental.artifacts.providers , list, create, get, update, delete, and view. (#60351)client.experimental.persistentPty.update to rename terminals or clear a user title, and exposed userTitle plus persistent-pty.updated events. (#60329)ctx.experimental.artifact.transform(...) to Effect and Promise plugins for registering artifact providers, capabilities, prompts, and the default provider. (#60351)OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
OpenCode 2.2.3 adds a Claude Agent provider, speeds up long Desktop sessions, fixes side-panel tabs and moves TUI plugins to OpenTUI 0.8.
Highlights
claude auth login, select Claude Agent in /connect (#58782).Desktop
Other changes
@opencode/plugin needs @opentui/core and @opentui/solid 0.8.0 or later (#60385).integration.use now covers integrations only; the new mcp.use , skill.use and plugin.use actions control MCP servers, skills and plugins, and rules with the old mcp:, skill: and plugin: prefixes are converted automatically (#60315).TestSpeech, TestTranscription and TestVideo moved to @opencode/ai/experimental/testing (#60484).OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
Updated to version 2.2.2. The official release notes do not list specific changes.
OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
Adds goal-driven sessions, optional image generation, and a new default model picker.
/goal <objective> in Desktop or the TUI, with pause, resume, clear, and automatic progress review. Optional scheduled prompts use /schedule and experimental.schedules .experimental.image_generate for image creation and editing. Adds GPT Image 2 after Codex sign-in, MiniMax and Meta Muse support, and fixes image-edit reference formats./reload , searchable Favorites and Recent model lists, live background-shell output with Stop, and project and worktree actions in the session location menu./usage spacing.@opencode/ai users must migrate removed fal, Black Forest Labs, Replicate, and Stability providers and legacy Bedrock/Vertex entry points; configure() input types become Config. These changes do not affect Desktop, CLI, or HTTP API use.client.experimental and Promise-client compaction. Extensions gain experimental.idle , Effect-returning Code Mode globals, and composer-pill popovers.OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
Introduces experimental Desktop plugins and refreshes the desktop workspace.
@opencode/ai exports the Promise API at its root; Effect imports move to @opencode/ai/effect . The OpenCode GitHub Action is removed. TUI plugins require OpenTUI 0.7.0 and updated hook initialization.OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
Displays MCP input forms and adds experimental background compaction.
MCP requests for input now display a form rather than leaving the tool call waiting for a timeout. Desktop and web support text, number, choice, multiselect, boolean and URL requests. Set experimental.background_compaction to true to prepare a session summary as it approaches the compaction threshold, reducing the wait during automatic compaction. Preparing a summary still consumes tokens even if the summary is never used. These are selected highlights; see the official changelog for the full release.
OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
Updated the bundled Bun runtime to 1.4.4 with security fixes and refreshed root certificates. Desktop code blocks, file views and review diffs use Pierre Highlights for faster highlighting and lower memory use on large inputs. Fixed formatted pastes when renaming session tabs and the session scrollbar jumping back to the end.
Updated the bundled Bun runtime to 1.4.4 with security fixes and refreshed root certificates. Desktop code blocks, file views and review diffs use Pierre Highlights for faster highlighting and lower memory use on large inputs. Fixed formatted pastes when renaming session tabs and the session scrollbar jumping back to the end.
Source: https://opencode.ai/changelog
OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
OpenCode 2.1.2: clearer free-limit recovery
Restores desktop free-limit recovery and keeps the current session when subscribing to OpenCode Go.
OpenNavo editorial Added to Homebrew
CompatibilitymacOS 13 or later
Improves model-catalog refresh propagation and provider-variant construction, and refreshes the bundled model catalog.
Selected shared-core changes in the official v2.1.1 tagged source: models.dev catalog refreshes are broadcast server-wide, provider variants are built after package normalization, and the bundled models.dev snapshot is refreshed. These core fixes also matter to the Desktop client. The comparison additionally lists TUI dialog redesign work; those interface changes concern the terminal client. This note is based on the tagged source comparison because the public website has no separate 2.1.1 changelog entry.
OpenNavo editorial Added to Homebrew
Shared core notes for 2.0.32: fixes login crashes when no browser opener is available and retries intermittent Gemini MALFORMED_RESPONSE finishes. The TUI /copy command now copies the latest reply or compaction summary. These are not desktop-specific feature announcements.
Shared core notes for 2.0.32: fixes login crashes when no browser opener is available and retries intermittent Gemini MALFORMED_RESPONSE finishes. The TUI /copy command now copies the latest reply or compaction summary. These are not desktop-specific feature announcements.
OpenNavo editorial Added to Homebrew
Adds per-turn changed files, line counts and expandable diffs in the desktop timeline, plus keyboard session-tab navigation. Improves docked TUI diffs, MCP compatibility and compaction limits; keeps settings accessible for missing project folders.
Adds per-turn changed files, line counts and expandable diffs in the desktop timeline, plus keyboard session-tab navigation. Improves docked TUI diffs, MCP compatibility and compaction limits; keeps settings accessible for missing project folders.
OpenNavo editorial Added to Homebrew
Remote pairing, provider account management, automatic continuation and desktop fixes.
Desktop adds remote device pairing in Settings → Pairing through OpenTunnel, with a QR code and link. Provider accounts can be switched, renamed, removed or added from the connect dialog or Settings → Providers. Trackpad gestures zoom and pan image/SVG previews, and sessions show context tokens and accumulated family cost.
Responses automatically continue after reaching an output-token limit, with bounded retries and recovery for truncated tool calls. policies becomes a top-level configuration key while experimental. remains compatible; centrally managed configuration takes precedence over local and user configuration.
Refines side-panel shortcuts, the question composer, timeline notices and diff colors. Fixes immediate pending-message/attachment display, raw-media retention up to 256 MiB, lost model selections, browser-tab closing, incorrect missing-file notices and a project-store eviction loop at launch. The official entry also covers TUI, SDK and extensions; this summary focuses on desktop and shared core changes.