cd /news/ai-agents/opencode-2-3-adds-experimental-mcp-e… · home › topics › ai-agents › article
[ARTICLE · art-170785] src=github.com ↗ pub= topic=ai-agents verified=true sentiment=↑ positive

OpenCode 2.3 adds experimental MCP events

OpenCode released version 2.3.0, which makes background subagents the default so subagents return their session ID immediately, continue running concurrently, and report results to the parent session when idle. The release also adds experimental support for MCP events behind the `mcp_events` flag and experimental backgrounding of shell commands on timeout behind the `shell_timeout_background` flag, alongside a TUI change that collapses each run of tool calls and thoughts into one activity row unless Verbosity is set to `medium` or `high`.

key takeaway

OpenCode 2.3.0 makes subagents run in the background by default and returns their session ID immediately, and adds experimental MCP event support behind the `mcp_events` flag.

read6 min views15 publishedNov 13, 2026
OpenCode 2.3 adds experimental MCP events
Image: Michielbdejong (auto-discovered)

Repository navigation #

[github-actions](https://github.com/apps/github-actions)released this

          ·
          

[89 commits](https://github.com/anomalyco/opencode/compare/v2.3.0...dev)to dev since this release
            Immutable
            release. Only release title and notes can be modified.

Highlights

  • Background Subagents by Default : 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 )
  • 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, setVerbosity tomedium orhigh in settings, or setsession.verbosity in your TUI config; an existing setting is kept. (#63207 )
  • Jump to an Earlier Prompt : In the desktop app, openJump to message from the command palette or pressCmd+Alt+G (Ctrl+Alt+G on Windows and Linux) to search prompts across the current session and jump directly to one. (#63585 )

Core

Improvements

  • Subagents now always run in the background, return their session ID immediately, and report results to their parent whenever they become idle. (#63382 )
  • Added experimental support for MCP events, behind the mcp_events flag. (#63254 ,#63261 ,#63269 )
  • Shell commands now survive server handoffs and keep their output when interrupted.
  • 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 ,#63703 )
  • Local Windows shell commands now run through the process daemon.
  • Added support for freeform tool input on compatible models.
  • Added LM Studio decision-model support.
  • Agents are now told when their session is a fork. Thanks @hasta84 . (#63235 )
  • Tool output truncation now keeps the beginning of the output and preserves a usable preview if the full output cannot be saved.
  • Tail reads no longer load the entire file into memory.
  • Providers can present a client certificate for gateways that require mutual TLS. Set settings.tls withcert ,key and an optionalpassphrase on the provider; values accept{file:} and{env:} likeapiKey . (#61832 )
  • 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 )
  • Code Mode gets simpler structured results from file and skill tools: write andedit return their confirmation as a string,patch returns an empty result, andskill returns the skill's directory and content. (#63616 ,#63635 ,#63618 ,#63623 )

Bug fixes

  • Fixed case-only file renames in patches on case-insensitive filesystems.
  • Fixed stale thinking being retained after Claude Agent prompts or tools change.
  • Fixed directly driven child sessions not resuming after a restart.
  • Fixed plugin replacement stopping when cleanup of an earlier plugin fails.
  • Fixed MCP OAuth refreshes and localhost redirects when a server rewrites 127.0.0.1 .
  • Fixed saved API keys being omitted from local-model discovery.
  • 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 )
  • In Code Mode, calling a namespace as if it were a tool now suggests up to three real tools under it. (#63697 )
  • Fixed retryable provider streams losing completed work when interrupted.
  • Fixed GitHub Copilot requests using the wrong endpoint before models finish .
  • Fixed exhausted request rate limits being treated as terminal. Thanks @Kyle-j-bush . (#59816 )
  • Fixed LM Studio models with a null context length and accepted decision-type models. Thanks @tomzhu1024 . (#56214 )

TUI

Improvements

  • Transcript verbosity now defaults to low , which summarizes each run of tools and thoughts into one activity row. Asession.verbosity you already set is kept. (#63207 )
  • Session IDs found in messages can now be opened directly.
  • Activity tabs are clickable and open the correct view.
  • Shell mode has its own prompt color under the new designs.

Bug fixes

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

Desktop

Improvements

  • Added Jump to message to the command palette withCmd+Alt+G /Ctrl+Alt+G , including prompts not yet loaded in the timeline. Thanks@usrnk1 . (#63585 )
  • Added the experimental Recent sessions sidebar, with cross-server recency, local pins, reordering, and standard session-row actions.
  • Recent sessions are limited to the last seven days and 30 rows, and can be hidden or muted.
  • Added an experimental customizable sessions sidebar.
  • Mermaid diagrams can now be maximized for zooming and panning. (#59250 )
  • Added Alt+Enter to place a follow-up first in the queue andMod+Enter to steer the next queued prompt.
  • Holding the modifier key now shows tab shortcut numbers.
  • Each server’s terminal shell can be selected from its menu.
  • Added a free-limit panel in place of the composer when applicable.
  • Session IDs are easier to find and copy.

Bug fixes

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

SDK

Improvements

  • Event subscriptions can now receive experimental.mcp.event events from MCP event subscriptions.
  • Model capability schemas now advertise supported freeform tool-input formats.
  • Session throughput is now measured from the first streamed token.
  • Session creation documentation now clarifies the parentID field.

Extensions

Improvements

  • Promise-based tools can cooperatively stop through ToolContext.signal .
  • Added the experimental session.fork hook.
  • Promise plugin cleanup failures no longer prevent subsequent plugin replacements.
  • @opencode/plugin/effect now exportsTool , so anexecute.before hook can reject a call withTool.Error without importing@opencode/schema/tool . (#63698 )
── more in #ai-agents 4 stories · sorted by recency
── more on @opencode 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/opencode-2-3-adds-ex…] indexed:0 read:6min 2026-11-13 · —