Skip to content
Assistants/OpenCode

OpenCode

OpenCode / SST · cli agent · free

Open-source AI coding agent for the terminal.

open-sourcecliagent
Is this coverage useful?

Helps prioritize which assistants and sources we maintain. Anonymous · one vote per visitor.

Config files OpenCode has changed

Config you own — hooks, permission rules, MCP servers, settings — that releases below state a change to. Counted from the release notes we track, newest change first. How a harness is layered.

permission rules1 change · 2 releases touched it · latest Sep 1, 2026 · v1.18.26 ↗

Security advisories

2 published for OpenCode, from the GitHub Advisory Database.

Release signals

OpenCodev1.18.0Jul 14, 2026

Completed the Desktop v2 migration, including upgrade handling for the new layout and first-launch onboarding.

  • Added a setting to switch between the new and old Desktop layouts during the transition period.
  • Fixed file views using the wrong background in the v2 layout.
  • Fixed connected project picker positioning when its anchor is still loading.
  • Kept permission auto-accept state separate for each server.
  • Fixed a project picker positioning crash.
  • Kept terminal tab rename focused while editing.
  • Enabled remote sessions to auto-accept permissions correctly.
  • +7 more changes
Read the full release note

Desktop

Improvements

  • Completed the Desktop v2 migration, including upgrade handling for the new layout and first-launch onboarding.
  • Added a setting to switch between the new and old Desktop layouts during the transition period.

Bugfixes

  • Fixed file views using the wrong background in the v2 layout.
  • Fixed connected project picker positioning when its anchor is still loading.
  • Kept permission auto-accept state separate for each server.
  • Fixed a project picker positioning crash.
  • Kept terminal tab rename focused while editing.
  • Enabled remote sessions to auto-accept permissions correctly.
  • Fixed terminal tabs stealing focus when they mount.
  • Loaded more timeline history at once to reduce repeated backfill while scrolling.
  • Resynced the timeline correctly after reconnecting.
  • Preserved the composer caret after request updates.
  • Reduced Home cold-load time substantially.
  • Preserved timeline bottom anchoring more reliably.
  • Clarified status indicator severity.
Primary source ↗
OpenCodev1.17.19Jul 13, 2026

Supported OpenAI pro reasoning mode.

  • Disabled response storage by default for xAI Responses. (@geraint0923)
  • Added OAuth support for Luna Responses Lite.
  • Switched to another available org after logging out in the console.
  • Used Codex context limits for GPT-5.6 over OAuth. (@nabilfreeman)
  • Forwarded CLI environment variables to the TUI worker.
  • Removed interface transition changes that were accidentally shipped to `dev`.
  • Fixed clipped labels and branch tooltips.
  • Stopped the review panel width from jumping when opening or closing it.
  • +17 more changes
Read the full release note

Core

Bugfixes

  • Supported OpenAI pro reasoning mode.
  • Disabled response storage by default for xAI Responses. (@geraint0923)
  • Added OAuth support for Luna Responses Lite.
  • Switched to another available org after logging out in the console.
  • Used Codex context limits for GPT-5.6 over OAuth. (@nabilfreeman)

TUI

Bugfixes

  • Forwarded CLI environment variables to the TUI worker.

Desktop

Bugfixes

  • Removed interface transition changes that were accidentally shipped to dev.
  • Fixed clipped labels and branch tooltips.
  • Stopped the review panel width from jumping when opening or closing it.
  • Focused the prompt input when starting a new session.
  • Prevented some new-session updates from blocking the UI.
  • Fixed timeline outlines getting clipped.
  • Aligned context token counts with usage totals.
  • Kept the file tree visible while opening files.

Improvements

  • Redesigned attachment cards and file comment chips in the new interface.
  • Updated the review panel with persistent file browsing, better file tabs, and easier open-in-app actions.
  • Restyled the Edit Project modal to match the new interface.
  • Added middle-click to open sessions in a new tab.

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.16Jul 9, 2026

