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 ↗

Release signals

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 ↗
OpenCodev1.17.6Jun 13, 2026

Improved MCP server compatibility by declaring OpenCode's supported client capabilities.

Primary source ↗
OpenCodev1.17.5Jun 13, 2026

Added external browser OAuth for the Snowflake Cortex provider (@santigc6)

  • Improved project copy management and move-session flows in v2
  • Recovered expired MCP sessions instead of leaving MCP tools disconnected
  • Cleared closed MCP clients so stale MCP connections do not linger
  • Returned structured MCP tool output in a readable form
  • Fixed duplicate renderable IDs that could break TUI rendering
  • Fixed commands using `$ARGUMENTS` so file contents are not injected twice (@verdverm)
  • Added auth headers to `RunCommand` fetch requests (@OpeOginni)
  • +15 more changes
Read the full release note

Core

Improvements

  • Added external browser OAuth for the Snowflake Cortex provider (@santigc6)
  • Improved project copy management and move-session flows in v2

Bugfixes

  • Recovered expired MCP sessions instead of leaving MCP tools disconnected
  • Cleared closed MCP clients so stale MCP connections do not linger
  • Returned structured MCP tool output in a readable form
  • Fixed duplicate renderable IDs that could break TUI rendering
  • Fixed commands using $ARGUMENTS so file contents are not injected twice (@verdverm)

TUI

Bugfixes

  • Added auth headers to RunCommand fetch requests (@OpeOginni)

Desktop

Improvements

  • Brought v2 visibility settings to the web app
  • Refreshed the oc-2 color theme (@arvsrn)

Bugfixes

  • Made the terminal resize gutter easier to grab
  • Faded overflowing titlebar tabs instead of clipping them abruptly

Thank you to 5 community contributors:

  • @verdverm:

    • fix(tui): double file content injection in commands using $ARGUMENTS (#31245)
  • @arvsrn:

    • feat(app): update oc-2 colors (#31071)
  • @Slickstef11:

    • docs: update North Mini Code privacy terms (#32096)
  • @santigc6:

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

Primary source ↗
OpenCodev1.17.4Jun 12, 2026

Added `cwd` support for local MCP servers so they can start from a workspace-relative directory. (@Grantmartin2002)

  • Added connector-based authentication flows and support for stored provider credentials.
  • Added v2 API endpoints to create and fetch sessions, list session questions, and resolve the active location.
  • File reads now return raw content with the correct content type for API and SDK clients.
  • MCP server log notifications are now surfaced in opencode logs.
  • Fixed Gemini tool schemas that used multi-type fields so compatible tools keep working. (@Killusions)
  • +15 more changes
Read the full release note

Core

Improvements

  • Added cwd support for local MCP servers so they can start from a workspace-relative directory. (@Grantmartin2002)
  • Added connector-based authentication flows and support for stored provider credentials.
  • Added v2 API endpoints to create and fetch sessions, list session questions, and resolve the active location.
  • File reads now return raw content with the correct content type for API and SDK clients.
  • MCP server log notifications are now surfaced in opencode logs.

Bugfixes

  • Fixed Gemini tool schemas that used multi-type fields so compatible tools keep working. (@Killusions)
  • Content-filtered model responses now surface as visible errors instead of failing silently. (@kkdawkins)
  • Fixed MCP auth and debug requests dropping configured headers.
  • Snapshot creation now reuses source Git objects to avoid long re-hashing delays on huge repos. (@dmtrKovalenko)
  • Fixed MCP catalog request timeouts not applying when listing prompts, resources, or tools.

Thank you to 5 community contributors:

  • @dmtrKovalenko:

    • fix(snapshot): reuse source git objects to avoid re-hashing huge repos (#31798)
  • @tobwen:

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

Primary source ↗
OpenCodev1.17.2Jun 10, 2026

Recover from expired remote config auth by prompting you to log in again instead of failing to load config (@Ayushlm10)

  • Let subagents use their own configured permissions again
  • Restore Linux launcher and icon identity so pinned apps keep opening correctly (@neriousy)
  • Restore the device attachment picker (@rexdotsh)
  • **Thank you to 3 community contributors:**
  • @Ayushlm10:
  • fix: recover from expired enterprise auth on remote config load (#31661)
  • @rexdotsh:
  • fix(app): restore device attachment picker (#31707)
  • @neriousy:
  • fix(desktop): restore linux launcher identity (#31709)
Primary source ↗
OpenCodev1.17.1Jun 10, 2026

References can include usage descriptions for agents, show up in the new docs, and be hidden from `@` autocomplete when needed.

  • Deprecated `reference` config entries continue to load under the newer `references` config key.
  • MCP prompt and resource requests now respect configured server timeouts.
  • Anthropic fallback responses are handled correctly again.
  • MCP servers that fail during client setup now fail cleanly instead of leaving a broken connection behind.
  • +2 more changes
Read the full release note

Core

Improvements

  • References can include usage descriptions for agents, show up in the new docs, and be hidden from @ autocomplete when needed.

Bugfixes

  • Deprecated reference config entries continue to load under the newer references config key.
  • MCP prompt and resource requests now respect configured server timeouts.
  • Anthropic fallback responses are handled correctly again.
  • MCP servers that fail during client setup now fail cleanly instead of leaving a broken connection behind.

Desktop

Improvements

  • The new desktop session flow now has a dedicated /new-session route with draft tabs that keep your prompt and project selection together until you start the session.

Bugfixes

  • Restored macOS auto-updates.
Primary source ↗

Polled sources

[site] OpenCode site

html · every 720m

https://opencode.ai

[github-releases] GitHub Releases

github_releases · every 180m

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