> opencode.ai is the source of truth for OpenCode, the open source coding agent, including its apps, install commands, docs and releases. The current version is OpenCode v2.
> Cite the canonical page, https://opencode.ai/changelog/v2.3.0, not this Markdown file. For an index of the site, see https://opencode.ai/llms.txt.

# Background Subagents by Default

2026-11-13 · v2.3.0

Subagents now return immediately, continue in the background, and report back whenever they become idle. You can keep working in the parent session while multiple subagents run concurrently. ([#63382](https://github.com/anomalyco/opencode/pull/63382))

## 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](https://github.com/anomalyco/opencode/pull/63207))

## 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](https://github.com/anomalyco/opencode/pull/63585))

## Improvements

- **Core:** Added experimental support for MCP events, behind the `mcp_events` flag. ([#63254](https://github.com/anomalyco/opencode/pull/63254), [#63261](https://github.com/anomalyco/opencode/pull/63261), [#63269](https://github.com/anomalyco/opencode/pull/63269))
- **Core:** Shell commands now survive server handoffs and keep their output when interrupted.
- **Core:** Added experimental support for moving a shell command to the background when its timeout expires, behind the `shell_timeout_background` flag. With the flag on, an explicit timeout on a background command stops it. ([#63024](https://github.com/anomalyco/opencode/pull/63024), [#63703](https://github.com/anomalyco/opencode/pull/63703))
- **Core:** Local Windows shell commands now run through the process daemon.
- **Core:** Added support for freeform tool input on compatible models.
- **Core:** Added LM Studio decision-model support.
- **Core:** Agents are now told when their session is a fork. Thanks @hasta84. ([#63235](https://github.com/anomalyco/opencode/pull/63235))
- **Core:** Tool output truncation now keeps the beginning of the output and preserves a usable preview if the full output cannot be saved.
- **Core:** Tail reads no longer load the entire file into memory.
- **Core:** Providers can present a client certificate for gateways that require mutual TLS. Set `settings.tls` with `cert`, `key` and an optional `passphrase` on the provider; values accept `{file:}` and `{env:}` like `apiKey`. ([#61832](https://github.com/anomalyco/opencode/pull/61832))
- **Core:** When a subagent goes idle while its own background work is still running, its report to the parent now says it is still running, so the parent waits for the final report instead of treating the partial answer as done. ([#63675](https://github.com/anomalyco/opencode/pull/63675))
- **Core:** Code Mode gets simpler structured results from file and skill tools: `write` and `edit` return their confirmation as a string, `patch` returns an empty result, and `skill` returns the skill's directory and content. ([#63616](https://github.com/anomalyco/opencode/pull/63616), [#63635](https://github.com/anomalyco/opencode/pull/63635), [#63618](https://github.com/anomalyco/opencode/pull/63618), [#63623](https://github.com/anomalyco/opencode/pull/63623))
- **Terminal:** Session IDs found in messages can now be opened directly.
- **Terminal:** Activity tabs are clickable and open the correct view.
- **Terminal:** Shell mode has its own prompt color under the new designs.
- **Desktop:** Added the experimental **Recent** sessions sidebar, with cross-server recency, local pins, reordering, and standard session-row actions.
- **Desktop:** Recent sessions are limited to the last seven days and 30 rows, and can be hidden or muted.
- **Desktop:** Added an experimental customizable sessions sidebar.
- **Desktop:** Mermaid diagrams can now be maximized for zooming and panning. ([#59250](https://github.com/anomalyco/opencode/pull/59250))
- **Desktop:** Added `Alt+Enter` to place a follow-up first in the queue and `Mod+Enter` to steer the next queued prompt.
- **Desktop:** Holding the modifier key now shows tab shortcut numbers.
- **Desktop:** Each server’s terminal shell can be selected from its menu.
- **Desktop:** Added a free-limit panel in place of the composer when applicable.
- **Desktop:** Session IDs are easier to find and copy.
- **SDK:** Event subscriptions can now receive `experimental.mcp.event` events from MCP event subscriptions.
- **SDK:** Model capability schemas now advertise supported freeform tool-input formats.
- **SDK:** Session throughput is now measured from the first streamed token.
- **SDK:** Session creation documentation now clarifies the `parentID` field.
- **Extensions:** Promise-based tools can cooperatively stop through `ToolContext.signal`.
- **Extensions:** Added the experimental `session.fork` hook.
- **Extensions:** Promise 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](https://github.com/anomalyco/opencode/pull/63698))

## Fixes

- **Core:** Fixed case-only file renames in patches on case-insensitive filesystems.
- **Core:** Fixed stale thinking being retained after Claude Agent prompts or tools change.
- **Core:** Fixed directly driven child sessions not resuming after a restart.
- **Core:** Fixed plugin replacement stopping when cleanup of an earlier plugin fails.
- **Core:** Fixed MCP OAuth refreshes and localhost redirects when a server rewrites `127.0.0.1`.
- **Core:** Fixed saved API keys being omitted from local-model discovery.
- **Core:** Local model discovery (Ollama, LM Studio, vLLM) waits up to 15 seconds per request instead of 1, so remote or tunnelled endpoints list their models, and a slow endpoint no longer delays other endpoints or config reloads. ([#63700](https://github.com/anomalyco/opencode/pull/63700))
- **Core:** In Code Mode, calling a namespace as if it were a tool now suggests up to three real tools under it. ([#63697](https://github.com/anomalyco/opencode/pull/63697))
- **Core:** Fixed retryable provider streams losing completed work when interrupted.
- **Core:** Fixed GitHub Copilot requests using the wrong endpoint before models finish loading.
- **Core:** Fixed exhausted request rate limits being treated as terminal. Thanks @Kyle-j-bush. ([#59816](https://github.com/anomalyco/opencode/pull/59816))
- **Core:** Fixed LM Studio models with a null context length and accepted decision-type models. Thanks @tomzhu1024. ([#56214](https://github.com/anomalyco/opencode/pull/56214))
- **Terminal:** Restored pasted text when undo brings back its placeholder.
- **Terminal:** Restored the live draft after browsing prompt history.
- **Terminal:** Fixed copying a paste from within the prompt selection.
- **Terminal:** Preserved the Mini composer caret when closing the command palette.
- **Terminal:** Prevented image bytes from being retained in transcript storage when image previews are disabled.
- **Terminal:** Fixed paste-chip contrast across light and dark themes.
- **Terminal:** Fixed plugin-provided themes updating live.
- **Terminal:** Session lists now open at the top rather than at the current session.
- **Terminal:** Mini scrollback now shows the subagent card instead of obsolete launch instructions.
- **Desktop:** Recent sessions now keep stable recency ordering through list reloads, renames, and completed runs.
- **Desktop:** Fixed browser panes not retrying after server plugins finish loading.
- **Desktop:** Fixed mention suggestions being recreated while typing.
- **Desktop:** Fixed SSH prompts failing to advance or close after connection.
- **Desktop:** Fixed pasted provider-auth redirect URLs being rejected.
- **Desktop:** Restored message footers in the New timeline.
- **Desktop:** Fixed links whose labels contain inline code.
- **Desktop:** Fixed the desktop main process freezing while probing the login-shell environment.
- **Desktop:** Fixed the drag region after changing layout direction.
- **Desktop:** Fixed vertical-tab previews snapping to the wrong tab.
- **Desktop:** Fixed the file-tree sidebar opening animation.
- **Desktop:** Fixed pairing QR-code contrast in light themes. Thanks @ssskay. ([#63220](https://github.com/anomalyco/opencode/pull/63220))
- **Desktop:** Fixed activity-tab navigation and click handling. Thanks @OpeOginni. ([#60168](https://github.com/anomalyco/opencode/pull/60168))

Released in [v2.3.0](https://github.com/anomalyco/opencode/releases/tag/v2.3.0)

Older: [GitHub Copilot Auto](https://opencode.ai/changelog/v2.2.7) (v2.2.7)

[All updates](https://opencode.ai/changelog)

---

If something here is wrong or missing, open an issue at https://github.com/anomalyco/opencode/issues.