Exposed reasoning effort variants for Grok models.

  • Improved xAI prompt cache routing and PDF file support in Responses models.
  • Added an Open containing folder action for projects on the home screen.
  • Added a composer add menu for files, commands, context, and shell mode without losing draft text.
  • Added a provider setup tip on new sessions when no external providers are connected.
  • Remember review panel mode and selected file per session.
  • Added inline file browser tabs for opening and previewing files from the side panel.
  • Updated desktop translations.
  • +7 more changes
Read the full release note

Core

Bugfixes

  • Exposed reasoning effort variants for Grok models.
  • Improved xAI prompt cache routing and PDF file support in Responses models.

Desktop

Improvements

  • Added an Open containing folder action for projects on the home screen.
  • Added a composer add menu for files, commands, context, and shell mode without losing draft text.
  • Added a provider setup tip on new sessions when no external providers are connected.
  • Remember review panel mode and selected file per session.
  • Added inline file browser tabs for opening and previewing files from the side panel.
  • Updated desktop translations.

Bugfixes

  • Kept the review pane usable on wide screens by reserving its minimum width.
  • Fixed hidden session panes staying mounted and causing side-panel glitches.
  • Routed legacy drafts back to the session page.
  • Loaded full review diffs for large patches when the initial diff is capped.
  • Removed the first-open flash in the command palette.
  • Routed the new session shortcut through tabs in the new layout.
  • Kept session routes inside the correct layout when opening legacy session URLs.
Primary source ↗
OpenCodev1.17.15Jul 7, 2026

Better classify Z.ai context-window overflow errors so oversized requests surface the right failure mode (@fengjikui)

  • Handle unavailable config directories more gracefully when reading config files
  • Restore model details tooltips in the model picker (@arvsrn)
  • Refresh the v2 command palette to better match the rest of the new desktop UI (@arvsrn)
  • Make terminal shortcuts take priority when the terminal is focused
  • Show unread state on tabs with pending questions
  • Keep session tab titles available after reloads while session data is still loading
  • +12 more changes
Read the full release note

Core

Bugfixes

  • Better classify Z.ai context-window overflow errors so oversized requests surface the right failure mode (@fengjikui)
  • Handle unavailable config directories more gracefully when reading config files

Desktop

Improvements

  • Restore model details tooltips in the model picker (@arvsrn)
  • Refresh the v2 command palette to better match the rest of the new desktop UI (@arvsrn)

Bugfixes

  • Make terminal shortcuts take priority when the terminal is focused
  • Show unread state on tabs with pending questions
  • Keep session tab titles available after reloads while session data is still loading
  • Apply theme changes only after you select them in Settings
  • Fix macOS titlebar appearance mismatches in Sequoia and adjust traffic light placement (@arvsrn)

Thank you to 3 community contributors:

  • @arvsrn:

    • feat(app): align cmd k menu with v2 styles (#35152)

    • feat(app): visual improvements (#35134)

    • feat(app): reintroduce model context tooltip in model selector (#35087)

    • feat(app): change traffic light position, fix sequoia bug (#35081)

  • @StarpTech:

    • fix(core): expand home-relative permission paths (#35737)
  • @fengjikui:

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.14Jul 6, 2026

Added a code mode MCP adapter for running confined orchestration scripts against connected MCP tools.

  • Hid the `execute` tool unless code mode is enabled.
  • Fixed paginated MCP tool catalogs losing tool metadata and output schema validation.
  • Preserved low reasoning effort for OpenRouter small-model variants instead of disabling it.
  • Fixed GitHub Copilot model routing to honor each model's advertised chat or responses endpoint.
  • Fixed session lists to match equivalent instance directories reliably.
  • +36 more changes
Read the full release note

Core

Improvements

  • Added a code mode MCP adapter for running confined orchestration scripts against connected MCP tools.
  • Hid the execute tool unless code mode is enabled.

Bugfixes

  • Fixed paginated MCP tool catalogs losing tool metadata and output schema validation.
  • Preserved low reasoning effort for OpenRouter small-model variants instead of disabling it.
  • Fixed GitHub Copilot model routing to honor each model's advertised chat or responses endpoint.
  • Fixed session lists to match equivalent instance directories reliably.
  • Fixed Cerebras reasoning replay so earlier assistant reasoning is sent back in the provider-supported field.

TUI

Bugfixes

  • Fixed spinner registration so loading indicators keep rendering across TUI surfaces.

Desktop

Improvements

  • Show draft server status in the title bar.
  • Unified the provider connect flow across the app.
  • Improved the integrated terminal experience. (@arvsrn)
  • Added reopening for closed tabs and background tab opening. (@usrnk1)
  • Improved model search in picker dialogs. (@arvsrn)
  • Added recently closed projects to Home. (@usrnk1)
  • Made tab navigation respond on mouse down in the new layout.

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.13Jul 1, 2026

Force reasoning mode for OpenAI-compatible reasoning models so reasoning settings apply reliably on custom deployments

  • Stop replaying stale GitHub Copilot response item IDs, avoiding follow-up request failures
  • Let question prompts be minimized and restored without dismissing them (@arvsrn)
  • Clean up stale empty and old draft store files to reduce desktop state buildup
  • Keep pending question requests open while reviewing them, instead of dismissing them accidentally (@eXamadeus)
  • Keep session page failures scoped to the affected tab instead of breaking the whole app
  • +16 more changes
Read the full release note

Core

Bugfixes

  • Force reasoning mode for OpenAI-compatible reasoning models so reasoning settings apply reliably on custom deployments
  • Stop replaying stale GitHub Copilot response item IDs, avoiding follow-up request failures

Desktop

Bugfixes

  • Let question prompts be minimized and restored without dismissing them (@arvsrn)
  • Clean up stale empty and old draft store files to reduce desktop state buildup
  • Keep pending question requests open while reviewing them, instead of dismissing them accidentally (@eXamadeus)
  • Keep session page failures scoped to the affected tab instead of breaking the whole app

Improvements

  • Improve markdown and message layout alignment in the v2 session UI (@arvsrn)
  • Add a searchable v2 model picker and model management flow in the composer (@arvsrn)
  • Show a hover preview for session tabs with the project, path, branch, and server (@usrnk1)
  • Streamline WSL server setup with clearer distro checks and install flows (@arvsrn)
  • Keep desktop tabs scoped to each window so windows restore their own tab sets

Thank you to 3 community contributors:

  • @arvsrn:
    • feat(app): v2 wsl ui (#34233)

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.12Jun 30, 2026

Enable adaptive thinking for Claude Sonnet 5.

  • Prefer MCP content responses over structured output when both are present.
  • Reconnect MCP servers after OAuth even if the server was disabled. (@MaxAnderson95)
  • Request MCP refresh-token scope during OAuth.
  • Show MCP OAuth completion errors instead of a generic failure.
  • Refresh cached remote skills.
  • Preserve skill resource paths.
  • Pick better default small models across providers.
  • Scope MCP auth status to each server URL.
  • Add a yolo mode to auto-approve permissions.
  • +65 more changes
Read the full release note

Core

Bugfixes

  • Enable adaptive thinking for Claude Sonnet 5.
  • Prefer MCP content responses over structured output when both are present.
  • Reconnect MCP servers after OAuth even if the server was disabled. (@MaxAnderson95)
  • Request MCP refresh-token scope during OAuth.
  • Show MCP OAuth completion errors instead of a generic failure.
  • Refresh cached remote skills.
  • Preserve skill resource paths.
  • Pick better default small models across providers.
  • Scope MCP auth status to each server URL.

TUI

Improvements

  • Add a yolo mode to auto-approve permissions.
  • Pass ServerAuth headers through external served TUI connections. (@OpeOginni)

Desktop

Improvements

  • Autocomplete MCP resources in the composer.
  • Add workspace controls when starting a new session.
  • Show stored token and cost totals in the session context. (@OpeOginni)

Bugfixes

  • Autocomplete configured references in prompts.
  • Restore the prompt cursor when the composer regains focus.
  • Remember the last active desktop URL across restarts.
  • Preserve the selected model when promoting a session. (@usrnk1)
  • Keep session pages in sync during concurrent events.

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.11Jun 25, 2026

Add session snapshots and revert controls so you can roll a session back to an earlier message, including file changes.

  • Always print the MCP OAuth URL so manual sign-in still works when opening the browser flow.
  • Add Chrome-style tab cycle shortcuts with `mod+1` through `mod+9`.
  • Add draggable tabs. (@arvsrn)
  • Improve the empty home state when you have no sessions. (@arvsrn)
  • Restyle the jump-to-latest button in the v2 session view. (@arvsrn)
  • Improve the redesigned desktop layout, including better titlebar tabs and archived sessions. (@arvsrn)
  • +17 more changes
Read the full release note

Core

Improvements

  • Add session snapshots and revert controls so you can roll a session back to an earlier message, including file changes.

Bugfixes

  • Always print the MCP OAuth URL so manual sign-in still works when opening the browser flow.

Desktop

Improvements

  • Add Chrome-style tab cycle shortcuts with mod+1 through mod+9.
  • Add draggable tabs. (@arvsrn)
  • Improve the empty home state when you have no sessions. (@arvsrn)
  • Restyle the jump-to-latest button in the v2 session view. (@arvsrn)
  • Improve the redesigned desktop layout, including better titlebar tabs and archived sessions. (@arvsrn)

Bugfixes

  • Keep prompt drafts attached to the correct project server.
  • Restore consistent titlebar tab sizing and layout.
  • Restore home actions when session lists are empty or still loading.
  • Keep todo docks in place when switching between sessions.
  • Automatically close tabs for sessions that no longer exist.
  • Keep provider dialogs, prompt rollbacks, and async attachments tied to the session where they started.
  • Clear late session notifications after you open the session.
  • Remove the session loading stripe.

Thank you to 2 community contributors:

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.10Jun 24, 2026

Added MCP server instructions to session context. (@Arcadi4)

  • Added Opencode-managed provider integration support.
  • Added MCP resource template listing.
  • Added MCP resource read tools.
  • Added a `--mini` CLI mode.
  • Hid MCP resource template tools when access is denied.
  • Prevented MCP resource tools from colliding when servers expose the same keys.
  • Emitted skill base directories as filesystem paths instead of `file://` URLs. (@shyuan)
  • Restored legacy MCP tool names for existing integrations.
  • Restored v1 account config loading.
  • +46 more changes
Read the full release note

Core

Improvements

  • Added MCP server instructions to session context. (@Arcadi4)
  • Added Opencode-managed provider integration support.
  • Added MCP resource template listing.
  • Added MCP resource read tools.
  • Added a --mini CLI mode.

Bugfixes

  • Hid MCP resource template tools when access is denied.
  • Prevented MCP resource tools from colliding when servers expose the same keys.
  • Emitted skill base directories as filesystem paths instead of file:// URLs. (@shyuan)
  • Restored legacy MCP tool names for existing integrations.
  • Restored v1 account config loading.
  • Bound MCP OAuth callbacks to IPv4 loopback for better local auth reliability. (@he-yufeng)
  • Preserved structured error details in surfaced failures.
  • Fixed snapshots from subdirectories so they only include the right files and paths.
  • Fixed ACP resource text sourcing on Windows and other cross-platform path cases.
  • Preserved file source paths in ACP resource text.
  • Waited for plugins before loading reference-backed config and system context.
  • Hid gpt-5.5-pro when using Codex OAuth.

TUI

Improvements

  • Added a configurable keybind to open the diff viewer.

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.9Jun 21, 2026

Honor configured agent step limits by forcing a final text response instead of failing mid-run.

  • Fix Devstral model detection when provider IDs use different casing. (@Robin1987China)
  • Pass configured custom headers to Copilot model requests.
  • Add `high` and `max` thinking variants for GLM-5.2 across supported providers. (@imranshaiedi-byte)
  • Stop wrapping follow-up user messages in a steering reminder so prompt caching stays effective.
  • Only show the background subagent shortcut when the server supports it.
  • **Thank you to 4 community contributors:**
  • @Grantmartin2002:
  • +7 more changes
Read the full release note

Core

Bugfixes

  • Honor configured agent step limits by forcing a final text response instead of failing mid-run.
  • Fix Devstral model detection when provider IDs use different casing. (@Robin1987China)
  • Pass configured custom headers to Copilot model requests.

Improvements

  • Add high and max thinking variants for GLM-5.2 across supported providers. (@imranshaiedi-byte)
  • Stop wrapping follow-up user messages in a steering reminder so prompt caching stays effective.

TUI

Bugfixes

  • Only show the background subagent shortcut when the server supports it.

Thank you to 4 community contributors:

  • @Grantmartin2002:

    • fix(core): fix command docs in customize-opencode skill (#32718)
  • @Robin1987China:

    • fix(opencode): use toLowerCase for Devstral model detection (#33109)
  • @kimnamu:

    • fix(experimental llm pkg): forward topK to Converse via additionalModelRequestFields (#33030)
  • @imranshaiedi-byte:

    • feat(opencode): expose High/Max thinking variants for GLM-5.2 (#32446)
Primary source ↗
OpenCodev1.17.8Jun 17, 2026

Session timelines load much faster and avoid flicker or scroll jumps.

  • OpenAI-compatible providers now accept MCP tool schemas that previously failed validation. (@jquense)
  • Cloudflare AI Gateway now receives the configured API key correctly. (@keefetang)
  • MCP tools without declared schema properties now work with providers that expect object properties.
  • Long-running MCP tools now keep their timeout alive when they report progress. (@Nomadcxx)
  • The MCP OAuth callback server now shuts down once authorization finishes or is cancelled.
  • +11 more changes
Read the full release note

Core

Improvements

  • Session timelines load much faster and avoid flicker or scroll jumps.

Bugfixes

  • OpenAI-compatible providers now accept MCP tool schemas that previously failed validation. (@jquense)
  • Cloudflare AI Gateway now receives the configured API key correctly. (@keefetang)
  • MCP tools without declared schema properties now work with providers that expect object properties.
  • Long-running MCP tools now keep their timeout alive when they report progress. (@Nomadcxx)
  • The MCP OAuth callback server now shuts down once authorization finishes or is cancelled.
  • MCP tool failures now surface the server's error text instead of a generic failure.
  • MCP OAuth error pages now escape provider error text correctly.

Desktop

Improvements

  • Added a Home tab toggle so you can quickly switch between Home and your last tab.
  • The new desktop file and folder picker is faster and easier to navigate in the v2 layout.

Thank you to 3 community contributors:

  • @Nomadcxx:

    • fix(mcp): enable progress timeout resets (#32477)
  • @keefetang:

    • fix(provider): pass apiKey to createUnified for Cloudflare AI Gateway (#32052)
  • @jquense:

Excerpt ends here — this release continues at the source ↗.

Primary source ↗
OpenCodev1.17.7Jun 14, 2026

Plugin client requests now reuse the active server instead of assuming the default local port.

  • ACP shell tool calls now show the command and working directory from the start.
  • Plugin-provided shell environment variables now apply to PTY sessions.
  • MCP servers can now receive the current workspace as a client root.
  • MCP debug now uses the SDK's latest protocol version.
  • The new session route now stays scoped to its own draft server, so prompts and state target the right workspace.
  • +1 more change
Read the full release note

Core

Bugfixes

  • Plugin client requests now reuse the active server instead of assuming the default local port.
  • ACP shell tool calls now show the command and working directory from the start.
  • Plugin-provided shell environment variables now apply to PTY sessions.

Improvements

  • MCP servers can now receive the current workspace as a client root.

TUI

Bugfixes

  • MCP debug now uses the SDK's latest protocol version.

Desktop

Bugfixes

  • The new session route now stays scoped to its own draft server, so prompts and state target the right workspace.

SDK

Improvements

  • SDK clients now refresh model and provider availability when integrations change, and credential update and remove calls accept location.
Primary source ↗

Polled sources

[site] OpenCode site

Product page · not polled

https://opencode.ai

[github-releases] GitHub Releases

GitHub Releases · last read Oct 24, 2026

https://github.com/anomalyco/opencode/releases