How do I get an agent to fix a bug directly in my own codebase without copying files into a chat window?

it runs from a terminal inside the project directory, reading and editing the actual files and acting on them through shell and editor tools rather than a pasted-in transcript

What did the agent actually change while I was away from the keyboard?

every session can be replayed step by step, showing each action the agent took so it can be audited after the fact

Can I have several coding tasks running at once without them stepping on each other?

subagents can be sent to the background to keep working in parallel while the main session continues

Which of my own tools and data sources can the agent reach while it works?

it connects to MCP servers, including ones scoped to a specific subdirectory or given the current workspace as a root, so external tool access is tied to the project rather than the whole machine

Am I stuck with one AI vendor for this project?

it connects to any LLM provider configured with an API key, including a curated set called OpenCode Zen, so the underlying model can be swapped without changing how the agent is used

Can I move a coding session to another machine or folder without losing my uncommitted work?

sessions and workspace clones can be moved between directories while preserving dirty and untracked files

OpenCode release history — The Cyber Toolchain

v1.18.31 Sep 14, 2026 · release notes

Adds batch workspace block endpoints for extensions and requests summarized adaptive thinking for GitHub Copilot.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.31 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.31

v1.18.30 Sep 9, 2026 · release notes

Adds Astra system prompt for GPT-6 models and GitLab reasoning effort variants.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.30 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.30

└──▷ USE IT

Enable reasoning effort control for GitLab-hosted GPT models to tune latency vs. accuracy.

shell

opencode --provider gitlab --model gpt-4-turbo --reasoning-effort high

Added the Astra system prompt for GPT-6 models.
Added reasoning effort variants for supported GitLab GPT and Claude models.

2 details in Everything

v1.18.29 Sep 4, 2026 · release notes

v1.18.29 allows filtering by integer GPT versions and adds a quota reset action in the console.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.29 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.29

Adds gpt-6 and other integer versions to Codex OAuth model filtering logic
Adds quota reset action in the console for managing subscription usage

2 details in Everything

v1.18.19 Aug 20, 2026 · release notes

Native Cloudflare AI Gateway passthroughs for OpenAI and Anthropic models

└──▷ GET THIS VERSION

$ git clone --branch v1.18.19 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.19

docs update Aug 13, 2026 · issue 044

OpenCode adds Grok 4.6, Hy3 Free, and Nemotron 3.5 Lightning Free models.

Adds grok-4.6 model (Grok 4.6) with support for context windows up to 200K tokens and above 200K tokens.
Adds hy3-free model (Hy3 Free) as a limited-time free offering on OpenCode.
Adds nemotron-3.5-lightning-free model (Nemotron 3.5 Lightning Free) as a limited-time free NVIDIA endpoint on OpenCode.

3 details in Everything

v1.18.16 Aug 10, 2026 · issue 041

OpenCode v1.18.16 adds right-click project menu in the desktop Home screen and resilient project picker fallback.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.16 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.16

Adds right-click on a project in the desktop Home screen to open the project menu.
Unknown top-level config fields are now silently ignored instead of failing config parsing, making config files forward-compatible.
Projects opened from the Home screen are now registered so they are available throughout the rest of the app.

3 details in Everything

docs update Aug 7, 2026 · issue 038

OpenCode TUI gains cursor config block to control terminal cursor style and blinking in input fields.

└──▷ USE IT

Set a blinking underline cursor in TUI input fields instead of the default block cursor.

yaml

cursor:
  style: "underline"
  blinking: true

docs update Aug 7, 2026 · issue 038

OpenCode adds cursor.style and cursor.blinking config keys to control terminal cursor appearance.

└──▷ USE IT

Set a non-blinking block cursor in OpenCode for a stable, high-contrast editing experience.

json

{
  "cursor": {
    "style": "block",
    "blinking": false
  }
}

v1.18.15 Aug 7, 2026 · issue 038

OpenCode v1.18.15 adds session JSON export from the UI and broader desktop locale coverage.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.15 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.15

Adds Export... option to the session 3-dot dropdown, an Export session button in the Context tab, and a session.export command palette action (/export) to export full session transcripts as JSON from the UI.
Expands locale coverage across the desktop app with much broader language support.

2 details in Everything

docs update Aug 6, 2026 · issue 037

OpenCode adds Poolside provider support with custom deployment config and dual xAI auth options

Adds Poolside as a supported provider via its OpenAI-compatible API, with API key configuration at platform.poolside.ai.
Supports self-hosted Poolside deployments configured as a custom OpenAI-compatible provider, storing credentials in ~/.secrets/poolside-key and using the /openai/v1/models endpoint to discover available model IDs.
Supports reasoning_content field and interleaved reasoning mode for Poolside deployment models.
Adds two xAI authentication paths: SuperGrok subscription via device-code OAuth (with automatic browser launch and polling) or a pay-as-you-go API key from the xAI console.

4 details in Everything

docs update Aug 6, 2026 · issue 037

OpenCode adds Poolside provider support with custom deployment config and xAI SuperGrok device-code OAuth.

└──▷ USE IT

Configure a self-hosted Poolside deployment as a custom provider, storing credentials outside the config file.

json

{
  "id": "poolside-deployment",
  "name": "Poolside deployment",
  "baseURL": "https://poolside.example.com/openai/v1",
  "apiKey": "{file:~/.secrets/poolside-key}",
  "models": [
    {
      "id": "<served-model-id>",
      "name": "Poolside deployment model",
      "reasoning": "interleaved",
      "field": "reasoning_content"
    }
  ]
}

Adds Poolside as a supported provider via its OpenAI-compatible API, configurable with a custom provider ID, base URL (e.g. https://poolside.example.com/openai/v1), and API key stored at ~/.secrets/poolside-key.
Supports Poolside self-hosted deployments by configuring a custom OpenAI-compatible provider with model IDs sourced from the /openai/v1/models endpoint and reasoning fields (reasoning_content, interleaved) for thinking-capable models.
Adds xAI (Grok) authentication via SuperGrok subscription using device-code OAuth — OpenCode opens xAI's verification link with the user code pre-populated and polls the token endpoint automatically.
Adds xAI (Grok) authentication via pay-as-you-go API key from the xAI console as an alternative to OAuth.

4 details in Everything

v1.18.14 Aug 5, 2026 · issue 037

xAI login simplified to a single device-code flow for better headless and remote environment support.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.14 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.14

1.0.0 Aug 4, 2026 · issue 035

API surface changed: 1 deprecated

API change

API surface changed: 1 deprecated

⚠ POST /session/{sessionID}/permissions/{permissionID}

└──▷ BREAKING ON UPGRADE

!Deprecated endpoint POST /session/{sessionID}/permissions/{permissionID} (still works)

docs update Jul 30, 2026 · issue 030

OpenCode gains Tavily integration for web search, extraction, crawling, and deep research.

v1.18.10 Jul 30, 2026 · issue 030

OpenCode v1.18.10 adds automatic Modal model discovery and desktop UX improvements.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.10 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.10

Automatically discovers available Modal models, removing the need to manually configure them.
Always shows the new session button in the desktop app for faster session creation.
Prevents duplicate attachments from being added in the desktop composer.
Improves toast notification stacking, dismissal, and mobile layout in the desktop app.

4 details in Everything

v1.18.9 Jul 28, 2026 · issue 029

OpenCode v1.18.9 adds an opt-in v2 desktop sidecar and collapsible model provider sections in settings.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.9 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.9

Adds opt-in v2 desktop sidecar: set OPENCODE_SIDECAR_V2=1 to initialize the desktop app from the v2 background daemon instead of the v1 utility sidecar.
Adds collapsible model provider sections in the V2 settings page, with collapse state persisted per server and search expanding matching sections dynamically.

2 details in Everything

v1.18.8 Jul 28, 2026 · issue 028

OpenCode v1.18.8 upgrades the MCP client SDK to v2 and adds a project selector keyboard shortcut.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.8 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.8

Upgrades the MCP client SDK to v2, improving compatibility with newer MCP servers and OAuth flows.
Adds a mod+shift+o shortcut to open the project selector from the new-session page in the desktop app.

2 details in Everything

v1.18.4 Jul 20, 2026 · issue 021

OpenCode v1.18.4 adds adaptive thinking for Kimi models and desktop UI improvements including inline file browser tabs.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.4 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.4

Adds adaptive thinking controls for Kimi models on Anthropic-compatible providers, with summarized reasoning output by default.
Syncs the embedded terminal theme with the active app theme in the desktop app.
Rewrites the v2 prompt input for more reliable command, context, shell, attachment, and history interactions.

3 details in Everything

v1.18.3 Jul 16, 2026 · issue 018

OpenCode v1.18.3 adds Up Arrow to close the subagent picker and lets the command palette search sessions from the home page.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.3 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.3

Adds Up Arrow shortcut to close the subagent picker when the first item is selected, enabling faster keyboard-only navigation.
Enables the home page command palette (Cmd+K) to find and open existing sessions, filtered by the currently selected server.

2 details in Everything

v1.18.2 Jul 15, 2026 · issue 017

Adds Mod+N shortcut for new tabs and a configurable subagent_depth limit to prevent runaway nested subagents.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.2 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.2

Adds Mod+N as an alternative keyboard shortcut for opening a new tab in the desktop app.
Adds configurable subagent_depth limit to control how deeply subagents can spawn nested subagents (defaults to 1).

2 details in Everything

v1.18.0 Jul 14, 2026 · issue 015

OpenCode v1.18.0 completes Desktop v2 migration with a new layout-switch setting and improved file comments in the session timeline.

└──▷ GET THIS VERSION

$ git clone --branch v1.18.0 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.18.0

Adds a setting to switch between the new Desktop v2 and old layouts during the transition period.
Completes the Desktop v2 migration, including upgrade handling and first-launch onboarding flow.
Improves file comments display in the Desktop session timeline.

3 details in Everything

v1.17.19 Jul 13, 2026 · issue 015

OpenCode v1.17.19 adds per-prompt model selection, middle-click tabs, and an interface-switching setting in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.19 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.19

Adds per-prompt model selection in the composer, letting you switch models on a message-by-message basis.
Adds middle-click to open sessions in a new tab in the desktop app.
Adds a temporary setting to toggle between the old and new interface in the desktop app.
Redesigns attachment cards and file comment chips in the new interface.
Updates the review panel with persistent file browsing, improved file tabs, and easier open-in-app actions.

+2 more show less

Restyled the Edit Project modal to match the new interface design.
Polishes the new interface styling across the session view and terminal.

7 details in Everything

v1.17.18 Jul 9, 2026 · issue 011

Adds a model-specific system prompt for Meta Muse Spark to improve coding agent responses.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.18 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.18

v1.17.17 Jul 9, 2026 · issue 011

OpenCode v1.17.17 adds a v2 free-model selector, dismissible tabs intro popup, and refreshed sub-agent task and revert-dock UI.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.17 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.17

Adds a v2 free-model selector with faster access to more providers in the desktop app.
Introduces a dismissible tabs intro popup and a refreshed help entry point in the desktop UI.
Updates sub-agent task rows to match the v2 session design, with distinct icon states for running, completed, and resting tasks.
Restyled revert dock in v2 sessions for clearer restore actions, using v2 design tokens and a new outline-reset icon.

4 details in Everything

v1.17.16 Jul 9, 2026 · issue 010

OpenCode v1.17.16 adds inline file browser tabs, a draft-preserving composer add menu, and per-session review state persistence.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.16 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.16

Adds inline file browser tabs in the review pane for opening and previewing files without leaving the session.
Adds a composer add menu for inserting files, commands, context, and shell mode while preserving draft text.
Adds an Open containing folder action for projects on the home screen.
Adds a provider setup tip on new sessions when no external providers are connected.
Supports Grok 4.5 model variants with reasoning effort options.

5 details in Everything

v1.17.14 Jul 6, 2026 · issue 008

Adds a code-mode MCP adapter for confined orchestration scripting, an OpenAPI tool adapter, and a gated execute tool for code-mode sessions.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.14 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.14

Adds a code-mode MCP adapter enabling confined orchestration scripts to run against connected MCP tools.
Adds an OpenAPI tool adapter for code-mode, expanding available tool integrations.
Gates the execute tool behind a code-mode flag so it only surfaces when code mode is active.
Desktop: adds recently closed projects to the Home screen for quick re-entry.
Desktop: adds reopening of closed tabs and background tab opening.

+5 more show less

Desktop: shows draft server status in the title bar.
Desktop: overhauled v2 review panel for improved session review workflows.
Desktop: improves model search in picker dialogs.
Desktop: makes tab navigation respond on mouse down in the new layout.
TUI: adds a debug info dialog with copy-to-clipboard support.

10 details in Everything

v1.17.13 Jul 1, 2026 · issue 002

Desktop app gains per-window tab scoping, searchable model picker, session tab hover previews, and streamlined WSL setup.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.13 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.13

Adds searchable v2 model picker and model management flow in the composer for easier model switching.
Adds hover preview for session tabs showing the project, path, branch, and server at a glance.
Streamlines WSL server setup with clearer distro checks and guided install flows.

3 details in Everything

v1.17.12 Jun 30, 2026 · issue 002

OpenCode v1.17.12 adds yolo auto-approve mode, live SDK event streams, paged session history, and MCP resource autocomplete.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.12 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.12

Adds yolo mode to the TUI that auto-approves all permission prompts without manual confirmation.
Adds a live event subscription stream to the SDK for real-time session monitoring.
Adds SDK access to active sessions.
Adds paged durable session history via a new API endpoint.
Adds session permission request create and fetch endpoints to the SDK/API.

+4 more show less

Autocompletes MCP resources directly in the Desktop composer.
Adds workspace controls when starting a new session in the Desktop app.
Shows stored token and cost totals in the Desktop session context.
Passes ServerAuth headers through external-served TUI connections, enabling authenticated remote TUI use.

9 details in Everything

v1.17.11 Jun 25, 2026 · issue 001

OpenCode v1.17.11 adds session snapshots with revert controls and Chrome-style tab shortcuts for the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.11 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.11

Adds session snapshots and revert controls, letting you roll back a session — including file changes — to any earlier message.
Adds Chrome-style tab cycle shortcuts (mod+1 through mod+9) in the desktop app for fast session switching.
Adds draggable tabs in the desktop app.
Adds an improved empty home state in the desktop app when no sessions exist.

4 details in Everything

v1.17.10 Jun 24, 2026 · issue 001

OpenCode v1.17.10 adds MCP resource tools, a new api CLI command, --mini mode, Gemini audio/video, and a V2 plugin API.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.10 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.10

└──▷ TRY IT

Launch OpenCode in mini mode for a lighter-weight session, e.g. in a resource-constrained CI step.

$ opencode --mini

Adds opencode api CLI command to make raw or OpenAPI-operation-ID requests to the running OpenCode server.
Adds --mini CLI mode for a lightweight invocation.
Adds MCP resource read tools, enabling agents to fetch MCP resource content directly.
Adds MCP resource template listing so agents can discover available resource templates from connected MCP servers.
Adds MCP server instructions to session context, giving the model awareness of per-server guidance.

+11 more show less

Adds Gemini audio and video media support via the Gemini protocol (contributed by @remorses).
Adds Opencode-managed provider integration support with provider integration IDs exposed in the SDK.
Adds V2 plugin API supporting both Effect and Promise plugins.
Adds namespaced plugin hook APIs for extension authors.
Adds configurable keybind to open the TUI diff viewer.
Adds diff viewer support for comparing the working tree against the main branch.
Adds server-aware session routes in the desktop app to keep same-session navigation separated across servers.
Adds collapsible server sections in the desktop app.
Adds a new session progress indicator in the desktop app.
Adds mobile bottom navigation in the desktop app.
Preserves draft prompt state per tab in the desktop app.

16 details in Everything

v1.17.9 Jun 21, 2026 · issue 001

OpenCode v1.17.9 adds GLM-5.2 high/max thinking variants and improves prompt-cache efficiency for follow-up messages.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.9 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.9

Adds high and max thinking variants for GLM-5.2 across supported providers, enabling deeper reasoning on complex tasks.

1 detail in Everything

v1.17.8 Jun 17, 2026 · issue 001

OpenCode v1.17.8 adds a Home tab toggle and faster session timelines in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.8 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.8

Adds a Home tab toggle in the desktop app to quickly switch between the Home view and your last active tab.
Faster session timeline loading with no flicker or scroll jumps.
New desktop file and folder picker is faster and easier to navigate in the v2 layout.

3 details in Everything

v1.17.7 Jun 14, 2026 · issue 001

MCP servers now receive the current workspace as a client root; SDK clients refresh model availability when integrations change.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.7 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.7

Enables MCP servers to receive the current workspace directory as a client root via the roots capability, letting context-aware MCP tools resolve project paths automatically.
SDK clients now dynamically refresh model and provider availability whenever integrations change, and credential update/remove calls accept a location parameter.

2 details in Everything

v1.17.5 Jun 13, 2026 · issue 001

Adds external browser OAuth for Snowflake Cortex and brings v2 visibility settings to the desktop web app.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.5 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.5

Adds external browser OAuth flow for the Snowflake Cortex provider, enabling SSO-based authentication without embedding credentials.
Brings v2 visibility settings to the desktop web app, giving users control over session and project visibility from the browser interface.
Refreshes the oc-2 color theme with updated color ramps and token mapping in the desktop app.

3 details in Everything

v1.17.4 Jun 12, 2026 · issue 001

OpenCode v1.17.4 adds MCP server log surfacing, cwd support for local MCP servers, connector auth, and new v2 session API endpoints.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.4 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.4

└──▷ TRY IT

Anchor a local MCP server to a specific subdirectory of your workspace so its relative file paths resolve correctly.

$ opencode --mcp-server '{"type":"local","command":"node","args":["server.js"],"cwd":"tools/mcp"}'

Adds cwd support for local MCP servers, allowing them to start from a workspace-relative directory.
Adds connector-based authentication flows with support for stored provider credentials.
Adds v2 API endpoints to create and fetch sessions, list session questions, and resolve the active location.
Surfaces MCP server log notifications in opencode logs for improved observability.

4 details in Everything

v1.17.1 Jun 10, 2026 · issue 001

OpenCode v1.17.1 adds usage descriptions and hidden-from-autocomplete support for references, plus a dedicated /new-session desktop route.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.1 https://github.com/anomalyco/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.1

Adds support for usage descriptions on references, making agent context more self-documenting.
Enables references to be hidden from @ autocomplete while still remaining available to agents.
Introduces a dedicated /new-session desktop route with draft tabs that keep prompt and project selection together before a session starts.

3 details in Everything

v1.17.0 Jun 10, 2026 · release notes

OpenCode v1.17.0 adds fff-backed fast file search, Cohere North & vLLM reasoning support, WSL Desktop, and non-interactive MCP flows.

└──▷ GET THIS VERSION

$ git clone --branch v1.17.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.17.0

Adds fff-backed file search tools for faster search across large projects.
Adds X-Session-Id headers to support sticky routing in proxy setups.
Adds Cohere North model support.
Adds reasoning as an interleaved field option for vLLM providers.
Enables mcp add to work in non-interactive (scripted/CI) flows.

+6 more show less

Enables auth logout to search when choosing an account to log out.
Adds WSL-backed Desktop support and WSL server management on Windows.
Large v2 SDK tool outputs are now bounded and expose retained output paths for follow-up inspection.
Project copies can now be deleted directly from the session move dialog.
Adds a help button to the Desktop tabs bar.
Preserves prompt drafts while switching tabs in the Desktop app.

11 details in Everything

v1.16.2 Jun 5, 2026 · release notes

OpenCode v1.16.2 adds Snowflake Cortex provider, hunk navigation in diff viewer, background subagents, and improved multi-server desktop support.

└──▷ GET THIS VERSION

$ git clone --branch v1.16.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.16.2

Adds Snowflake Cortex as a supported AI provider.
Diff viewer now supports next and previous hunk navigation.
Running subagents can be sent to the background to continue working in parallel.
Sessions now persist system context updates across long-running conversations.
Multi-server desktop support improved with per-server home state and session tabs.

5 details in Everything

v1.16.0 Jun 5, 2026 · release notes

OpenCode v1.16.0 adds session replay, workspace cloning, file-based agent loading, and color themes for the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.16.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.16.0

└──▷ TRY IT

Replay a previous session interactively to review or audit AI agent actions step by step.

$ opencode run --replay

Adds run --replay flag for interactive session replay.
Adds managed workspace cloning that preserves dirty and untracked files.
Enables moving sessions between workspaces and directories.
Adds proper OpenAI model support through AWS Bedrock.
Adds skill discovery and file-based agent loading.

+5 more show less

Updates GitHub Copilot usage tracking for token-based billing.
Adds color themes to the desktop app.
Adds a thinking level selector for v2 prompts in the desktop app.
Adds a Servers tab in desktop Settings.
Exposes session location data in SDK v2 responses.

10 details in Everything

v1.15.13 May 30, 2026 · release notes

OpenCode v1.15.13 adds session metadata storage via API/SDK and smarter config loading from the opened directory upward.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.13 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.13

Enables storing custom metadata on sessions through the API and SDK.
Config now loads from the opened location upward, applying directory-specific settings and provider policies more predictably.

2 details in Everything

v1.15.12 May 28, 2026 · release notes

OpenCode v1.15.12 adds WebSocket transport for OpenAI, ACP prompt/slash-command support, workspace management dialog, and a tab layout setting.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.12 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.12

└──▷ TRY IT

Enable faster, streaming OpenAI responses over WebSocket instead of HTTP polling — useful when working with high-throughput or long-running prompts.

$ OPENCODE_EXPERIMENTAL_WEBSOCKETS=true opencode

Adds WebSocket transport for OpenAI responses, enabled via OPENCODE_EXPERIMENTAL_WEBSOCKETS=true.
Enables ACP integrations to send prompts, slash commands, and usage updates through acp-next.
Adds a workspace management dialog to the TUI.
Adds a Desktop setting to switch tab layouts.

4 details in Everything

v1.15.11 May 27, 2026 · release notes

OpenCode v1.15.11 adds headerTimeout config, partial modalities config, background agent push updates, and a resizable prompt.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.11 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.11

└──▷ USE IT

Set a custom header timeout for slow provider endpoints to avoid premature connection drops.

yaml

# In your opencode config file:
headerTimeout: 30000

Adds headerTimeout config option for provider requests (defaults to 10s for OpenAI setups) to control how long to wait for response headers.
Supports setting only modalities.input or modalities.output in config independently, without requiring both fields.
Experimental background agents now push updates to clients without polling, reducing latency in agent workflows.
TUI prompt now resizes dynamically with terminal width and exposes a prompt size config option.
Adds a dispose hook for plugins in the Extensions API.

+1 more show less

Desktop v2 home screen, prompt, status popover, and session controls refined.

6 details in Everything

v1.15.9 May 22, 2026 · release notes

v1.15.9 redesigns the diff viewer with a file tree, adds title-bar session status, and lets MCP OAuth configs set callback ports.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.9 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.9

Redesigned diff viewer with a file tree and refreshed layout.
Copy the current worktree path from the command palette (TUI).
Desktop tab navigation moved into the title bar with tighter session tab shortcuts.
Shows session status in the desktop title bar.
MCP OAuth configs can now set a callback port and include configured scopes in client metadata.

5 details in Everything

v1.15.7 May 21, 2026 · release notes

OpenCode v1.15.7 adds Grok OAuth with device-code login, pinch zoom, desktop log export, and a new desktop home view.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.7 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.7

Adds xAI Grok OAuth sign-in (SuperGrok) with device-code login flow.
Adds PDF attachment support for Grok.
Adds pinch zoom setting for the desktop app.
Adds a new desktop home view and session entry flow with a redesigned titlebar.
Adds desktop log export capability.

5 details in Everything

v1.15.6 May 20, 2026 · release notes

OpenCode v1.15.6 adds a TUI diff viewer, shell mode in run, desktop tabs, and structured public error schemas in the v2 HTTP API.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.6

Adds a diff viewer in the TUI for reviewing file changes, with automatic focus on the first file and collapsed single-child directories in the file tree.
Adds shell mode to the run prompt for running shell commands directly.
Replaces subagent tabs with an on-demand picker in run for cleaner multi-agent workflows.
Exposes structured public error schemas (including catalog and request errors) via the v2 HTTP API.
Adds initial desktop tabs support.

+2 more show less

Adds a native app menu on Windows.
Adds Ukrainian locale support.

7 details in Everything

v1.15.5 May 18, 2026 · release notes

OpenCode v1.15.5 adds --replay flags for session history, experimental native OpenAI runtime, and desktop notifications.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.5 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.5

└──▷ TRY IT

Resume a session and review the last N exchanges before continuing — useful for picking up context after an interruption.

$ opencode --replay --replay-limit 10

Adds --replay and --replay-limit CLI flags to display recent session history when resuming interactive runs.
Previews a native OpenAI runtime path behind an experimental flag.
Enables desktop notifications from the renderer in the Desktop app.
Adds free-limit and usage-exceeded dialogs in the Desktop app.
Speeds up rendering of large session timelines in Desktop.

5 details in Everything

v1.15.1 May 16, 2026 · release notes

OpenCode v1.15.1 adds inline collapsed thinking view and pinned sessions with quick-switch slots in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.1 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.1

Adds a collapsed thinking view in the TUI that can be expanded inline to inspect model reasoning without cluttering the chat.
Adds pinned sessions with quick-switch slots in the session picker for fast context switching between active investigations.

2 details in Everything

v1.15.0 May 15, 2026 · release notes

OpenCode v1.15.0 adds an Effect-based core event system and auto-hides the menu bar on Linux and Windows.

└──▷ GET THIS VERSION

$ git clone --branch v1.15.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.15.0

Adds an Effect-based core event system for more complete event delivery across sessions and integrations.
Auto-hides the menu bar on Linux and Windows in the desktop app.

2 details in Everything

v1.14.51 May 15, 2026 · release notes

OpenCode v1.14.51 adds experimental background subagents and MCP connection status with re-auth flows in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.51 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.51

Adds experimental background subagents so tasks continue running while you work in parallel.
Adds MCP connection status for client registration and authentication, with direct re-auth flows in the desktop app.
Adds required billing origin header support for NVIDIA endpoints.

3 details in Everything

v1.14.50 May 14, 2026 · release notes

OpenCode v1.14.50 adds instance directory and workspace query support to the v2 SDK model and provider calls.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.50 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.50

v1.14.49 May 13, 2026 · release notes

OpenCode v1.14.49 adds DigitalOcean OAuth/Inference Router, a v2 model/provider API, pinned sessions, and prompt @mention autocomplete.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.49 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.49

Adds DigitalOcean OAuth and Inference Router as a supported provider.
Introduces a v2 model and provider listing API.
Automatically creates a global opencode.jsonc config when none exists.
Enables customize-opencode by default with a linked full schema.
Adds autocomplete for configured @mentions in prompts.

+3 more show less

Adds pinned recent sessions, quick slots, and recent-session cycling in the TUI.
Adds Ctrl/Cmd+number keyboard shortcuts to switch between projects in the desktop app.
Desktop app now remembers whether the todo dock is collapsed.

8 details in Everything

v1.14.47 May 11, 2026 · release notes

OpenCode v1.14.47: Scout pre-materializes reference repos and large images are auto-resized before sending.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.47 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.47

Scout can now materialize configured reference repositories up front so they are ready to search.
Large image attachments are now auto-resized before sending, with configurable size limits.
File and directory paths in the TUI now render relative to the session directory when possible.

3 details in Everything

v1.14.46 May 10, 2026 · release notes

OpenCode v1.14.46 adds a built-in customize-opencode skill to make config edits safer on startup.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.46 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.46

v1.14.42 May 9, 2026 · release notes

OpenCode v1.14.42 adds the Scout agent, interactive split-footer for opencode run, workspace auto-sync, and HTTP response compression.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.42 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.42

Adds the Scout agent for repo research, documentation lookup, and dependency-source inspection.
Adds an interactive split-footer mode for opencode run.
Adds workspace sync so adapter-backed workspaces are discovered and registered automatically.
Adds HTTP API response compression for large non-streaming responses.
Simplifies TUI keybinding config into a flat keybind format.

+1 more show less

Shows retrying sessions as active in the project sidebar.

6 details in Everything

└──▷ BREAKING ON UPGRADE

!TUI keybinding config is simplified into a flat keybind format — existing nested keybind configs may need to be restructured.

v1.14.41 May 7, 2026 · release notes

OpenCode v1.14.41 lets session warps carry uncommitted changes and adds ACP session state restore.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.41 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.41

Warping a session to another workspace now carries over uncommitted file changes.

1 detail in Everything

v1.14.40 May 7, 2026 · release notes

OpenCode v1.14.40 adds support for .well-known/opencode remote config discovery and clipboard write access for trusted desktop windows.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.40 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.40

Supports .well-known/opencode configs that point to a separate remote config file, enabling centralized config distribution.
Allows trusted desktop app windows to write to the clipboard without permission prompts.

2 details in Everything

v1.14.34 May 4, 2026 · release notes

OpenCode v1.14.34 adds PTY connection tickets, v2 session failure events, and a new debug info TUI command.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.34 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.34

└──▷ TRY IT

Dump environment and diagnostic details when troubleshooting a misbehaving OpenCode session.

$ opencode debug info

Adds PTY connection tickets so authenticated terminal WebSockets work more reliably across clients.
Adds v2 session failure events so clients can detect and display failed runs.
Improves shell command handling for Bash, PowerShell, and cmd sessions.
New debug info TUI command prints environment and diagnostic details.

4 details in Everything

v1.14.31 May 1, 2026 · release notes

Azure setup gains interactive resource-name prompting; task child sessions now inherit parent external_dir and deny permissions.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.31 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.31

Azure provider setup now interactively prompts for the resource name when needed and saves it alongside the API key.
Task child sessions inherit the parent session's external_dir and deny permissions, enabling consistent sandbox boundaries across spawned tasks.

2 details in Everything

v1.14.30 Apr 29, 2026 · release notes

OpenCode v1.14.30 adds Mistral Medium 3.5 with reasoning, session path filtering, and a paste-summary toggle.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.30 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.30

Adds Mistral Medium 3.5 with reasoning support as an available model.
Sessions now filter to the current path by default, with a setting to show the whole project.
Adds a quick toggle for paste summaries in the TUI.
Applies global instructions before project and skill instructions for more predictable instruction precedence.

4 details in Everything

v1.14.29 Apr 28, 2026 · release notes

OpenCode v1.14.29 adds Moonshot/Kimi support, DeepSeek reasoning interleaving, and LSP workspace symbol forwarding.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.29 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.29

Enables DeepSeek OpenAI-compatible setups to interleave reasoning_content by default.
Experimental LSP tool now forwards workspace symbol queries.
Sessions now track a relative workspace path.
Creating a session over HTTP now supports an empty request body.
Workspace HTTP API routes are now mounted through the bridge.

+5 more show less

Google Vertex now defaults tool call streaming off, improving compatibility.
Tool streaming defaults off for non-Anthropic models when using the Anthropic SDK.
opencode agent create now writes a valid permissions.deny config.
File context in TUI can now be toggled off and clears automatically after sending.
Per-workspace icon overrides in Desktop now apply to subdirectories within the same repo.

10 details in Everything

v1.14.27 Apr 27, 2026 · release notes

OpenCode v1.14.27 adds a configurable default shell for terminals and agent shell commands.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.27 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.27

v1.14.26 Apr 26, 2026 · release notes

OpenCode v1.14.26 adds Zed editor support and a /connect tip for unconfigured model setups.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.26 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.26

Adds Zed editor selection support for editor context in the TUI.
Shows a /connect tip in the TUI when no models are configured.
Sends an opencode/<version> User-Agent header with all HTTP requests.

3 details in Everything

v1.14.25 Apr 25, 2026 · release notes

OpenCode v1.14.25 adds Roslyn LSP support for Razor, .cshtml, and C# script files, and richer LSP permission prompts.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.25 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.25

Adds Roslyn LSP support for Razor, .cshtml, and C# script files.
LSP permission prompts now include request details such as the operation, file, and cursor position.

2 details in Everything

v1.14.24 Apr 24, 2026 · release notes

OpenCode v1.14.24 adds experimental HTTP API endpoints for MCP server status and file operations.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.24 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.24

Adds experimental HTTP API endpoint to query MCP server status.
Adds experimental HTTP API endpoints to list files, read file contents, and check project file status.

2 details in Everything

v1.14.22 Apr 23, 2026 · release notes

OpenCode v1.14.22 lets projects store a custom icon override that persists across sessions.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.22 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.22

Supports .npmrc settings during npm installs, enabling private registry and auth configs to be honoured automatically.
Enables per-project custom icon overrides that persist correctly across sessions.

2 details in Everything

v1.14.21 Apr 23, 2026 · release notes

OpenCode v1.14.21 adds pull diagnostics for C#/Kotlin, Roslyn LSP for C#, and high-reasoning Mistral Small variants.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.21 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.21

Supports pull diagnostics from LSP servers, enabling richer inline diagnostics for C# and Kotlin projects.
Switches C# language server support to Roslyn Language Server, replacing csharp-ls.
Adds the high reasoning variant for supported Mistral Small models.
Improves session compaction so long threads retain more useful context when older history is summarized.

4 details in Everything

└──▷ BREAKING ON UPGRADE

!C# support now uses Roslyn Language Server instead of csharp-ls; any environment or config that relies on csharp-ls being the backend will need to be updated.

v1.14.20 Apr 21, 2026 · release notes

OpenCode v1.14.20 adds GET /config to the experimental HTTP API and a desktop session progress bar toggle.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.20 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.20

Adds GET /config endpoint to the experimental HTTP API.
Adds a desktop setting to hide the session progress bar while the agent is working.

2 details in Everything

v1.14.19 Apr 20, 2026 · release notes

OpenCode v1.14.19 adds NVIDIA as a built-in provider, a separate terminal font setting, and smarter session compaction.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.19 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.19

Adds NVIDIA as a built-in provider option with connection docs and required attribution headers.
Adds a separate terminal font setting and bundles JetBrainsMono Nerd Font Mono for the desktop app.
Adds bundled ripgrep support for Windows ARM64 in managed installs.
Keeps recent conversation turns verbatim during session compaction to preserve local context, with automatic fallback to full-conversation summarization when recent turns contain too much media.

4 details in Everything

└──▷ BREAKING ON UPGRADE

!The compaction setting is renamed from its previous name to preserve_recent_tokens; any config referencing the old key will break.

v1.14.17 Apr 19, 2026 · release notes

OpenCode v1.14.17 adds full-session fork option, OTEL resource attribute support, and smarter attachment type detection.

└──▷ GET THIS VERSION

$ git clone --branch v1.14.17 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.14.17

Adds a full-session option when forking from the session dialog in the TUI.
Supports OTEL_RESOURCE_ATTRIBUTES environment variable for custom telemetry resource tags.
Detects attachment types from file contents so images and PDFs work even with incorrect or missing extensions.
Shows the session ID in the TUI sidebar on non-production channels.

4 details in Everything

v1.4.10 Apr 17, 2026 · release notes

OpenCode v1.4.10 passes EXA_API_KEY to websearch and adds a session restore flow for unavailable workspaces.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.10 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.10

Passes EXA_API_KEY to the websearch tool, enabling authenticated Exa searches to reduce rate limits.
Adds a restore flow in the TUI for sessions whose workspace is unavailable, with clearer workspace status indicators.
Propagates OTEL exporter settings into managed workspaces so telemetry is captured there.

3 details in Everything

v1.4.9 Apr 17, 2026 · release notes

OpenCode v1.4.9 adds LLM Gateway as a new provider with config support and model usage reporting.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.9 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.9

Adds LLM Gateway as a supported provider, including configuration support and model usage reporting.
Improves remote workspace reconnection with exponential backoff and clearer failure handling.

2 details in Everything

v1.4.8 Apr 17, 2026 · release notes

OpenCode v1.4.8 adds plugin tool metadata support, Azure prompt caching, and beta desktop UI customization.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.8 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.8

Enables plugin tools to return metadata in execute results.
Enables Azure prompt caching with a default per-session cache key.
Adds beta desktop settings to hide title bar tools (navigation, search, terminal, status, file tree).
Shows real filenames instead of /dev/null in revert diffs.

4 details in Everything

v1.4.7 Apr 16, 2026 · release notes

OpenCode v1.4.7 adds xhigh adaptive reasoning for Claude Opus 4.7 and cross-workspace auth context propagation.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.7 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.7

└──▷ TRY IT

Lock in a specific agent from the command line when you don't want a restored session to override it with its saved agent.

$ opencode --agent <your-agent>

Supports xhigh adaptive reasoning effort for Claude Opus 4.7, enabling deeper multi-step reasoning.
Claude Opus 4.7 now surfaces summarized thinking output by default.
Auth context is now shared across workspace sessions, so provider sign-in persists when switching workspaces.
Sessions now automatically retry provider 5xx errors even when the provider SDK does not flag them as retryable.
Desktop builds display a Beta or Dev badge in the title bar when running pre-release builds.

+1 more show less

The --agent flag on the command line is no longer overwritten by a session's saved agent.

6 details in Everything

v1.4.5 Apr 15, 2026 · release notes

OpenCode v1.4.5 adds OTLP telemetry export, an experimental question API with OpenAPI spec, and a reusable question handler factory.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.5 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.5

Exports AI SDK telemetry spans to OTLP trace backends for observability integration.
Exposes the experimental question API schema and OpenAPI spec from @opencode-ai/server.
Provides a reusable question handler factory for building custom question API hosts.
Desktop shell commands now start from the home directory.

4 details in Everything

v1.4.4 Apr 15, 2026 · release notes

OpenCode v1.4.4 adds Alibaba provider, PII-sanitized exports, session permission updates, and custom workspace adaptors.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.4

└──▷ TRY IT

Export a session transcript with PII and confidential content redacted — useful before sharing logs with teammates or filing bug reports.

$ opencode export --sanitize

Adds Alibaba provider support with cache support.
Adds opencode export --sanitize to redact PII and confidential data from transcripts.
Adds experimental compaction.autocontinue hook to control whether sessions auto-continue after compaction.
Sessions can now update project permissions mid-run.
Plugins can now register custom workspace adaptors that appear in workspace creation.

+2 more show less

Reading images no longer counts against quota.
Snapshots now fully respect .gitignore, including previously tracked files.

7 details in Everything

v1.4.3 Apr 10, 2026 · release notes

OpenCode v1.4.3 adds fast model variants, configurable OAuth redirect URIs for MCP servers, and improved interrupted Bash command output.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.3

Adds fast mode variants for supported Claude and GPT models.
Supports configurable OAuth redirect URIs for remote MCP servers.
Interrupted Bash commands now retain their final output and truncation details instead of being marked aborted.

3 details in Everything

v1.4.1 Apr 9, 2026 · release notes

OpenCode v1.4.1 adds permission prompts for GitLab Duo Workflow tool calls and hides unsupported Big Pickle model variants.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.1 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.1

Adds permission prompts for GitLab Duo Workflow tool calls instead of auto-executing them.
Hides unsupported variants for Big Pickle models in the model picker.
Shows an OpenCode Go subscribe prompt in the TUI when free usage limits are reached.
Simplifies provider labels in the model and provider pickers.

4 details in Everything

v1.4.0 Apr 8, 2026 · release notes

OpenCode v1.4.0 adds OTLP observability, HTTP proxy support, PDF drag-and-drop, and a new --dangerously-skip-permissions run flag.

└──▷ GET THIS VERSION

$ git clone --branch v1.4.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.4.0

└──▷ TRY IT

Auto-approve all non-denied permission prompts in a non-interactive or CI context to run an agent task without manual confirmation.

$ opencode run --dangerously-skip-permissions

Adds OTLP observability export support for tracing and monitoring OpenCode sessions.
Adds full HTTP proxy support for routing OpenCode traffic through a proxy.
Adds opencode run --dangerously-skip-permissions flag to auto-approve non-denied permission prompts.
Adds a configurable keybinding for the Switch model variant command in the TUI.
Adds PDF drag-and-drop support for attachments in the TUI.

5 details in Everything

└──▷ BREAKING ON UPGRADE

!Diff metadata in the edit and patch tool no longer contains to and from fields with full file contents — only a patch field with the unified diff remains. Session and user message snapshot diffs follow the same format.
!UserMessage.variant is now nested under model: use userMessage.model.variant instead of userMessage.variant.

v1.3.16 Apr 6, 2026 · release notes

OpenCode v1.3.16 adds Azure model option support, ACP session config exposure, mouse capture disabling, and org-switching from the provider UI.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.16 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.16

└──▷ TRY IT

Disable mouse capture when running opencode inside a multiplexer like tmux where mouse events conflict.

$ OPENCODE_DISABLE_MOUSE=1 opencode

Supports Azure model options on both chat and responses paths for @ai-sdk/azure users.
Exposes session model and mode config options through ACP (Agent Control Protocol).
Enables disabling TUI mouse capture via config or the OPENCODE_DISABLE_MOUSE environment variable.
Labels Console-managed providers and adds org switching directly from the provider UI.
Changes default Ctrl+Z binding on Windows to undo instead of terminal suspend.

5 details in Everything

v1.3.14 Apr 4, 2026 · release notes

OpenCode v1.3.14 adds Venice AI provider, macOS MDM config, theme-only plugins, and restored git-backed review modes.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.14 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.14

Adds Venice AI as a supported provider.
Adds macOS managed preferences support for enterprise MDM deployments.
Adds file mentions in review comments (Desktop).
Adds keyboard navigation and shortcuts to the question dock (Desktop).
Adds a one-time confirmation before sharing a session for the first time (TUI).

+1 more show less

Adds support for theme-only plugin packages (Extensions).

6 details in Everything

v1.3.12 Mar 31, 2026 · release notes

OpenCode v1.3.12 enables prompt caching and cache token tracking for Google Vertex Anthropic.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.12 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.12

v1.3.11 Mar 31, 2026 · release notes

OpenCode v1.3.11 adds a dedicated Kimi model system prompt and hardened plugin install safety.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.11 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.11

Adds a dedicated system prompt for Kimi models, improving response quality for that model family.
Pins explicit plugin versions on install and blocks package install scripts, reducing supply-chain risk in extensions.
Skips plugins that lack a matching server or TUI entrypoint with a warning instead of a hard failure, and applies default options from package exports on install.

3 details in Everything

v1.3.7 Mar 30, 2026 · release notes

OpenCode v1.3.7 adds first-class PowerShell support on Windows and preserves JSONC comments during plugin installs.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.7 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.7

Adds first-class PowerShell support on Windows.
Plugin installs now preserve JSONC comments in configuration files.
Adds theme colors for dialog textarea placeholders in the TUI.

3 details in Everything

v1.3.4 Mar 29, 2026 · release notes

OpenCode v1.3.4 adds prompt slots, TUI plugins, AI SDK v6 support, and a GPT system prompt modeled after Codex CLI.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.4

Adds prompt slot feature for structured prompt composition.
Adds TUI plugins support, enabling terminal UI extensibility.
Adds support for AI SDK v6.
Adds a GPT system prompt so non-Codex GPT models follow a Codex CLI-style prompt.
Adds model variant selection dialog in TUI instead of cycling through variants.

+6 more show less

Adds single target plugin entrypoints.
Improves app startup performance.
Closes MCP transport on failed or timed-out connections.
Desktop: persists queued followups across project switches.
Desktop: uses Azure Artifact Signing for Windows releases.
Desktop: resizes layout viewport when mobile keyboard appears.

11 details in Everything

v1.3.3 Mar 26, 2026 · release notes

OpenCode v1.3.3 embeds WebUI in the binary, adds event-sourced session syncing, and improves desktop navigation.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.3

Embeds WebUI directly in the desktop binary with configurable proxy flags, eliminating the need for a separate web server.
Adds initial event-sourced syncing system for session data in core.
Adds createDirectory option to the directory picker in the Electron app.
Skips snapshotting files larger than 2MB to improve performance on large repos.
Moves desktop message navigation from cmd+arrow to cmd+opt+[ / cmd+opt+] to preserve native cursor movement.

+1 more show less

Respects agent permission configuration for the todowrite tool.

6 details in Everything

└──▷ BREAKING ON UPGRADE

!Message navigation keybinds changed from cmd+arrow to cmd+opt+[ / cmd+opt+]; existing muscle memory or documented shortcuts will no longer work.
!The .json extension is removed from electron-store files, enabling seamless Tauri-to-Electron migration but altering the on-disk store path.

v1.3.2 Mar 24, 2026 · release notes

OpenCode v1.3.2 adds heap snapshot capture for TUI and server processes via a new command.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.2

v1.3.1 Mar 24, 2026 · release notes

OpenCode v1.3.1 adds Poe as an auth provider, Bedrock token caching, and syntax highlighting for Kotlin, HCL, Lua, and TOML.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.1 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.1

Adds Poe as a built-in authentication provider with OAuth and API key support.
Enables token caching for custom Amazon Bedrock providers.
Adds syntax highlighting support for Kotlin, HCL, Lua, and TOML files.
Adds manual lock/unlock for theme mode.
Changes command palette shortcut to Cmd+K (with Cmd+P still working as fallback).

5 details in Everything

v1.3.0 Mar 22, 2026 · release notes

OpenCode v1.3.0 adds GitLab Agent Platform, git-backed session review, multistep auth, and Node.js runtime support.

└──▷ GET THIS VERSION

$ git clone --branch v1.3.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.3.0

Adds GitLab Agent Platform integration with automatic workflow model discovery and local tool access (file read/write, shell, etc.) over WebSocket.
Adds git-backed session review modes for inspecting uncommitted changes and branch diffs directly in opencode, with git changes as the default review source.
Supports multistep authentication flows in both TUI and Desktop, enabling providers like GitHub Copilot for Enterprise deployments.
Adds interactive update confirmation dialog for major and minor upgrades, with the ability to skip specific versions.
Adds Node.js runtime support alongside Bun, with a dedicated Node.js entry point and build script that bundles the server with database migrations.

+4 more show less

Adds keyboard shortcut project navigation in the Desktop app (cmd+option+arrow keys).
Adds file type filters and multiple file selection for file uploads in the Desktop app.
Improves xAI reasoning model performance in long multi-turn conversations by switching to the responses API with encrypted content support.
OAuth plan users can now access Codex instructions without whitelisting restrictions.

9 details in Everything

└──▷ BREAKING ON UPGRADE

!The Anthropic OAuth plugin has been removed.

v1.2.26 Mar 13, 2026 · release notes

OpenCode v1.2.26 adds text attachment support, console account subcommands, paginated session history, and desktop multi-window support.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.26 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.26

Supports text attachments in the app.
Adds console account subcommands to the CLI.
Paginates session history for improved server performance.
Adds multi-window support to the Electron desktop app.
Model selection now persists per session in the desktop app.

+2 more show less

Fork session now copies the prompt into the new session.
Synchronizes sidebar state across the application.

7 details in Everything

v1.2.25 Mar 12, 2026 · release notes

OpenCode v1.2.25 adds ARM64 Windows builds, Azure non-OpenAI model support, SAP AI thinking variants, and Vertex AI location config.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.25 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.25

└──▷ TRY IT

Use Vertex AI with a specific region by setting the new environment variable before running opencode.

$ GOOGLE_VERTEX_LOCATION=us-east1 opencode

Opt in to multi-workspace routing (experimental) to test workspace-scoped sessions.

$ OPENCODE_EXPERIMENTAL_WORKSPACES=1 opencode

Supports non-OpenAI Azure models that use completions endpoints.
Adds ARM64 release targets for Windows CLI and desktop.
Adds GOOGLE_VERTEX_LOCATION environment variable support for Vertex AI.
Adds thinking variants support for SAP AI provider.
Adds a debug window to the desktop app.

+3 more show less

Puts workspace routing behind OPENCODE_EXPERIMENTAL_WORKSPACES feature flag.
Blocks access to system directories.
Displays development statistics in the desktop application.

8 details in Everything

v1.2.24 Mar 9, 2026 · release notes

OpenCode v1.2.24 adds workspace support in TUI, GitLab 1M context window, and Copilot GPT-5.4 xhigh.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.24 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.24

Adds initial workspace support in the TUI for multi-project navigation.
Enables GitLab's 1M context window by sending the context-1m-2025-08-07 beta header.
Adds Copilot GPT-5.4 xhigh model support.

3 details in Everything

v1.2.22 Mar 8, 2026 · release notes

OpenCode v1.2.22 adds OPENCODE_SKIP_MIGRATIONS flag and auto-accept-permissions UI docking improvements.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.22 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.22

└──▷ TRY IT

Skip database migrations at startup when you need to run OpenCode against a managed or read-only database.

$ OPENCODE_SKIP_MIGRATIONS=1 opencode

New OPENCODE_SKIP_MIGRATIONS environment flag to bypass database migrations on startup.
Beta channel can now share a database with the stable channel, enabling side-by-side use without data duplication.
Auto-accept-permissions control is now docked in the desktop UI after the thinking phase, with Add File moved to bottom-left.
OpenCode logo added to the new session screen in the desktop app for immediate app identification.

4 details in Everything

v1.2.21 Mar 7, 2026 · release notes

OpenCode v1.2.21 adds a project git init API, interactive timeline visualization, and sidebar reveal animation with hover peek overlay.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.21 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.21

Adds project git init API for initializing Git repositories from within OpenCode.
Adds sidebar reveal animation, hover peek overlay, and weaker dividers to the desktop app.
Enables auto-accept keybind regardless of permission config.
New session now uses the agent model/variant by default; model selection sticks to the session after being changed.
Speeds up share loads.

+1 more show less

Logs stack trace when schema validation fails, aiding debugging of configuration issues.

6 details in Everything

v1.2.19 Mar 6, 2026 · release notes

OpenCode v1.2.19 adds GPT-4.5 to Codex allowed models and improves Node.js compatibility.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.19 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.19

Adds GPT-5.4 to the Codex allowed models list, making it selectable for code generation tasks.

1 detail in Everything

v1.2.18 Mar 5, 2026 · release notes

OpenCode v1.2.18 adds non-interactive auth login options, desktop deep links for new sessions, and clickable inline tool/task components.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.18 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.18

Adds options to auth login command to skip interactive questions, enabling non-interactive/scripted authentication flows.
Adds desktop deep link support for creating new sessions directly from external links.
Adds onClick handler to InlineTool and Task components in the TUI.
Opens search with Mod+F in the desktop app even when the editor is not focused.
Forks Ghostty for a web-based terminal implementation in the desktop app.

5 details in Everything

v1.2.17 Mar 4, 2026 · release notes

OpenCode v1.2.17 adds a default scrollbar in the TUI and reworks the workspace integration and adaptor interface.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.17 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.17

Shows scrollbar by default in the TUI for easier navigation of long sessions.
Validates the agent when running with the --attach flag, catching misconfiguration earlier.
Reworks workspace integration and adaptor interface for improved extensibility.

3 details in Everything

v1.2.16 Mar 3, 2026 · release notes

OpenCode v1.2.16 adds remote workspace support, pending tool-call counts in TUI, compact UI, and a Go provider list command.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.16 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.16

Adds basic remote workspace support, including username/password authentication when connecting to a remote server.
Adds workspace_id to the session table and WorkspaceContext to core.
Shows pending tool call count in the TUI instead of a generic Running… message.
Adds arrow indicator for active tool execution in the TUI.
Adds keybindings to navigate between child sessions.

+12 more show less

Enables markdown rendering by default via OpenTUI upgrade to v0.1.86.
Adds Go provider list command.
Exposes OPENCODE_PID environment variable on shutdown and kills orphaned MCP child processes.
Adds compact UI mode to the desktop app.
Adds recent projects section to the desktop command palette.
Adds auto-accept all permissions mode to the desktop app.
Adds Turkish locale support for app and UI packages.
Adds Warp to the desktop open menu.
Adds comprehensive animation system with multiple easing functions and transition utilities to the desktop app.
Enables faster session switching via windowed rendering and staged timeline in the desktop app.
Adds zen mode feature to the SDK.
Opens the desktop app in PowerShell instead of Command Prompt on Windows.

17 details in Everything

v1.2.15 Feb 26, 2026 · release notes

OpenCode v1.2.15 splits TUI and server configuration for more flexible deployments.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.15 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.15

Splits TUI and server configuration into separate concerns, enabling independent tuning of each.

1 detail in Everything

v1.2.14 Feb 25, 2026 · release notes

OpenCode v1.2.14 adds a message delete endpoint to the core API.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.14 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.14

v1.2.11 Feb 24, 2026 · release notes

OpenCode v1.2.11 adds experimental workspace-serve command, session listing endpoint, and ACP bash output streaming.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.11 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.11

└──▷ TRY IT

Use the new variant parameter to target a specific workflow variant when triggering a GitHub Actions run.

$ opencode github run --variant <variant-name>

Adds experimental workspace-serve command for serving workspace context.
Adds experimental endpoint to list all sessions.
Streams bash output with synthetic pending events in ACP for real-time feedback.
Supports variant parameter in GitHub Actions and opencode github run command.
Caches platform binary in postinstall for faster startup.

+4 more show less

Shows and hides reasoning summaries in the desktop app.
Adds feed customization options in the desktop app.
Adds custom scroll view to the desktop app.
Stays pinned with auto-scroll on todos, questions, and permissions in the desktop app.

9 details in Everything

v1.2.8 Feb 19, 2026 · release notes

OpenCode v1.2.8 adds adaptive thinking for Claude Sonnet 4.6 and collapsible MCP call responses in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.8 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.8

Supports adaptive thinking for Claude Sonnet 4.6 models.
Adds collapsible, visible custom tool and MCP call responses in the TUI.

2 details in Everything

v1.2.7 Feb 19, 2026 · release notes

OpenCode v1.2.7 adds Kilo and GitLab AI providers, Julia LSP, Gemini medium reasoning, and plugin shell.env hooks.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.7 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.7

Adds Kilo as a native AI provider.
Adds Julia language server support for Julia development workflows.
Adds support for medium reasoning with Gemini 3.1.
Bumps GitLab AI provider to 3.6.0, adding Sonnet 4.6 support.
Passes sessionID and callID to the shell.env hook input in plugins.

+6 more show less

Surfaces plugin auth providers in the login picker.
Emits PROMPT_TOO_LARGE error when GitHub context overflows.
Displays a new session banner with logo and project details in TUI.
Adds a warning icon to permission requests for better visibility.
Shows monochrome file icons by default in tree view, revealing colors on hover.
Adds more end-to-end tests for the desktop application.

11 details in Everything

v1.2.6 Feb 16, 2026 · release notes

OpenCode v1.2.6 adds D and Clojure formatters, SQLite migration, Vertex OpenAI-compatible endpoints, and new attach flags.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.6

└──▷ TRY IT

Resume or branch an existing session when attaching to a running OpenCode server.

$ opencode attach --continue
# or to fork the session into a new branch:
opencode attach --fork

Adds dfmt formatter support for D language files.
Adds cljfmt formatter support for Clojure files.
Adds OpenAI-compatible endpoint support for the Google Vertex provider.
Adds Venice provider support for temperature, topP, topK, and smallOption parameters.
Adds a database migration command to convert JSON storage to SQLite.

+2 more show less

Adds --continue and --fork flags to the attach command.
Prioritizes user-defined variables over environment variables in Google Vertex AI configuration.

7 details in Everything

v1.2.5 Feb 15, 2026 · release notes

OpenCode v1.2.5 adds Shift+Tab shortcut and GeistMono Nerd Font option to the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.5 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.5

Adds Shift+Tab keyboard shortcut to the desktop application.
Adds GeistMono Nerd Font to available monospace font options.

2 details in Everything

v1.2.4 Feb 15, 2026 · release notes

OpenCode v1.2.4 adds a db command for database inspection and querying plus a clear-notifications action in the desktop UI.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.4

└──▷ TRY IT

Inspect or query your local OpenCode database directly from the terminal.

$ opencode db

New db command for database inspection and querying.
New Clear notifications action in the desktop UI.

2 details in Everything

v1.2.1 Feb 14, 2026 · release notes

OpenCode v1.2.1 migrates session storage to SQLite and adds a new PartDelta SDK event for incremental updates.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.1 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.1

Migrates all flat-file session data to a single SQLite database on first run, enabling faster and more scalable session storage.
New PartDelta SDK event delivers only incremental changes to parts, avoiding repeated transmission of full text-part content.
Shows all project sessions from any working directory, not just the current one.

3 details in Everything

└──▷ BREAKING ON UPGRADE

!On first run after upgrading, a one-time data migration runs automatically, converting flat files in the data directory to a SQLite database (~/.local/share/opencode/opencode.db* on Linux/macOS, %APPDATA% on Windows); depending on data volume this may take significant time before the tool becomes usable.

v1.2.0 Feb 14, 2026 · release notes

OpenCode v1.2.0 migrates storage to SQLite and adds a PartDelta SDK event plus a --dir CLI flag.

└──▷ GET THIS VERSION

$ git clone --branch v1.2.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.2.0

└──▷ TRY IT

Run opencode against a specific project directory without changing your shell's working directory.

$ opencode run --dir /path/to/project

Migrates session data from flat files to a single SQLite database for improved storage performance and reliability.
New PartDelta SDK bus event (message.part.delta) delivers only incremental text-part changes, eliminating redundant full-content retransmissions.
New --dir option on the run command lets you specify the working directory at invocation time.
Moves timeout configuration from the programmatic API to a CLI flag, enabling per-invocation timeout control.

4 details in Everything

└──▷ BREAKING ON UPGRADE

!On first run, all flat files in the data directory are migrated to ~/.local/share/opencode/opencode.db (or %APPDATA% on Windows); the migration may take significant time depending on data volume and hardware.

v1.1.65 Feb 13, 2026 · release notes

OpenCode v1.1.65 adds a tool.definition plugin hook and desktop improvements including model toggling and auto-reconnect.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.65 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.65

└──▷ USE IT

Override a built-in tool's description or parameters from a plugin to restrict or annotate its behavior for your team.

javascript

// In your opencode plugin
export default {
  hooks: {
    "tool.definition": (tool) => {
      if (tool.name === "bash") {
        tool.description = "Run shell commands (restricted: no sudo allowed)";
      }
      return tool;
    }
  }
}

Adds tool.definition hook for plugins to modify tool descriptions and parameters at runtime.
Enables toggling all provider models at once in desktop settings.
Reconnects the event stream automatically on disconnect in the desktop client.
Desktop notifications now navigate directly to the associated session.

4 details in Everything

└──▷ BREAKING ON UPGRADE

!Worktree delete functionality has been removed.

v1.1.64 Feb 12, 2026 · release notes

OpenCode v1.1.64 adds token substitution in OPENCODE_CONFIG_CONTENT and a new option to disable desktop sound effects.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.64 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.64

└──▷ TRY IT

Inject a dynamic API key or value into OpenCode config at runtime using token substitution in the environment variable.

$ OPENCODE_CONFIG_CONTENT='{"model": "${MY_MODEL}"}' opencode

Supports token substitution in the OPENCODE_CONFIG_CONTENT environment variable, enabling dynamic config injection at runtime.
Adds option to turn off sound effects in the Desktop app.
Adds Windows selection behavior and manual Ctrl+C handling in the TUI.

3 details in Everything

v1.1.62 Feb 12, 2026 · release notes

OpenCode v1.1.62 adds image attachment returns from webfetch and exposes tool arguments in the shell hook for plugins.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.62 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.62

Adds image attachment support to the webfetch tool, returning images fetched from URLs.
Exposes tool arguments in the shell hook, enabling plugins to inspect tool call parameters.

2 details in Everything

v1.1.61 Feb 12, 2026 · release notes

OpenCode v1.1.61 adds diff virtualization for large diffs and SQLite migration progress bar in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.61 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.61

Supports model configurations without requiring npm/api provider details.
Tool outputs are now formatted to be more LLM-friendly.
Adds diff virtualization in the desktop app to improve performance when viewing large diffs.
Displays a progress bar for SQLite migrations in the desktop app.

4 details in Everything

v1.1.60 Feb 12, 2026 · release notes

OpenCode v1.1.60 adds structured outputs, per-model custom API URLs, directory reading, and a TUI session header toggle.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.60 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.60

Supports Claude agent SDK-style structured outputs in the OpenCode SDK.
Supports custom API URL configuration per model.
Adds automatic variant generation for Venice models.
Adds directory reading capability to the read tool.
Makes the read tool offset 1-indexed to match line numbers.

+2 more show less

Adds a toggle to hide the session header in the TUI.
Uses Promise.all for MCP listTools calls to improve performance.

7 details in Everything

v1.1.58 Feb 11, 2026 · release notes

OpenCode v1.1.58 adds mode-specific input placeholders, Ctrl+C dialog dismissal, and persistent /share link access in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.58 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.58

Adds mode-specific input placeholders in the TUI prompt for context-aware guidance depending on the active mode.
Enables dismissing dialogs with Ctrl+C in the TUI.
Keeps the /share command available after sharing so users can copy an existing share link at any time.
Enables notifications on child sessions in the desktop app.

4 details in Everything

v1.1.57 Feb 11, 2026 · release notes

OpenCode v1.1.57 adds WSL backend mode for desktop and improves Amazon Bedrock container credential support.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.57 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.57

Adds WSL backend mode for the desktop application, enabling use on Windows Subsystem for Linux.
Expands Amazon Bedrock authentication to include container credentials.
Improves /review prompt to detect behavior changes more explicitly.
Defaults session sidebar to auto in the TUI.
Adds enhanced Windows app resolution and UI loading states in the desktop app.

5 details in Everything

v1.1.55 Feb 10, 2026 · release notes

OpenCode v1.1.55 shows a helpful message when the free usage limit is exceeded.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.55 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.55

v1.1.54 Feb 10, 2026 · release notes

OpenCode v1.1.54 adds --fork flag, skill discovery via well-known RFC, Wayland support, Cmd+[/] history nav, and drag-and-drop file mentions.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.54 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.54

└──▷ USE IT

Enable model autocomplete in opencode.json by referencing the models.dev schema.

json

{
  "$schema": "https://models.dev/opencode.json"
}

Adds Claude Code-style --fork flag to the TUI to duplicate a session before continuing, preserving the original.
Adds skill discovery from URLs via well-known RFC for automatic capability detection.
Adds native Wayland toggle on Linux desktop.
Adds Cmd+[ / Cmd+] keybinds in the desktop app for session history navigation.
Adds drag-and-drop support for @mentioning files in the desktop app.

+17 more show less

Adds models.dev schema reference for model autocomplete in opencode.json.
Adds directory parameter to the plugin client for multi-project support.
Adds native clipboard image paste support in the desktop app.
Adds new ContextOverflowError type for detecting context-limit conditions.
Enables thinking for all reasoning models on Alibaba Cloud (DashScope).
Adds specific system prompt for the Trinity model.
Adds session.error event publishing for invalid model selection.
Adds session last updated time display in the command palette search.
Adds macOS support for displaying only installed editors and adds Sublime Text as a supported editor.
Adds sidecar server URL persistence via isSidecar prop in the desktop application.
Adds keyboard accelerators to desktop menu bar items.
Parallelize skill downloads for faster loading in the TUI.
Adds toast notification when a session is missing on prompt submit.
Maximizes the main desktop window by default on launch.
Adds loading window and restructures Rust desktop code.
Adds Windows File Explorer icon for the session header.
Adds default clipboard copy affordance to the TextField component.

22 details in Everything

v1.1.53 Feb 5, 2026 · release notes

OpenCode v1.1.53 adds session usage tracking to ACP, file-tree toggle, and external app file opening in Desktop.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.53 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.53

Adds session usage tracking to ACP, surfacing token/cost data per session.
Adds a button in the Desktop UI to open files in external applications.
Allows toggling the file tree closed independently in the Desktop UI.
User plugins now override built-in plugins for the same provider, enabling full customization of provider definitions.

4 details in Everything

v1.1.52 Feb 5, 2026 · release notes

OpenCode v1.1.52 adds Claude 3.5 Sonnet support, key-bindable thinking blocks, model autocomplete, and a TUI bash spinner.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.52 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.52

└──▷ USE IT

Enable model autocomplete when editing opencode.json by referencing the models.dev schema.

json

{
  "$schema": "https://models.dev/opencode.json"
}

Adds Claude 3.5 Sonnet (new) model support.
Enables key-bindable toggle to hide or show thinking blocks in TUI.
Adds models.dev schema reference for model autocomplete in opencode.json.
Adds running spinner to bash tool in TUI for active task visibility.
Bundles GitLab auth plugin directly instead of requiring dynamic install.

+4 more show less

Supports remote server connections in the terminal.
Adds Bosnian locale to the desktop app.
Adds session options to the desktop app session page.
Renders last-turn changes in the desktop review pane.

9 details in Everything

v1.1.51 Feb 4, 2026 · release notes

OpenCode v1.1.51 restores OSC52 clipboard support and prioritizes OPENCODE_CONFIG_DIR for AGENTS.md lookup.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.51 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.51

Prioritizes OPENCODE_CONFIG_DIR environment variable when resolving the AGENTS.md file location.
Restores direct OSC52 clipboard support in the TUI.

2 details in Everything

v1.1.50 Feb 4, 2026 · release notes

OpenCode v1.1.50 adds shell.env hook, Trinity model support, skills directory loading, and --thinking flag for reasoning blocks.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.50 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.50

└──▷ TRY IT

See reasoning blocks inline when running a non-interactive prompt — useful for auditing how the model arrived at an answer.

$ opencode run --thinking "Explain the authentication flow in this codebase"

Inject or override environment variables for all tool and shell invocations without modifying your shell profile.

javascript

// In your opencode plugin (shell.env hook)
export default {
  hooks: {
    "shell.env": (env) => ({
      ...env,
      MY_API_KEY: "secret",
      NODE_ENV: "production",
    }),
  },
};

Adds shell.env hook for manipulating environment variables in tools and shell via plugins.
Adds Trinity model system prompt support.
Supports reading skills from .agents/skills directories.
Adds --thinking flag to the run command to display reasoning blocks.
Allows theme colors in agent customization.

+4 more show less

Adds .slnx to C#/F# LSP root detection.
Makes the CLI run command non-interactive.
Moves session search to the command palette in the desktop app.
Allows empty prompt with review comments in the desktop app.

9 details in Everything

v1.1.49 Feb 3, 2026 · release notes

OpenCode v1.1.49 adds mDNS hostname customization, Haskell formatting, Bedrock Claude Opus caching, SAP AI Core reasoning, and richer desktop/TUI features.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.49 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.49

└──▷ TRY IT

Expose OpenCode on a custom mDNS hostname on your local network for easier discovery across devices.

$ opencode --mdns-domain mydevbox.local

Adds --mdns-domain flag to customize the mDNS hostname for the OpenCode server.
Adds Ormolu code formatter support for Haskell projects.
Adds prompt caching support for Claude Opus on AWS Bedrock.
Adds reasoning variants support for SAP AI Core provider.
Adds User-Agent header for GitLab AI Gateway requests.

+18 more show less

Adds skill dialog in TUI for selecting and inserting skills.
Adds skill slash commands and MCP/skill badges for slash commands in the desktop app.
Adds spinner animation for the Task tool in the TUI.
Adds UI for the skill tool in the TUI session view.
Enables password authentication for remote session attachment.
Adds workspace toggle command to the command palette and prompt input in the desktop app.
Adds session search in the desktop app.
Adds project context menu on right-click in the desktop app.
Adds open project search in the desktop app.
Adds tab close keybind to the desktop app.
Adds keyboard shortcuts for navigating between unread sessions in the desktop app.
Adds UTF-8 encoding defaults for Windows PTY.
Enables user plugins to override built-in auth plugins.
Adds binary file handling in the file view.
Adds responsive design breakpoints for larger screen layouts in the desktop app.
Shows exit message banner in the TUI.
Sends custom agent prompts as developer messages (instead of user messages) when using Codex subscriptions.
Scopes agent variant to the selected model.

23 details in Everything

v1.1.48 Jan 31, 2026 · release notes

OpenCode v1.1.48 adds skills as slash commands, custom models path, and a Copilot-specific provider for reasoning tokens.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.48 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.48

└──▷ TRY IT

Point OpenCode at a custom models definition file — useful when managing multiple model configs across projects or teams.

$ OPENCODE_MODELS_PATH=/path/to/my-models.json opencode

Supports specifying a custom models file path via the OPENCODE_MODELS_PATH environment variable.
Makes skills invokable as slash commands directly in the TUI.
Adds a Copilot-specific provider to properly handle Copilot reasoning tokens.
Respects the OPENCODE_MODELS_URL environment variable during the build process.
Excludes chat models from the textVerbosity setting.

5 details in Everything

v1.1.42 Jan 29, 2026 · release notes

OpenCode v1.1.42 adds sequential numbering for forked session titles and cache token stats in CLI output.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.42 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.42

Adds sequential numbering for forked session titles to distinguish multiple forks of the same session.
Includes cache tokens in CLI statistics output.

2 details in Everything

v1.1.41 Jan 29, 2026 · release notes

OpenCode v1.1.41 adds ctx.abort to the grep tool and AbortSignal support to Ripgrep.files() and GlobTool.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.41 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.41

Adds ctx.abort to the grep tool, enabling cooperative cancellation of grep operations.
Adds AbortSignal support to Ripgrep.files() and GlobTool, allowing callers to cancel file-search operations mid-flight.
Supports Copilot model variants with maxTokens set, enabling use of previously broken model configurations.

3 details in Everything

v1.1.40 Jan 28, 2026 · release notes

OpenCode v1.1.40 adds global configuration, custom provider support, Thai locale, and subtask metadata references.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.40 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.40

Adds SubtaskPart with metadata reference for richer subtask tracking.
Adds global configuration support to the app package.
Adds custom provider support in the desktop app.
Adds Thai locale (th) support in the desktop app.
Enables Ctrl+N and Ctrl+P keyboard shortcuts for popover navigation in the desktop app.

+1 more show less

Adds streaming prop to the markdown element for real-time rendering.

6 details in Everything

v1.1.38 Jan 28, 2026 · release notes

OpenCode v1.1.38 adds an experimental OpenTUI markdown component to the app UI.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.38 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.38

v1.1.37 Jan 28, 2026 · release notes

OpenCode v1.1.37 adds headless ChatGPT/Codex auth, Kimi K2.5 tuning, dynamic AGENTS.md discovery, and a /learn command.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.37 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.37

Supports headless authentication for ChatGPT/Codex providers.
Adds recommended topP and temperature settings for the Kimi K2.5 model.
Adds agent description field to OpenCode agents.
Exposes Instance.directory to custom tools for more accurate path resolution.
Adds worktree context to the plugin tool context.

+12 more show less

Handles Venice cache creation tokens for Venice provider compatibility.
Adds provider settings panel to the app.
Adds a connect provider button to the manage models dialog in the desktop app.
Adds Tauri localization and internationalization support to the desktop application.
Adds a file tree view with mode toggle, diff labels, and color-coded change dots to the desktop app.
Adds a highlights feature and new release modal to the desktop app.
Adds model settings interface to the desktop app.
Adds forward and back navigation buttons to the desktop app.
Adds visual feedback for diff wrap and conceal toggles in the TUI.
Makes diff wrapping toggle always available in the TUI command list.
Uses Anthropic-compatible Messages API for Anthropic models through Copilot.
Attaches Anthropic beta headers when using the Messages API for Copilot.

17 details in Everything

v1.1.36 Jan 25, 2026 · release notes

OpenCode v1.1.36 enables extended thinking for Google Vertex Anthropic models.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.36 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.36

v1.1.35 Jan 25, 2026 · release notes

OpenCode v1.1.35 adds model identity in prompts, xhigh Copilot reasoning, server management UI, subagent back button, and more.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.35 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.35

Tells the model what model it is via the environment section of the prompt.
Adds model information as part of task metadata.
Adds xhigh reasoning effort support for GitHub Copilot GPT-5 models.
Supports GPT-5.1-Codex model in the Codex auth plugin.
Implements new server management UI for web and desktop.

+9 more show less

Adds a back button in subagent sessions in the desktop app.
Auto-opens OAuth links for Codex and Copilot.
Adds Iosevka as a font choice in the desktop app.
Always centers the selected item in selection dialogs.
Retries web fetch with a simple user agent on 403 errors.
Adds an active state to comment cards in the prompt input.
Adds a link icon for copy-to-clipboard buttons in the UI.
New workspace now appears expanded and at the top of the list.
Adds onFilter callback to the List component and hides the add-server row during search.

14 details in Everything

v1.1.34 Jan 23, 2026 · release notes

OpenCode desktop gains line selection functionality.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.34 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.34

v1.1.33 Jan 23, 2026 · release notes

OpenCode v1.1.33 adds GitLab Duo model support, Google Vertex Anthropic thinking presets, and desktop project improvements.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.33 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.33

Adds thinking presets for the Google Vertex Anthropic provider.
Supports OpenAI-based GitLab Duo models as a provider.
Shows file path in the apply_patch request permission screen.
Adds app version display to the desktop settings.
Allows adding projects from any directory depth, including root directory.

+1 more show less

Non-git projects can now be renamed in the desktop app.

6 details in Everything

v1.1.32 Jan 22, 2026 · release notes

OpenCode v1.1.32 adds multi-language desktop support, workspace startup scripts, Venice prompt caching, and remote attach directories.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.32 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.32

└──▷ TRY IT

Attach to a remote OpenCode session in a specific directory without being on that machine locally.

$ opencode attach --dir /remote/path/to/project

Adds workspace startup script support for projects.
Adds prompt cache key support for the Venice provider.
Adds MCP stderr output to the OpenCode log file for easier debugging.
Adds Arabic and Norwegian language support to the desktop app (joining 14 total locales including Brazilian Portuguese).
Adds ability to delete sessions from the desktop app.

+7 more show less

Adds ability to close projects from the hover card in the desktop app.
Adds image rendering in session review in the desktop app.
Adds auto-scroll to bottom when new messages arrive and snaps to bottom on prompt submission.
Adds noop tool to activeTools for LiteLLM proxy compatibility.
Enables remote directory specification via --dir flag in the attach command (TUI).
Moves markdown rendering to Rust in the desktop app for improved performance.
Renames setSessionModel to unstable_setSessionModel in the ACP API.

12 details in Everything

└──▷ BREAKING ON UPGRADE

!The setSessionModel ACP method is renamed to unstable_setSessionModel; any client code calling setSessionModel will break.

v1.1.31 Jan 22, 2026 · release notes

OpenCode v1.1.31 adds a chat.headers hook, Gruvbox theme, and Russian/Traditional Chinese desktop support.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.31 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.31

Adds chat.headers hook for plugins, with Codex and Copilot plugins updated to use it.
Adds Gruvbox theme to the Web and App TUI.
Adds Traditional Chinese language support to the Desktop app (existing Chinese renamed to Chinese (Simplified)).
Adds Russian language support to the Desktop app.
Marks subagent sessions as agent-initiated to exclude them from quota limits.

5 details in Everything

└──▷ BREAKING ON UPGRADE

!The Desktop app's Chinese language option is renamed to Chinese (Simplified).

v1.1.30 Jan 21, 2026 · release notes

OpenCode v1.1.30 adds ACP session list/fork, home-dir expansion for permission patterns, and configurable models.dev domain.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.30 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.30

└──▷ TRY IT

Use a custom models.dev mirror so OpenCode can resolve model metadata in an air-gapped environment.

$ OPENCODE_MODELS_DEV_DOMAIN=models.internal.corp opencode

Adds session/list and session/fork support to ACP (Agent Communication Protocol).
Supports ~ and $HOME prefixes in permission patterns via home directory expansion.
Makes the models.dev domain configurable for use in offline or air-gapped environments.
Updates GitLab packages for improved self-hosted GitLab instance support.
Persists the loaded model and mode when loading ACP sessions.

+1 more show less

Tab key now selects suggestions in the desktop app.

6 details in Everything

v1.1.29 Jan 21, 2026 · release notes

OpenCode v1.1.29 adds Bedrock caching, Laravel Pint formatting, new env flags, multilingual UI, and responsive TUI layout.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.29 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.29

└──▷ TRY IT

Prevent opencode from loading any project-level config — useful in CI or shared environments where per-project config should be ignored.

$ OPENCODE_DISABLE_PROJECT_CONFIG=1 opencode

Skip file modification time checks when working with filesystems that have unreliable mtimes (e.g., network mounts or certain containers).

$ OPENCODE_DISABLE_FILETIME_CHECK=1 opencode

Adds caching support for Claude with AWS Bedrock custom inference profiles.
Adds Laravel Pint as a PHP formatter.
New OPENCODE_DISABLE_PROJECT_CONFIG environment variable to disable project-level configuration loading.
New OPENCODE_DISABLE_FILETIME_CHECK environment variable to skip file modification time checks.
Session titles now respond in the user's language.

+8 more show less

TUI now supports responsive layout for narrow terminal screens.
Adds search functionality to the settings shortcuts panel in the desktop app.
Adds model tooltip metadata in the model chooser dialog.
Adds a manage models icon to the model selector.
Properly integrates native window controls on Windows desktop.
Adds keyboard shortcut (Mod+,) to open the settings dialog.
Adds internationalization support with Japanese, Danish, French, Spanish, German, and Korean translations.
Allows users to select directory text on the new session screen.

13 details in Everything

v1.1.28 Jan 20, 2026 · release notes

OpenCode v1.1.28 adds macOS restart/reload menus, ACP audience support, and a new desktop settings page.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.28 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.28

Adds Restart and Reload menu items on macOS in the desktop app.
Supports ACP audience by mapping to ignore and synthetic.
Adds a settings page to the desktop app.
Adds tooltips to sidebar new session and workspace buttons in the desktop app.
Adds color scheme preview on hover in the appearance dropdown.

+4 more show less

Renders font options in their respective fonts in the font selector.
Adds Windows end-to-end tests for the app.
Changes the new-terminal keybind to Ctrl+Alt+T in the desktop app.
Adjusts Codex prompt to encourage more autonomous decision-making and fewer unnecessary questions.

9 details in Everything

v1.1.27 Jan 20, 2026 · release notes

OpenCode v1.1.27 adds a space-toggle hint in tool selection and lets you select project directory text in the web UI.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.27 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.27

Adds space-toggle hint to the tool selection prompt so keyboard navigation is more discoverable.
Enables selecting and copying project directory text in the web interface.

2 details in Everything

v1.1.26 Jan 19, 2026 · release notes

OpenCode v1.1.26 adds a command execute before hook, raises batch tool limit to 25, and brings vim-style scrolling and mouse permission buttons to the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.26 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.26

Adds a command execute before hook, enabling pre-execution scripts to run before any command.
Increases the maximum batch tool limit from 10 to 25, allowing larger parallel tool calls.
Adds vim-style line-by-line scrolling keybindings to the TUI.
Adds mouse support for permission buttons in the TUI.
Adds an apply_patch tool for OpenAI models.

+10 more show less

Adds a session unshare button to the desktop application.
Adds an uninstall command for OpenCode installed via Windows package managers.
Increases question header and label limits in the question tool.
Auto-routes GPT-5+ models to the Responses API in the GitHub Copilot integration.
Adds proper variant support to the Copilot provider.
Treats .fbs files as text instead of images in tool handling.
Opens the help dialog via the tui/open-help route.
Centralizes OSC 52 clipboard support for SSH sessions.
Adds hover overlay with upload and trash icons to project icon in the edit dialog.
Overhauled Nix flake and packages for improved distribution.

15 details in Everything

v1.1.25 Jan 16, 2026 · release notes

OpenCode desktop app now remembers your last opened project across sessions.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.25 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.25

Desktop app remembers the last opened project so you resume where you left off.
Desktop app truncates long workspace titles for cleaner display.
Dialogs now center on the page rather than on the session panel.

3 details in Everything

v1.1.24 Jan 16, 2026 · release notes

OpenCode v1.1.24 adds LiteLLM proxy provider, MCP OAuth redirect URI config, Carbonfox theme, and unified search in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.24 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.24

Adds LiteLLM proxy provider option for explicit LiteLLM compatibility (litellmProxy).
Adds OAuth redirect URI configuration support for MCP servers.
Adds Carbonfox theme to the TUI.
Adds version display to the session header and /status dialog in the TUI.
Adds tab navigation support for question prompts in the TUI.

+5 more show less

Shows auth URL in the terminal when a browser cannot open in remote sessions.
Adds unified search for commands and files in the desktop app.
Adds ability to edit project and session titles in the desktop app.
Persists workspace order and collapsed state in the desktop app.
Adds skeleton loader for sessions in the desktop app.

10 details in Everything

v1.1.23 Jan 15, 2026 · release notes

OpenCode v1.1.23 adds configurable dialog keybinds, provider-level store option, per-server MCP timeouts, and a new desktop app layout.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.23 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.23

Adds configurable dialog keybinds in the TUI via new configuration option.
Supports provider-level store option for per-provider storage configuration.
Honors per-server MCP timeouts, enabling fine-grained timeout control across MCP servers.
Adds input limit for compaction to cap context sent during compaction.
Introduces a new desktop app layout with repositioned panel toggle and updated session management.

+4 more show less

Persists workspace branch selection and sidebar order/collapsed state across sessions in the desktop app.
Opens external links in the system browser instead of the webview in the desktop app.
Shows session as busy even when it is the currently active session.
Displays a toast error message when ConfigMarkdown parsing fails.

9 details in Everything

v1.1.21 Jan 15, 2026 · release notes

OpenCode v1.1.21 adds official Copilot plugin, AWS Web Identity Token support for Bedrock, and Chocolatey/Scoop upgrade paths.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.21 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.21

└──▷ TRY IT

Upgrade OpenCode on Windows via Chocolatey to get the latest release without manual downloads.

$ choco upgrade opencode

Upgrade OpenCode on Windows via Scoop.

$ scoop update opencode

Adds official GitHub Copilot plugin integration.
Supports AWS Web Identity Token File authentication for Amazon Bedrock.
Adds Chocolatey and Scoop as supported upgrade methods on Windows.
Improves question prompt UX in the TUI.
Adds Copilot reauthentication error messaging to guide users when credentials expire.

5 details in Everything

v1.1.19 Jan 14, 2026 · release notes

OpenCode v1.1.19 adds plan mode, GitLab Duo Agentic Chat provider, and Ask Question tool support for desktop.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.19 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.19

Adds plan mode with dedicated enter and exit tools, enabling structured planning workflows within the agent.
Adds GitLab Duo Agentic Chat as a new provider integration.
Adds Ask Question tool support in the desktop application.
Adds Undertale and Deltarune as new built-in themes.
Adds GPT 5.2 Codex family metadata to the Codex plugin.

+1 more show less

Ensures Bash tool invocations and external directory references render working directory details in the TUI.

6 details in Everything

v1.1.18 Jan 13, 2026 · release notes

OpenCode v1.1.18 adds a fullscreen permission prompt view and provider icons in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.18 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.18

Adds fullscreen view to the permission prompt in the TUI.
Adds provider icons to the desktop application.

2 details in Everything

v1.1.16 Jan 13, 2026 · release notes

OpenCode v1.1.16 adds CLI debug tool calling, desktop password-protected local server, and MCP server management fixes.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.16 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.16

Adds debug tool calling support directly in the CLI for inspecting tool calls during development.
Spawns local server with password in the desktop app for improved security.
Adds icon button for server removal in the dialog select server UI.
Implements better dynamic terminal numbering in the desktop/TUI.
Adds nova-2 to region prefix models.

+2 more show less

Makes environment file reads prompt the user for permission instead of silently blocking.
Stores API URL in session metadata.

7 details in Everything

v1.1.15 Jan 12, 2026 · release notes

OpenCode v1.1.15 adds password authentication, wildcard permission matching, and TUI hints for variant toggling.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.15 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.15

└──▷ TRY IT

Secure your OpenCode server with a password so only authenticated clients can connect.

$ OPENCODE_SERVER_PASSWORD=mysecret opencode

Adds password authentication to improve server security.
Supports wildcard permissions matching commands both with and without arguments.
Adds a hint for the variants toggle in the TUI.
Redesigns tips display on the home screen.

4 details in Everything

└──▷ BREAKING ON UPGRADE

!The OPENCODE_PASSWORD environment variable is renamed to OPENCODE_SERVER_PASSWORD; existing setups using OPENCODE_PASSWORD will no longer authenticate correctly until updated.

v1.1.14 Jan 12, 2026 · release notes

OpenCode v1.1.14 adds MCP resource content type support, mouse interactivity in TUI, and image previews in desktop.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.14 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.14

Supports resource content type in MCP tool output, enabling richer structured data from MCP tools.
Adds mouse hover and click support to the questions tool in the TUI.
Adds mouse hover and click support to the TUI autocomplete.
Adds clickable navigation to the subagent header in the TUI.
Copies OAuth URL to clipboard when device code is unavailable during authentication.

+1 more show less

Adds image preview support for image attachments in the desktop app.

6 details in Everything

v1.1.13 Jan 11, 2026 · release notes

OpenCode v1.1.13 adds session forking, ACP file-modification tracking, symlink-following grep, and configurable desktop server URL.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.13 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.13

Adds ability to fork sessions in the desktop app.
Tracks file modifications in ACP (Agent Communication Protocol).
Passes sessionID to chat.system.transform for richer system prompt customization.
Follows symlinks by default in ripgrep searches.
Supports configuring a default server URL for the desktop app.

+2 more show less

Makes mouse hover and click work on prompt input autocomplete in the desktop app.
Disables telemetry in the PHP language server.

7 details in Everything

v1.1.12 Jan 10, 2026 · release notes

OpenCode v1.1.12 adds ChatGPT-Account-Id header support for OpenAI organization subscriptions.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.12 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.12

Supports ChatGPT-Account-Id header, enabling use with ChatGPT organization subscriptions.

1 detail in Everything

v1.1.11 Jan 10, 2026 · release notes

OpenCode v1.1.11 adds Codex authentication support and GPT-5.2-codex model variants.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.11 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.11

Adds Codex authentication support, enabling OpenCode to authenticate with OpenAI Codex.
Adds GPT-5.2-codex model variants for more granular model selection.

2 details in Everything

v1.1.10 Jan 9, 2026 · release notes

OpenCode v1.1.10 adds Bedrock API key prompting, plugin deduplication, per-session pane visibility, and opt-in server mode.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.10 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.10

Disables the server by default; must now be explicitly opted in to start.
Reports config errors at startup instead of silently terminating.
Adds API key prompt for Amazon Bedrock during auth login.
Deduplicates plugins by name using priority-based resolution when multiple plugins share the same name.
Stores terminal and review pane visibility per session in the desktop app.

5 details in Everything

└──▷ BREAKING ON UPGRADE

!The server is now disabled unless explicitly opted in; setups that relied on the server starting automatically will need to opt in to restore that behavior.

v1.1.8 Jan 9, 2026 · release notes

OpenCode v1.1.8 adds multi-select questions, full-path fuzzy autocomplete, and chunked/lazy message loading in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.8 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.8

Supports multi-select questions in interactive prompts.
Uses full file path for fuzzy matching in autocomplete, improving accuracy when files share names.
Incrementally renders turns with markdown caching and lazy diff rendering for faster desktop UI response.
Implements chunked message loading and lazy diff loading in the desktop app for improved performance with large sessions.
Prefetches adjacent sessions in the desktop app to reduce perceived load time when switching sessions.

+1 more show less

Adds Vesper theme to the desktop app.

6 details in Everything

v1.1.7 Jan 8, 2026 · release notes

OpenCode v1.1.7 adds an interactive question tool, overlay sidebar for narrow screens, expandable bash output, and .claude prompt disabling.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.7 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.7

Adds an interactive question tool for gathering user preferences and clarifying instructions mid-session.
Adds overlay sidebar for narrow screens to improve mobile/small-terminal experience.
Adds expandable bash output for long commands to improve readability in the TUI.
Supports disabling .claude prompt and skills loading via flags.
Writes truncated tool outputs to files instead of silently dropping them.

+4 more show less

Adds kind, title, and rawInput fields to ACP tool_call_update events.
Improves responsive TUI layout by hiding header and footer when sidebar is visible.
Shows custom models without a valid release_date in the web UI model selector.
Adds help text to the debug command and its subcommands.

9 details in Everything

v1.1.6 Jan 7, 2026 · release notes

OpenCode v1.1.6 adds theme support, subagent visibility controls, system CA flag, and tool truncation.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.6

Adds --use-system-ca flag to support system certificate authorities in exec args.
Adds truncation for all tools to prevent runaway output.
Adds theme functionality to the TUI, with live reload when configuration changes.
Adds ability to hide subagents from the primary agent's system prompt.
Makes the General SubAgent visible in the agent list.

+2 more show less

Adds agent color to inline task tool ASCII character and highlights agent name in TUI.
Adds audio input and camera permissions to desktop application entitlements.

7 details in Everything

v1.1.4 Jan 6, 2026 · release notes

OpenCode v1.1.4 adds URL-based instructions, frecency file autocomplete, and AGENTS.md config-dir loading

└──▷ GET THIS VERSION

$ git clone --branch v1.1.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.4

└──▷ TRY IT

Place project-wide agent instructions in your config directory so they are automatically injected into every session's system prompt.

$ # Write your standing instructions once
echo '# Project Rules
Always write tests.' > "$OPENCODE_CONFIG_DIR/AGENTS.md"
# Every subsequent opencode session picks them up automatically
opencode

Supports URL-based instructions, letting you point OpenCode at a remote URL instead of an inline prompt.
Loads AGENTS.md from OPENCODE_CONFIG_DIR into the system prompt for persistent agent instructions.
Adds frecency-based file autocomplete in the TUI CLI for smarter, history-weighted file suggestions.
Adds keyboard shortcut c to copy device code during OAuth flows without leaving the TUI.
Adds a timeout mechanism to prevent hanging operations.

+5 more show less

Adds automatic jp. prefix assignment for the Tokyo region (ap-northeast-1) on AWS.
Adds a view button in the desktop review sidebar to open files directly.
Adds middle-click to close tabs in the desktop review sidebar.
Adds single-instance plugin to prevent multiple desktop windows from opening simultaneously.
Makes subtasks clickable in the desktop task list.

10 details in Everything

v1.1.3 Jan 5, 2026 · release notes

OpenCode v1.1.3 adds Bedrock auth config, Japan cross-region inference, image-to-custom-commands, and CLI install in desktop.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.3

Supports jp. prefix for Amazon Bedrock cross-region inference profiles, enabling Japan-region routing.
Adds configuration options and authentication precedence for Amazon Bedrock.
Passes image parts to custom commands, enabling vision-capable custom command workflows.
Adds system theme resolution and event handling to TUI.
TUI autocomplete now expands directories on Tab and selects on Enter, improving filesystem navigation.

+3 more show less

Stores image attachments directly in the desktop app.
Adds CLI installation option to the desktop application.
Highlights collapsed active project in the desktop sidebar for easier context tracking.

8 details in Everything

v1.1.2 Jan 5, 2026 · release notes

OpenCode v1.1.2 adds session search, SVG preview, cargo fmt support, and AppStream MetaInfo for desktop.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.2

Adds session search functionality with debounced input and server-side filtering.
Adds SVG preview support in the session viewer (desktop).
Adds cargo fmt support with improved Rust formatter detection.
Adds AppStream MetaInfo file for desktop application (Linux app store compatibility).
Adds home icon to the responsive menu in the desktop app.

+1 more show less

Implements auto-scroll for the active command in the slash popover (desktop).

6 details in Everything

v1.1.1 Jan 4, 2026 · release notes

OpenCode v1.1.1 overhauls permissions with granular glob-pattern rules, adds Kotlin LSP, MCP resources, per-project MCP overrides, and more.

└──▷ GET THIS VERSION

$ git clone --branch v1.1.1 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.1.1

└──▷ USE IT

Set fine-grained per-tool permissions using glob patterns in your project config to control what the agent can touch.

json

{
  "permission": {
    "bash": {
      "npm *": "allow",
      "git *": "allow",
      "rm *": "deny",
      "*": "ask"
    },
    "edit": {
      "*.md": "allow",
      "*.ts": "ask",
      "*": "deny"
    }
  }
}

Run a session using a specific agent variant — useful for switching between minimal and full modes in CI or scripting.

$ opencode run --variant minimal

New granular permission config replaces tools, supporting glob-pattern rules per tool (e.g., allow npm *, deny rm *, ask for everything else).
Adds Kotlin LSP integration for language-server-powered code intelligence in Kotlin projects.
Adds MCP resources support, enabling models to access MCP-exposed resources.
Adds per-project MCP config overrides so individual projects can customize their MCP server settings.
New POST /permission/:requestID/reply API endpoint for responding to permission requests programmatically.

+15 more show less

Adds CORS whitelist support via server.cors config option.
New tui.session.select API endpoint for TUI session navigation from plugins.
Adds --variant flag to the run command for selecting agent variants.
Adds /compact session command to compress conversation history.
Adds image preview support in the desktop session viewer.
New Osaka Jade theme available in TUI.
Agent steps field replaces deprecated maxSteps for controlling agent step limits.
Instructions arrays are now merged across config files instead of overridden.
Adds sandbox support for git worktrees, enabling work in multiple project directories simultaneously.
Adds managed git worktrees support.
Adds heap snapshot option to the TUI system menu for memory debugging.
Assistant metadata is now included in session exports.
Adds reject message support to permission dialogs for clearer user feedback.
Adds escape key handling to permission dialogs for keyboard navigation.
File context feature added to the desktop app.

20 details in Everything

└──▷ BREAKING ON UPGRADE

!The PermissionNext.Event structure replaces Permission.Event: event name changed from permission.updated to permission.asked; type field renamed to permission; pattern (string) replaced by patterns (array of strings); message field removed; response renamed to reply; permissionID renamed to requestID; new always field added.
!Old endpoint POST /session/:sessionID/permissions/:permissionID is deprecated in favor of POST /permission/:requestID/reply.
!GET /permission now returns PermissionNext.Request[] instead of Permission.Info[].
!Mode and plugin globs no longer search subdirectories — only top-level files are matched.
!Agent tools field is deprecated — use permission instead.
!Agent maxSteps field is deprecated — use steps instead.

v1.0.222 Jan 1, 2026 · release notes

OpenCode v1.0.222 adds Windows PTY support, in-app update toasts, and subagent mentions in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.222 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.222

Adds Windows support for PTY and cross-platform build scripts in the desktop application.
Adds in-app update toasts to the desktop application.
Adds subagent mention support to the desktop application.

3 details in Everything

v1.0.221 Dec 31, 2025 · release notes

OpenCode v1.0.221 adds LSP watched-file notifications and OpenAI-compatible provider fallback.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.221 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.221

Defaults to ai-sdk/openai-compatible provider when no npm package is specified, broadening out-of-the-box model support.
Adds LSP workspace/didChangeWatchedFiles notification support, keeping the language server in sync with file-system changes.
Improved model selector UI in the desktop app.
Auto-accept colors and better auto-accept affordance added to the desktop app.
New keybind tooltip component added to the desktop app.

+1 more show less

Adds input changes functionality to the desktop app.

6 details in Everything

v1.0.220 Dec 31, 2025 · release notes

OpenCode v1.0.220 adds a debug agent subcommand, MCP prompt tags in autocomplete, and a unified diff toggle in the desktop app.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.220 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.220

└──▷ TRY IT

Quickly validate an agent's behavior in isolation before using it in a real session.

$ opencode debug agent <name>

New debug agent <name> subcommand lets you test agents in isolation without a full session.
Displays MCP tag for prompts in autocomplete so users can distinguish MCP-sourced prompts at a glance.
Adds unified diff toggle to the desktop application for switching diff views.
Redesigned desktop header replaces the status bar with new header elements and an improved new-session button.

4 details in Everything

v1.0.219 Dec 31, 2025 · release notes

OpenCode v1.0.219 adds MCP prompts as slash commands, model usage stats, rustfmt support, and configurable MCP timeouts.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.219 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.219

└──▷ TRY IT

Invoke an MCP-defined prompt directly as a slash command in the TUI instead of constructing it manually.

$ /<mcp-prompt-name>

Adds MCP prompts as slash commands, making MCP-defined prompts directly invocable from the TUI.
Adds model usage statistics with input/output token breakdown to the stats command.
Adds rustfmt formatter support for Rust files.
Adds Gemini 3 Flash to the fast models list.
Bundles @ai-sdk/vercel v1.0.31 for AI SDK v5 support.

+3 more show less

Adds configurable timeout for MCP tool calls to prevent hanging requests.
Adds configurable CORS hosts.
Adds model variants support to the desktop app.

8 details in Everything

v1.0.218 Dec 30, 2025 · release notes

OpenCode v1.0.218 adds Prisma language server support and extract reasoning middleware

└──▷ GET THIS VERSION

$ git clone --branch v1.0.218 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.218

Adds Prisma language server for Prisma schema intelligence inside OpenCode
Adds extract reasoning middleware to surface model chain-of-thought reasoning
Adds CORS exception to support the Tauri desktop application

3 details in Everything

v1.0.214 Dec 30, 2025 · release notes

OpenCode desktop now sorts servers by health and shares projects across all local servers.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.214 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.214

Sorts desktop servers by health status for easier identification of available instances.
Enables project sharing across all local servers in the desktop app.
Improves text selection behavior in the desktop app.

3 details in Everything

v1.0.210 Dec 30, 2025 · release notes

OpenCode v1.0.210 adds web interface project opening, global Claude skills, variants toggle, plugin server URL exposure, and desktop system notifications.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.210 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.210

Adds ability to open projects in the web interface.
Reads global Claude skills in addition to project-specific skills.
Adds a variants toggle.
Exposes server URL to plugins.
Adds readline shortcuts to the desktop app.

+1 more show less

Adds system notifications support for the desktop application.

6 details in Everything

v1.0.209 Dec 30, 2025 · release notes

OpenCode v1.0.209 adds Nix syntax highlighting, nixfmt formatting, and optional WebFetch format parameter.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.209 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.209

Adds Nix syntax highlighting for Nix files.
Adds nixfmt formatter support for Nix files.
Makes the format parameter optional in WebFetch, defaulting to markdown.

3 details in Everything

v1.0.208 Dec 29, 2025 · release notes

OpenCode v1.0.208 adds Bedrock region/bearer-token config, .claude/skills support, local plugin deps, and desktop image previews.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.208 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.208

Adds support for region and bearer token configuration in Amazon Bedrock provider.
Adds support for .claude/skills directory for organizing reusable skill definitions.
Installs local plugin dependencies from package.json automatically.
Adds auto-accept edits toggle in the desktop application.
Adds image preview and deduplication for file uploads in the desktop application.

+2 more show less

Adds project editing functionality in the desktop application.
Makes authentication URLs clickable regardless of line wrapping in the TUI.

7 details in Everything

v1.0.207 Dec 29, 2025 · release notes

OpenCode v1.0.207 adds theme preview and includes CWD in local MCP transport.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.207 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.207

Adds theme preview so users can see how a theme looks before applying it.
Includes the current working directory in local MCP transport, giving MCP servers proper project context.

2 details in Everything

v1.0.205 Dec 28, 2025 · release notes

OpenCode v1.0.205 adds bash completions, themes, thinking/tool-call visibility in /copy and /export, and line-number autocomplete.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.205 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.205

Adds bash shell completions for OpenCode CLI commands.
Adds thinking and tool call visibility settings to the /copy and /export commands.
Supports line numbers and ranges in autocomplete.
Introduces themes support.

4 details in Everything

v1.0.204 Dec 27, 2025 · release notes

OpenCode v1.0.204 adds path traversal protection, shfmt formatting, MCP UI, configurable compaction, and GitHub event support.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.204 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.204

Adds path traversal protection to File.read and File.list operations.
Adds shfmt formatter support for shell scripts.
Adds ability to disable spinner animation via config.
Adds configurable compaction settings to disable auto-compaction and pruning via config instead of flags.
Adds MCP UI for managing Model Context Protocol integrations.

+2 more show less

Adds permissions support.
Adds support for GitHub issues and workflow_dispatch events.

7 details in Everything

v1.0.203 Dec 26, 2025 · release notes

OpenCode v1.0.203 adds Haskell LSP support.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.203 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.203

v1.0.194 Dec 24, 2025 · release notes

OpenCode v1.0.194 adds prompt stashing, Cloudflare AI Gateway, MCP tool-list refresh, and console clipboard copy.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.194 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.194

Adds prompt stashing, letting users save and restore in-progress prompts.
Adds Cloudflare AI Gateway as a new provider.
Handles tools/list_changed notifications in MCP so the client dynamically picks up tool updates without restarting.
Adds console copy-to-clipboard via opentui.
Adds 'Did you know?' tips on the start screen.

5 details in Everything

v1.0.191 Dec 23, 2025 · release notes

OpenCode v1.0.191 adds MCP OAuth debugging, per-agent skill filtering, and compaction hook prompt replacement.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.191 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.191

Adds ability to debug MCP OAuth via the mcp CLI subcommand.
Adds per-agent filtering to skill tool descriptions, letting agents see only relevant tools.
Enables compaction hooks to replace the prompt entirely, giving plugins full control over context compaction.

3 details in Everything

v1.0.186 Dec 22, 2025 · release notes

OpenCode v1.0.186 adds experimental LSP tool, Agent Skills, ARM64 Linux builds, and Windows clipboard image paste.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.186 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.186

└──▷ TRY IT

Paste a screenshot or image directly from the clipboard into a Windows session without saving to disk first.

$ Ctrl+V  (inside an active OpenCode session on Windows to paste a clipboard image)

Adds experimental LSP (Language Server Protocol) tool for richer in-editor language intelligence.
Adds nixd as an LSP provider for the Nix language.
Supports clipboard image paste (Ctrl+V) on Windows.
Adds ARM64 build for Linux desktop app.
Adds Agent Skills support.

+4 more show less

Exposes auto parameter in session.summarize for plugin authors.
Improves built-in /review prompt.
Adds Minimax m2.1 model with topP support alongside adjusted Minimax m2 topK.
Adds mobile responsiveness to the UI.

9 details in Everything

v1.0.185 Dec 21, 2025 · release notes

OpenCode v1.0.185 adds .ets syntax highlighting, schedule event support, and official MCP SDK integration.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.185 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.185

Adds syntax highlighting for .ets files.
Supports schedule events in GitHub Actions integration.
Switches to the official MCP SDK for improved tool schema handling.

3 details in Everything

v1.0.181 Dec 21, 2025 · release notes

OpenCode v1.0.181 adds cursor theme, Catppuccin Frappé theme, default_agent config, and raw markdown docs view.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.181 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.181

└──▷ USE IT

Set a default agent so every session automatically uses it without specifying one each time.

yaml

# In your opencode config file:
default_agent: "<your-agent-name>"

Adds a new Cursor-inspired UI theme via the cursor theme option.
Adds Catppuccin Frappé as a built-in color theme.
Supports configuring a default_agent across all API and user surfaces.
Appending .md to docs page URLs now serves raw markdown content.

4 details in Everything

v1.0.180 Dec 20, 2025 · release notes

OpenCode v1.0.180 adds API endpoints to delete and update message parts.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.180 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.180

v1.0.170 Dec 19, 2025 · release notes

OpenCode v1.0.170 adds markdown rendering for user messages, smooth autocomplete scrolling, and oxlint LSP support.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.170 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.170

Renders user messages as markdown with a toggle to switch between raw and rendered views in the TUI.
Adds smooth scrolling for autocomplete dropdown navigation in the TUI.
Adds oxlint as a supported LSP server.
Adds separate prompt history for the Desktop shell.

4 details in Everything

v1.0.168 Dec 18, 2025 · release notes

OpenCode v1.0.168 adds Ty language server support, a TUI fork slash command, shell mode for desktop, and OIDC_BASE_URL for custom GitHub App installs.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.168 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.168

└──▷ TRY IT

Fork the current session without leaving the keyboard when working in the TUI.

$ /fork

Adds experimental support for the Ty language server.
New /fork slash command in the TUI enables keyboard-friendly session forking.
Adds shell mode for the desktop app.
Supports OIDC_BASE_URL for custom GitHub App installs.
Removes interleaved thinking filter for certain Kimi K2 thinking model providers.

5 details in Everything

v1.0.167 Dec 18, 2025 · release notes

OpenCode v1.0.167 adds a terminal title disable option, copy-logs button on server spawn failure, and improved MCP OAuth handling.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.167 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.167

└──▷ TRY IT

Suppress terminal title changes when running OpenCode inside a multiplexer or logging pipeline that is sensitive to escape sequences.

$ OPENCODE_DISABLE_TERMINAL_TITLE=1 opencode

Adds option to disable terminal title in the TUI via the OPENCODE_DISABLE_TERMINAL_TITLE environment variable.
Adds a Copy Logs button to the server spawn failure dialog in the Tauri desktop app for easier debugging.
Improves MCP authentication and OAuth state handling.

3 details in Everything

v1.0.165 Dec 17, 2025 · release notes

OpenCode v1.0.165 adds session sharing, plugin hooks, new theme, token cap override, and more CLI/desktop enhancements.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.165 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.165

└──▷ TRY IT

Override the default 32k output token cap when working with models that support larger outputs.

$ OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX=65536 opencode

Suppress terminal title changes when running OpenCode inside a multiplexer or shared terminal session.

$ OPENCODE_DISABLE_TERMINAL_TITLE=1 opencode

Adds session.compacting experimental hook enabling pre-compaction context injection for plugins.
Adds task tool execution hooks and command context tracking for plugin authors.
Adds OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX environment variable to override the default 32k output token limit.
Adds OPENCODE_DISABLE_TERMINAL_TITLE environment variable to suppress terminal title updates.
Shows loaded plugins in the /status command output.

+8 more show less

Enables edit and todoread batch operations with clarified error messages.
Adds configurable mentions input for GitHub integration.
Adds Lucent Orange theme.
Adds session sharing feature in the desktop client.
Adds Inter and IBM Plex Mono font support in the desktop client.
Increases session width in TUI to better accommodate longer code blocks.
Adds startup error display in the desktop client.
Adds optimistic prompt submission in the desktop client.

13 details in Everything

v1.0.164 Dec 16, 2025 · release notes

OpenCode v1.0.164 adds experimental oxfmt formatter, shell alias expansion, and desktop session/environment improvements.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.164 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.164

└──▷ TRY IT

Run a shell command via ! using an alias defined in your shell config — useful when your workflow relies on custom aliases like gs for git status.

$ ! gs

Adds experimental oxfmt formatter support for code formatting.
Enables shell alias expansion when using the ! command in the TUI.
Adds a button in the desktop app to load more sessions per project.
Desktop app now loads user shell environment variables.
Desktop app now shows retry attempts during tool execution.

+2 more show less

Desktop app now shows write tool output.
Adds a flag to completely disable the git branch file watcher.

7 details in Everything

v1.0.158 Dec 15, 2025 · release notes

OpenCode v1.0.158 improves fuzzy search by prioritizing results that start with user input.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.158 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.158

v1.0.154 Dec 15, 2025 · release notes

OpenCode v1.0.154 adds auto-submit for --prompt, new transform hooks, and a continue-on-deny agent config option.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.154 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.154

└──▷ TRY IT

Run a one-shot agent task non-interactively — the prompt is now submitted automatically without requiring user input.

$ opencode --prompt "Audit all TODO comments in the codebase and create a summary report"

Allow agents to keep running even when a tool-use action is denied, useful for autonomous workflows where partial denial shouldn't halt the loop.

json

# In opencode config (e.g. opencode.json)
{
  "experimental": {
    "continue_loop_on_deny": true
  }
}

Inject custom context into every system prompt at runtime — useful for dynamically adding project-specific instructions or secrets.

json

# In opencode config
{
  "experimental": {
    "chat": {
      "system": {
        "transform": "path/to/system-transform-hook.js"
      }
    }
  }
}

Adds experimental.chat.system.transform hook for transforming the system prompt at runtime (alongside the restored experimental.chat.messages.transform hook).
Auto-submits the prompt when the --prompt CLI flag is used, removing the need for a manual confirmation step.
New experimental.continue_loop_on_deny config option lets agents continue their loop even when the user denies an action.
Adds a dismiss button to the Getting Started box in the TUI.

4 details in Everything

v1.0.153 Dec 14, 2025 · release notes

OpenCode v1.0.153 adds Gleam, Dockerfile, and TeX language servers, ARM64 Docker images, and a new --session flag for attach.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.153 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.153

└──▷ TRY IT

Attach to a specific existing session by ID instead of the most recent one.

$ opencode attach --session <session-id>

Adds Gleam language server and formatter support.
Adds Dockerfile language server.
Adds TexLab language server and latexindent formatter for LaTeX files.
Adds ARM64 Docker image support.
Adds --session flag to the attach command.

+4 more show less

Adds support for GITHUB_TOKEN authentication and skips OIDC in GitHub environments.
Adds server_error, rate_limit, and no_kv_space retry logic to accommodate Foundry API issues.
Adds topK function to transform, with temperature defaults for GLM and Minimax models.
Falls back to provider default for temperature when no value is configured.

9 details in Everything

v1.0.152 Dec 12, 2025 · release notes

OpenCode gains Windows Git Bash detection and OPENCODE_GIT_BASH_PATH env var for custom shell configuration.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.152 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.152

└──▷ TRY IT

Point OpenCode to a non-standard Git Bash installation on Windows instead of relying on auto-detection.

$ OPENCODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe" opencode

Adds automatic detection of Git Bash on Windows and supports the OPENCODE_GIT_BASH_PATH environment variable to explicitly set the Git Bash path.

1 detail in Everything

v1.0.151 Dec 12, 2025 · release notes

OpenCode v1.0.151 adds an experimental chat.messages.transform hook and in-progress chat indicators in the sessions list.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.151 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.151

Adds experimental chat.messages.transform hook for programmatic transformation of chat messages before they are sent.
Shows an indicator for in-progress chats in the sessions list so active sessions are immediately visible.
Replays conversation history on session load via the ACP protocol.

3 details in Everything

v1.0.150 Dec 11, 2025 · release notes

OpenCode v1.0.150 adds super modifier (Command/Windows key) support in keybinds.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.150 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.150

v1.0.147 Dec 11, 2025 · release notes

OpenCode v1.0.147 adds custom keybindings for all textarea actions, word-navigation shortcuts, and ripgrep in Docker.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.147 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.147

Adds support for custom keybindings for all textarea actions in the input area via config.
Adds Ctrl+Right/Left for word navigation, Ctrl+D for character deletion, and Alt+D for word deletion as default input shortcuts.
Includes ripgrep in the official Docker image, enabling fast code search without extra installation.

3 details in Everything

v1.0.144 Dec 11, 2025 · release notes

OpenCode v1.0.144 adds Cerebras integration, models.dev support, and enables icon discovery by default in the Tauri app.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.144 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.144

Adds Cerebras integration header identifying requests with the opencode identifier.
Adds support for the models.dev model family.
Enables icon discovery feature by default in the Tauri app.
TUI now displays only the count of active MCP servers.
Tauri app now automatically selects an available port instead of defaulting to 4096.

+4 more show less

Uses |- formatting for intermediate sub-agent steps, improving multi-agent output readability.
Improves interleaved thinking functionality.
Sets Gemini thinking level to high by default.
Improves compaction prompt for context management.

9 details in Everything

└──▷ BREAKING ON UPGRADE

!Gemini thinking level is now set to high by default, which may change model behavior and increase token usage for existing Gemini workflows.

v1.0.142 Dec 10, 2025 · release notes

OpenCode v1.0.142 adds Windows shell mode support and scriptable agent creation via CLI flags.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.142 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.142

└──▷ TRY IT

Script agent creation non-interactively in a CI pipeline or setup script.

$ opencode agent create --path ./agents/triage --description "Triage incoming issues" --mode auto --tools read,write

Adds Windows support for shell mode (! command), including cmd.exe and PowerShell.
Adds CLI arguments (--path, --description, --mode, --tools) to the agent create command for scripting and automation.

2 details in Everything

v1.0.141 Dec 10, 2025 · release notes

OpenCode v1.0.141 adds Biome LSP support, per-project colors/names/icons, and a configurable bash timeout env var.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.141 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.141

└──▷ TRY IT

Cap long-running bash tool calls to a custom timeout to avoid hung sessions in CI or restricted environments.

$ OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=10000 opencode

Adds Biome LSP support for linting and formatting integration.
Enables setting custom colors for projects in the TUI.
Adds project names and icons to distinguish projects visually.
Adds automatic project icon discovery from favicon/logo files.
Adds OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS environment variable to configure bash command timeout.

+2 more show less

Enables project discovery for experimental builds.
Improves interleaved thinking support.

7 details in Everything

v1.0.138 Dec 9, 2025 · release notes

OpenCode v1.0.138 adds permission indicator to TUI footer, userId/sessionId telemetry metadata, and project update timestamps.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.138 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.138

Adds a permission indicator to the TUI footer so you can see active permissions at a glance.
Adds userId and sessionId metadata to experimental telemetry for richer session tracking.
Adds project update timestamps to track when projects were last modified.

3 details in Everything

v1.0.137 Dec 9, 2025 · release notes

OpenCode v1.0.137 adds OAuth for remote MCP servers, new LSP support (Bash, Terraform, OCaml), PDF reading, and an uninstall command.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.137 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.137

└──▷ TRY IT

Remove OpenCode and all its installed components cleanly from a machine.

$ opencode uninstall

Adds OAuth authentication support for remote MCP servers.
Adds ability to toggle MCP servers on/off directly in the TUI.
Adds bash-language-server LSP support.
Adds terraform-ls language server and formatter support.
Adds OCaml LSP and ocamlformat support.

+7 more show less

Adds PDF support in the read tool.
Adds uninstall command.
Adds dynamic terminal window title.
Adds optional scrollbar to the session chat.
Adds experimental plugin hook for text completion.
Adds theme support for thinking text opacity.
Adds three new themes: orng, catppuccin-macchiato, and mercury.com.

12 details in Everything

v1.0.134 Dec 5, 2025 · release notes

OpenCode v1.0.134 adds max-steps control for agents, experimental OpenTelemetry tracing, and a new Vercel theme.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.134 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.134

└──▷ USE IT

Enable OpenTelemetry spans to trace opencode agent calls through your existing OTEL-compatible observability stack.

json

# In your opencode config
{
  "experimental": {
    "open_telemetry": true
  }
}

Adds max_steps configuration for supervisor and sub-agents to cap agentic step counts.
Adds experimental experimental.open_telemetry config option to emit OTEL spans for tracing.
Adds Vercel theme for the TUI.
Increases default scroll speed in the TUI.

4 details in Everything

v1.0.133 Dec 4, 2025 · release notes

OpenCode v1.0.133 adds SAP AI Core provider support and optional prompt input for GitHub Actions.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.133 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.133

Adds SAP AI Core as a supported AI provider.
Adds optional prompt input parameter to the OpenCode GitHub Action.

2 details in Everything

v1.0.130 Dec 4, 2025 · release notes

OpenCode v1.0.130 adds primary_tools setting, new TUI commands, and improved DeepSeek reasoning support.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.130 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.130

└──▷ USE IT

Restrict sensitive tools so only your primary agent can invoke them, preventing sub-agents from accessing them.

yaml

experimental:
  primary_tools:
    - bash
    - editor

Bind a key to tool_details and bind messages_last_user to jump back to your last prompt in a long session.

yaml

keybinds:
  tool_details: "ctrl+t"
  messages_last_user: "ctrl+u"

Adds experimental.primary_tools setting to restrict specified tools to primary agents only.
Adds messages_last_user TUI command to jump the view to the last user message.
Adds tool_details keybind (no default assigned) for accessing tool detail views.
Enhances DeepSeek reasoning content handling.
Adds retry logic for Grok resource-exhausted errors.

5 details in Everything

v1.0.129 Dec 3, 2025 · release notes

OpenCode v1.0.129 adds a session list command, username hide toggle, and a copy-on-select disable env var.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.129 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.129

└──▷ TRY IT

List existing sessions directly from the terminal without entering the TUI.

$ opencode session list

Disable automatic copy-on-select in the TUI, useful in environments where it conflicts with terminal clipboard behavior.

$ OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT=1 opencode

Adds basic session list command to list sessions from the CLI.
Adds toggle to hide username in the TUI.
Adds OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT environment variable to disable copy-on-select behavior.
Homebrew update check now uses Homebrew registry version info for more accurate update detection.

4 details in Everything

v1.0.127 Dec 2, 2025 · release notes

OpenCode v1.0.127 adds an overridable /review slash command and toggleable tool details visibility in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.127 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.127

Adds an overridable /review slash command for customizable code review workflows.
Adds ability to toggle tool details visibility in the TUI interface.

2 details in Everything

v1.0.123 Dec 1, 2025 · release notes

OpenCode v1.0.123 adds an Open docs command to the command palette for quick documentation access.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.123 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.123

v1.0.120 Nov 29, 2025 · release notes

OpenCode v1.0.120 adds an explore agent, built-in Dart LSP/formatter, and persistent thinking-block display state.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.120 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.120

Adds an explore agent optimized for fast codebase navigation.
Adds built-in Dart LSP server and formatter for Dart projects.
Persists thinking-blocks display preference to KV store and surfaces its current state in the command list.
Improves task display in session view to show tool names and completion status.

4 details in Everything

v1.0.115 Nov 26, 2025 · release notes

OpenCode v1.0.115 adds model favorites, PR review comment reactions, diff style control, and git branch display in TUI.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.115 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.115

└──▷ USE IT

Disable columnar side-by-side diffs if you prefer a unified diff view in the TUI.

yaml

diff_style: unified

Adds favorites to the model selector for quick access to preferred models.
Enables reacting to PR Review Comments in GitHub workflows.
Adds diff_style option to allow disabling columnar diffs.
Shows the current git branch in the TUI.
Enables Exa code/websearch integration.

5 details in Everything

└──▷ BREAKING ON UPGRADE

!The vcs.changed config key is renamed to vcs.branch.updated; any existing configuration using vcs.changed will break.

v1.0.113 Nov 26, 2025 · release notes

OpenCode v1.0.113 adds setCacheKey option for provider configuration and improves TypeScript LSP scoping.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.113 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.113

Adds setCacheKey option for provider configuration to control cache key behavior.
Switches TypeScript LSP to one instance per package, enabling it to load when TypeScript is not installed at the project root.

2 details in Everything

v1.0.112 Nov 25, 2025 · release notes

OpenCode v1.0.112 adds async prompt support, richer session stats, and a revamped theme selector.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.112 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.112

Adds prompt_async functionality to submit prompts and return immediately without blocking.
Enhances the stats command to display average and median token counts per session.
Improves theme selector UX with a current-theme indicator for easier selection.
Separates session IDs from share IDs for a cleaner URL structure and improved security.
Adds social share images for richer link previews when sharing sessions.

5 details in Everything

v1.0.111 Nov 25, 2025 · release notes

OpenCode v1.0.111 adds async prompt support, richer stats, and theme selector improvements.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.111 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.111

└──▷ TRY IT

List all available models in alphabetical order to quickly locate a specific provider/model combination.

$ opencode models

Adds prompt_async command to submit a prompt and return immediately without waiting for a response.
Enhances opencode models output with alphabetical ordering for easier scanning.
Expands stats command to display average and median token counts per session.
Adds setCacheKey option in provider options for cache control.
Improves theme selector UX with a current-theme indicator and easier selection flow.

5 details in Everything

v1.0.110 Nov 25, 2025 · release notes

OpenCode v1.0.110 adds basic auth support to the SDK.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.110 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.110

v1.0.109 Nov 24, 2025 · release notes

OpenCode v1.0.109 adds --refresh flag for model list updates and an autoupdate notification feature.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.109 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.109

└──▷ TRY IT

Force-refresh the cached model list after adding a new provider or when models seem stale.

$ opencode models --refresh

Adds --refresh flag to the models command to force-refresh the available model list.
Adds autoupdate notification feature to alert users when a new version is available.

2 details in Everything

v1.0.107 Nov 24, 2025 · release notes

OpenCode v1.0.107 adds clearer GitHub Copilot model errors and improved conversation title generation.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.107 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.107

Adds actionable error message for unsupported GitHub Copilot models, including a direct link to enable models in Copilot settings.
Adds explicit fallback model handling when the opencode provider is unavailable.
Improves title generation guidelines for more meaningful conversation titles.

3 details in Everything

v1.0.100 Nov 22, 2025 · release notes

OpenCode v1.0.100 adds timestamp toggle and smarter time display in the TUI

└──▷ GET THIS VERSION

$ git clone --branch v1.0.100 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.100

Adds a toggle to show or hide message timestamps in the TUI
Timestamps now include the date when messages are from a previous day
Displays end time for completed agent loops in the model footer
Model footer now shows session duration timing

4 details in Everything

v1.0.91 Nov 22, 2025 · release notes

OpenCode v1.0.91 adds enterprise session sharing with a dedicated web interface for collaborative sessions.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.91 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.91

Adds enterprise package with session sharing capabilities.
Introduces enterprise web interface for sharing sessions.
Enhances session management and sharing functionality.

3 details in Everything

v1.0.86 Nov 21, 2025 · release notes

OpenCode v1.0.86 adds provider whitelist/blacklist config to control which AI providers are available.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.86 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.86

Adds provider whitelist and blacklist configuration options to restrict or allow specific AI providers.

1 detail in Everything

v1.0.84 Nov 21, 2025 · release notes

OpenCode v1.0.84 adds a TUI onboarding flow, animated progress bar, and user-only message field.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.84 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.84

New animated progress bar replaces text shimmer during model processing in the TUI.
New TUI onboarding flow guides users through initial setup.
Adds a field to allow user-only messages.

3 details in Everything

v1.0.82 Nov 20, 2025 · release notes

OpenCode v1.0.82 adds automatic navigation to child sessions awaiting permissions and updates keybinds and editor conventions.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.82 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.82

Adds automatic navigation to child sessions when they are requesting permissions.
Changes default child session cycle keybinds from ctrl+right/left to <leader>right/left.
Updates editor preference to use the VISUAL environment variable over EDITOR per Unix convention.

3 details in Everything

└──▷ BREAKING ON UPGRADE

!The default child session cycle keybinds are changed from ctrl+right/left to <leader>right/left; any workflow or muscle memory relying on the old binds will no longer work.
!The editor launched by OpenCode now prefers the VISUAL environment variable over EDITOR; if your environment sets both to different values, a different editor may open than before.

v1.0.81 Nov 20, 2025 · release notes

OpenCode v1.0.81 lets users name export files, tune bash output limits, and lands rubocop as the Ruby LSP.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.81 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.81

└──▷ TRY IT

Raise the bash output cap when working with commands that produce large logs, without modifying source code.

$ OPENCODE_EXPERIMENTAL_BASH_MAX_OUTPUT_LENGTH=500000 opencode

Adds OPENCODE_EXPERIMENTAL_BASH_MAX_OUTPUT_LENGTH env var to override the default bash tool output limit.
Enables users to specify a custom filename when exporting conversations.
Replaces ruby-lsp with rubocop for Ruby language server support.

3 details in Everything

└──▷ BREAKING ON UPGRADE

!The /export command now writes to the current working directory; any workflow that relied on the previous fixed output path will need to be updated.

v1.0.79 Nov 20, 2025 · release notes

OpenCode v1.0.79 adds PHP and YAML LSP support, Gemini reasoning summaries, task resume, and bulk LSP/formatter disable options.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.79 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.79

└──▷ USE IT

Disable all LSPs and formatters project-wide when you want a lightweight session without language server overhead.

yaml

lsp: false
formatter: false

Adds PHP Intelephense LSP support for PHP code intelligence in the editor.
Adds YAML language server support for YAML file editing.
Adds ability to display reasoning summaries for Gemini models.
Adds subagents visibility in the agents modal.
Enables task tool resume capabilities so interrupted tasks can be continued.

+2 more show less

Adds top-level lsp: false and formatter: false config options to disable all LSPs or all formatters at once.
Disables fetch timeout by default in provider options, removing artificial request limits.

7 details in Everything

v1.0.76 Nov 18, 2025 · release notes

OpenCode v1.0.76 adds opencode agent list to browse all available agents with details.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.76 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.76

└──▷ TRY IT

Discover which agents are configured and available before starting a session.

$ opencode agent list

v1.0.73 Nov 18, 2025 · release notes

OpenCode v1.0.73 adds Nix installation support and Swift syntax highlighting.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.73 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.73

Adds Nix support for installing and managing OpenCode as a package.
Adds Swift syntax highlighting support in the editor/output.
Reworked default model selection.

3 details in Everything

└──▷ BREAKING ON UPGRADE

!scroll_speed now only accepts positive integers; non-integer positive numbers that were previously valid are no longer accepted.

v1.0.69 Nov 17, 2025 · release notes

OpenCode v1.0.69 adds Azure Cognitive Services support, a /thinking toggle command, and per-tool batch UI feedback.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.69 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.69

└──▷ TRY IT

Toggle thinking block visibility mid-session to inspect model reasoning when debugging complex responses.

$ /thinking

Adds /thinking slash command to toggle visibility of thinking blocks in OpenTUI.
Adds support for Azure Cognitive Services as a provider.
Adds copy option to message context menu.
Enhances batch processing with per-tool UI feedback and UX improvements.
Improves retry display and handling for retry-after values exceeding 10 minutes.

5 details in Everything

v1.0.66 Nov 16, 2025 · release notes

OpenCode v1.0.66 adds a batch tool, image support in MCP responses, GPT-5-nano, and a new Flexoki theme.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.66 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.66

Adds experimental batch tool for running multiple operations in one invocation.
Adds Flexoki theme as a new UI color scheme.
Supports local file paths for custom providers.
Supports images in MCP tool responses.
Adds global.event.subscribe() to the SDK for event-driven integrations.

+1 more show less

Adds GPT-5-nano model as a selectable option.

6 details in Everything

v1.0.63 Nov 13, 2025 · release notes

OpenCode v1.0.63 adds scroll acceleration in the TUI and enables Windows builds.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.63 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.63

Adds scroll acceleration support to the TUI for faster navigation through long outputs.
Enables Windows builds, making OpenCode officially available on Windows via bun and pnpm global installs.

2 details in Everything

v1.0.62 Nov 13, 2025 · release notes

OpenCode v1.0.62 adds expandable sections to the sidebar.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.62 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.62

v1.0.59 Nov 12, 2025 · release notes

OpenCode v1.0.59 adds agent color configuration and hides /share when disabled.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.59 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.59

Adds per-agent color configuration for visual differentiation in the TUI.
Hides the /share command from the UI when sharing is disabled.

2 details in Everything

v1.0.57 Nov 11, 2025 · release notes

OpenCode v1.0.57 adds web and codesearch tools plus project ID caching for faster git-based workflows.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.57 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.57

Adds web and codesearch tools for use within OpenCode sessions.
Caches project ID in the root git folder for improved performance.
Keeps the session dot visible in the list for the currently active session.
Upgrades the toast notification system.
Updates the code editor dark mode appearance.

5 details in Everything

v1.0.56 Nov 11, 2025 · release notes

OpenCode v1.0.56 adds inline LSP diagnostics, web search, code search, and thinking block support in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.56 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.56

Adds inline LSP diagnostics in the TUI file viewer, surfacing type errors and compilation issues without leaving the interface.
Adds web search and code search tools for use during sessions.
Adds support for reading thinking blocks in the TUI.
Improves todo synchronization.
Enhances session selection UI to keep the current active session visible in the list.

+1 more show less

Upgrades toast notification system for better user feedback.

6 details in Everything

v1.0.53 Nov 10, 2025 · release notes

OpenCode v1.0.53 adds doom loop & external directory permission config, input context to chat params, and free-model badges.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.53 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.53

Adds configurable doom loop and external directory permissions settings.
Adds input context fields to chat.params and chat.message.
Displays a Free badge on zero-cost models in the model selection dialog.
Adds startup logging when creating project instances to aid debugging.

4 details in Everything

v1.0.52 Nov 10, 2025 · release notes

OpenCode v1.0.52 adds reasoning syntax highlighting, free-model badges, and configurable doom loop & directory permissions

└──▷ GET THIS VERSION

$ git clone --branch v1.0.52 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.52

Renders reasoning parts with syntax highlighting instead of plain text for easier review of model chain-of-thought
Displays a Free badge on zero-cost models in the model selection dialog
Adds user-configurable doom loop and external directory permissions
Sets a cap on maximum wait time between retries
Improves session UI with better sidebar toggle and message handling

5 details in Everything

v1.0.50 Nov 9, 2025 · release notes

OpenCode v1.0.50 adds session/agent/model/messageID context to chat plugin hooks

└──▷ GET THIS VERSION

$ git clone --branch v1.0.50 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.50

v1.0.45 Nov 8, 2025 · release notes

OpenCode v1.0.45 adds .opencode/ directory config support and Ghostty terminal key bindings via opentui 0.1.39.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.45 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.45

Supports reading opencode.json(c) config from a .opencode/ directory, enabling project-scoped config organization.
Adds shift/ctrl+return/esc key binding support in Ghostty terminal via opentui 0.1.39 custom CSI sequences.
Routes polaris-alpha models to the polaris system prompt for consistent behavior.

3 details in Everything

v1.0.43 Nov 7, 2025 · release notes

OpenCode v1.0.43 adds session rename from the command bar and reworks ACP for Zed IDE compatibility.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.43 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.43

Adds a command bar action to rename sessions directly within the TUI.
Reworked Agent Communication Protocol (ACP) to support Zed IDE integration.

2 details in Everything

v1.0.40 Nov 7, 2025 · release notes

OpenCode v1.0.40 adds VS Code Insiders support and network IP retrieval for remote web access.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.40 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.40

Adds VS Code Insiders as a supported editor integration.
Implements network IP retrieval for remote access when using the web command.

2 details in Everything

v1.0.37 Nov 6, 2025 · release notes

OpenCode v1.0.37 adds system theme support and a desktop review flow.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.37 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.37

Adds system theme support, allowing the UI to follow the OS light/dark theme preference.
Adds a desktop review flow for reviewing changes directly within the desktop app.

2 details in Everything

v1.0.36 Nov 6, 2025 · release notes

OpenCode v1.0.36 adds share link support in import and a current-session indicator in the session modal.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.36 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.36

└──▷ TRY IT

Import a shared session directly from a share link instead of a local file.

$ opencode import <share-link>

Adds share link support to the import command, enabling direct import of shared sessions via URL.
Adds a big dot (●) indicator in the session modal to highlight the current active session.

2 details in Everything

v1.0.27 Nov 5, 2025 · release notes

OpenCode v1.0.27 adds file change counts to session summaries.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.27 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.27

Adds file count to session summary, displaying the number of files changed alongside additions and deletions.

1 detail in Everything

v1.0.26 Nov 5, 2025 · release notes

OpenCode v1.0.26 adds --attach flag to opencode run and a scrollable sidebar.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.26 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.26

└──▷ TRY IT

Attach to an already-running OpenCode session instead of spawning a new one.

$ opencode run --attach

Adds --attach flag to opencode run for attaching to a running session.
Restructured Sidebar component to be scrollable, improving navigation in long sessions.
Lowers paste summary threshold so shorter pasted content is summarized automatically.

3 details in Everything

v1.0.25 Nov 5, 2025 · release notes

OpenCode v1.0.25 adds /export and /copy TUI commands, Clojure syntax highlighting, and R formatter support.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.25 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.25

└──▷ TRY IT

Export the current session to a file or copy it to clipboard directly from the TUI.

$ /export

Reference an agent mid-prompt to keep context natural without restructuring your input.

$ Summarize this code and then ask @reviewer to check it for security issues

Adds /export and /copy commands to the TUI for sharing or extracting session content.
Enables @agent references anywhere in a prompt, not just at the start.
Adds Clojure syntax highlighting support.
Adds R language formatter support.

4 details in Everything

v1.0.24 Nov 5, 2025 · release notes

OpenCode v1.0.24 adds command bar session interrupt, uv format support, and GitHub Enterprise Copilot integration.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.24 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.24

Adds command bar option to interrupt a running session.
Supports uv format as a formatter.
Adds GitHub Enterprise support for Copilot.

3 details in Everything

v1.0.21 Nov 4, 2025 · release notes

OpenCode v1.0.21 adds scoped npm plugin support, /mcp alias, and disable_paste_summary setting.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.21 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.21

└──▷ TRY IT

Quickly check MCP server status using the new /mcp alias instead of /status.

$ /mcp

Supports scoped npm packages as plugins (e.g., @org/plugin-name).
Adds /mcp as an alias for the /status command.
Honors the disable_paste_summary setting to suppress paste summaries.

3 details in Everything

v1.0.20 Nov 4, 2025 · release notes

OpenCode v1.0.20 adds OPENCODE & AGENT environment variables for scripting and automation.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.20 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.20

└──▷ TRY IT

Reference the current agent name inside a shell tool or script to conditionally change behavior per agent.

$ echo $AGENT

Exposes OPENCODE and AGENT environment variables for use in sessions and tooling.

1 detail in Everything

v1.0.19 Nov 4, 2025 · release notes

OpenCode v1.0.19 adds a stats command to display usage statistics.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.19 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.19

└──▷ TRY IT

Check your session usage statistics without leaving the terminal.

$ opencode stats

New stats command displays usage statistics directly from the CLI.

1 detail in Everything

v1.0.18 Nov 3, 2025 · release notes

OpenCode v1.0.18 adds copy-last-message to session menu and Ctrl+_ keybind support.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.18 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.18

Adds 'copy last assistant message' action to the session menu.
Supports Ctrl+_ key combination in the keybind parser.

2 details in Everything

v1.0.16 Nov 3, 2025 · release notes

OpenCode v1.0.16 adds optional directory scoping to file search and richer subagent type info in task display.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.16 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.16

Adds optional dirs parameter to the file search API, enabling scoped file searches within specific directories.
Enhances task display to surface subagent type information.

2 details in Everything

v1.0.15 Nov 3, 2025 · release notes

OpenCode v1.0.15 adds /timeline command for quick navigation to specific messages in session history.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.15 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.15

└──▷ TRY IT

Jump to a specific point in a long session without scrolling through the entire history.

$ /timeline

v1.0.13 Nov 2, 2025 · release notes

OpenCode v1.0.13 adds /timeline command for quick session history navigation and restores child session cycling.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.13 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.13

└──▷ TRY IT

Jump to a specific earlier message in a long session without scrolling manually.

$ /timeline

New /timeline command lets you quickly navigate to specific messages within a session's history.

1 detail in Everything

v1.0.9 Nov 1, 2025 · release notes

OpenCode v1.0.9 adds /exit command and new aliases for TUI commands including /summarize, /clear, and /resume.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.9 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.9

└──▷ TRY IT

Exit the TUI cleanly from the command prompt instead of using a keyboard interrupt.

$ /exit

Resume a previous session using the more intuitive /continue alias.

$ /continue

Adds /exit command (with aliases /quit and /q) to quit the TUI without reaching for Ctrl-C.
Adds /summarize as an alias for /compact, /clear as an alias for /new, and /resume//continue as aliases for /session.
Extends TUI autocomplete to recognise all new command aliases.

3 details in Everything

v1.0.8 Nov 1, 2025 · release notes

OpenCode v1.0.8 adds --prompt CLI option, sidebar position memory, formatter status display, and share URL toast notifications.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.8 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.8

└──▷ TRY IT

Kick off a coding session with a pre-filled prompt without typing it interactively.

$ opencode --prompt "Refactor the auth module to use JWT tokens"

Adds --prompt option to the TUI for passing a prompt directly at launch.
Remembers sidebar position across sessions in the TUI.
Displays formatter status in the TUI status dialog.
Shows a toast notification when a /share URL is copied to clipboard.
Makes /init a default slash command on the server side.

5 details in Everything

v1.0.3 Oct 31, 2025 · release notes

OpenCode v1.0.3 adds /rename, /editor, /theme commands, theme config support, and Ctrl+D to exit.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.3

└──▷ TRY IT

Rename your current session to something meaningful without leaving the TUI.

$ /rename my-investigation-session

Open the current context in your external editor mid-session for richer editing.

$ /editor

Switch your UI theme interactively while working.

$ /theme

New /rename command lets you rename the current session from within the TUI.
New /editor command (available in autocomplete) opens an external editor.
New /theme command for switching themes interactively.
Adds theme support in config, allowing themes to be set persistently.
Allows Ctrl+D to exit the application.

+1 more show less

Improved error boundary now includes a button to quickly create a GitHub issue.

6 details in Everything

└──▷ BREAKING ON UPGRADE

!The setSelectedTheme function is renamed to set in the theme selection API — any tooling or scripts calling setSelectedTheme will break.
!The -h alias is removed from TUI spawn and thread commands — scripts using -h as a short flag for those commands will break.

v1.0.2 Oct 31, 2025 · release notes

OpenCode v1.0.2 adds tab-key selection to TUI autocomplete with improved styling.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.2

Supports Tab key for selecting autocomplete options in the TUI, enabling keyboard-driven completion without leaving the home row.
Improves autocomplete component styling with better text wrapping and layout for clearer option display.

2 details in Everything

v1.0.0 Oct 31, 2025 · release notes

OpenCode 1.0 rewrites the TUI in zig+solidjs, adding a command bar (ctrl+p) and session sidebar.

└──▷ GET THIS VERSION

$ git clone --branch v1.0.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v1.0.0

└──▷ TRY IT

Upgrade an existing OpenCode installation to 1.0 without waiting for auto-update.

$ opencode upgrade 1.0.0

Roll back to the last stable 0.x release if the new TUI breaks your workflow.

$ opencode upgrade 0.15.31

New TUI built on an in-house zig+solidjs framework (OpenTUI), replacing the go+bubbletea implementation for improved performance and capability.
Adds a command bar accessible via ctrl+p from any context, centralizing all available actions.
Adds a toggleable session sidebar displaying contextual session information.
Introduces compressed session history view, with full details shown only for edit and bash tool outputs.

4 details in Everything

└──▷ BREAKING ON UPGRADE

!The system theme has not been ported to the new TUI and is unavailable.
!Custom themes are not loaded in the new TUI.
!Keybind messages_revert is renamed to messages_undo.
!Keybind switch_agent is renamed to agent_cycle.
!Keybind switch_agent_reverse is renamed to agent_cycle_reverse.
!Keybind switch_mode is renamed to agent_cycle.
!Keybind switch_mode_reverse is renamed to agent_cycle_reverse.
!Keybinds messages_layout_toggle, messages_next, messages_previous, file_diff_toggle, file_search, file_close, file_list, app_help, project_init, tool_details, and thinking_blocks have been removed.

v0.15.30 Oct 31, 2025 · release notes

OpenCode v0.15.30 adds optional headers to model config for custom API integration.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.30 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.30

└──▷ USE IT

Pass custom authentication or routing headers to a model API endpoint without modifying the request pipeline.

json

{
  "model": {
    "headers": {
      "X-Custom-Auth": "my-token",
      "X-Routing-Key": "team-a"
    }
  }
}

v0.15.23 Oct 29, 2025 · release notes

OpenCode v0.15.23 adds --title flag for named run sessions and OPENCODE_CONFIG_DIR for custom config paths.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.23 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.23

└──▷ TRY IT

Label an automated run session for easy identification in logs or session history.

$ opencode run --title "nightly-audit" "Review all authentication handlers for injection risks"

Point OpenCode at a project-specific config directory, e.g. in a CI pipeline with per-repo settings.

$ OPENCODE_CONFIG_DIR=./infra/opencode-config opencode run "Scan for hardcoded secrets"

Adds --title flag to opencode run for setting custom session titles.
Adds OPENCODE_CONFIG_DIR environment variable to load configuration from a custom directory.

2 details in Everything

v0.15.19 Oct 28, 2025 · release notes

OpenCode v0.15.19 adds ACP MCP server support, file diffs, default slash commands, and a new session.started event.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.19 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.19

└──▷ TRY IT

Test VCS-dependent behaviour in a controlled environment without a real git repo.

$ OPENCODE_FAKE_VCS=1 opencode

Adds MCP server support, file diffs, and default slash commands (/init, /compact) in ACP.
Adds session.started event that triggers when a new session is created.
Adds OPENCODE_FAKE_VCS flag for VCS testing.

3 details in Everything

v0.15.18 Oct 26, 2025 · release notes

OpenCode v0.15.18 adds noReply parameter for response control and improves title generation reliability.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.18 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.18

Adds noReply parameter to control whether a response is returned.
Enables disabling of provider timeout via the timeout parameter.

2 details in Everything

v0.15.17 Oct 25, 2025 · release notes

OpenCode v0.15.17 adds ACP slash commands, agents, permissions, and @-references, plus Lua LSP support.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.17 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.17

Adds ACP slash commands, agents, permissions, and @ references support.
Adds Lua LSP support.

2 details in Everything

v0.15.15 Oct 24, 2025 · release notes

OpenCode v0.15.15 adds wildcard flag parsing support for the bash tool.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.15 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.15

v0.15.14 Oct 23, 2025 · release notes

OpenCode v0.15.14 adds model management in ACP sessions, experimental turn summarization, and agent switching without model changes.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.14 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.14

Adds model management to ACP sessions, enabling users to manage models directly within agent sessions.
Adds experimental turn summarization to compact conversation history and manage long conversations.
Adds parent ID tracking to assistant messages for improved conversation context.
Adds Amazon Nova models to the us-* prefix requirement list for proper model routing.
Adds option to switch agents without changing the active model.

+1 more show less

Improves editor detection with auto-discovery and better error messages.

6 details in Everything

v0.15.11 Oct 21, 2025 · release notes

OpenCode v0.15.11 adds -f/--file flag to run files directly from the CLI.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.11 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.11

└──▷ TRY IT

Run a specific script or prompt file directly without interactive mode.

$ opencode run -f <path>

v0.15.9 Oct 20, 2025 · release notes

OpenCode v0.15.9 adds Astro language server support with automatic installation for .astro files

└──▷ GET THIS VERSION

$ git clone --branch v0.15.9 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.9

v0.15.4 Oct 16, 2025 · release notes

OpenCode v0.15.4 adds Slack integration, custom tool plugins, image file reading, and session-aware attach commands.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.4

└──▷ TRY IT

Reconnect to a known session by ID instead of picking from a list — useful in scripts or multi-session workflows.

$ opencode attach --session <session-id>

Bootstrap an OpenCode server and client together in a single call when embedding OpenCode in a custom SDK integration.

javascript

import { createOpencode } from '@opencode/sdk';

const { server, client } = await createOpencode({ /* options */ });

Launch the TUI programmatically from within another Node.js application or automation script.

javascript

import { createOpencodeTui } from '@opencode/sdk';

await createOpencodeTui({ /* options */ });

Adds --session option to the attach command for connecting to a specific session.
Adds Slack integration package with Bolt framework support.
Simplifies SDK setup with a single createOpencode function that creates both server and client.
Adds createOpencodeTui() function to the SDK for programmatic TUI launching.
Adds support for custom tools through the plugin system.

+5 more show less

Enables the read tool to handle image files.
Adds useCompletionUrls option to fix certain Azure provider setups.
Includes stack traces in server error responses for easier debugging.
Adds Australian region support for Sonnet 4.5 via Bedrock cross-region inference.
Applies streaming API to the compact feature for improved performance.

10 details in Everything

v0.15.3 Oct 14, 2025 · release notes

OpenCode v0.15.3 adds session targeting for attach and a new Slack/Bolt integration package.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.3

└──▷ TRY IT

Connect to a specific existing session by name instead of the default session.

$ opencode attach --session <session-id>

Adds session option to the attach command, enabling connection to a specific named session.
New Slack integration package with Bolt framework support for building OpenCode-powered Slack bots.
Exports trimDiff function from the edit tool, making it available as part of the public API.

3 details in Everything

v0.15.0 Oct 12, 2025 · release notes

OpenCode v0.15.0 adds Perl6 file extension support and ensures plugin availability in .opencode folder.

└──▷ GET THIS VERSION

$ git clone --branch v0.15.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.15.0

Adds support for Perl6 file extensions.
Ensures @opencode-ai/plugin is available in the .opencode folder.

2 details in Everything

v0.14.7 Oct 10, 2025 · release notes

OpenCode v0.14.7 adds Vertex AI, image reading, session forking, SSE streaming, and a new output-format flag

└──▷ GET THIS VERSION

$ git clone --branch v0.14.7 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.14.7

└──▷ TRY IT

Inspect the fully resolved OpenCode config to verify provider keys, tool settings, and plugin hooks are loaded correctly.

$ opencode debug config

Programmatically launch the TUI from a Node.js script — useful for embedding OpenCode in custom developer tooling or wrappers.

javascript

import { createOpencodeTui } from 'opencode'

await createOpencodeTui()

Adds Vertex AI support via google-vertex and google-vertex-anthropic providers
Enables the read tool to handle images, not just text files
New --output-format flag streams JSON output from commands
New debug config command for inspecting resolved configuration
Adds session forking functionality and corresponding API endpoints

+10 more show less

New todo list API endpoint alongside session forking endpoints
Adds SSE streaming support to the service layer
Dynamic tool registration for plugins and external services
New plugin hook for config, enabling config-time customization
Adds createOpencodeTui() function for programmatic TUI launching
New createOpencodeServer function with readiness waiting and random port usage
Simplified JS SDK setup via single createOpencode function; /client and /server import paths added
Adds timeout messages for commands that exceed their time limit
Experimental skip-bootstrap feature for faster startup
Switches file-watching from chokidar to @parcel/watcher for improved cross-platform performance

15 details in Everything

v0.14.6 Oct 7, 2025 · release notes

OpenCode v0.14.6 adds MCP server status monitoring, connection timeouts, and new todo event types.

└──▷ GET THIS VERSION

$ git clone --branch v0.14.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.14.6

└──▷ TRY IT

Check which MCP servers are connected and their current status without leaving your workflow.

$ curl http://localhost:<port>/mcp

New GET /mcp endpoint to check real-time connection status of MCP servers.
Adds 5-second timeout to MCP client verification, automatically removing unresponsive clients during initialization.
Adds new todo-related event types to the event system.

3 details in Everything

v0.14.4 Oct 7, 2025 · release notes

OpenCode v0.14.4 adds todo list management and session forking via API

└──▷ GET THIS VERSION

$ git clone --branch v0.14.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.14.4

Adds todo list functionality with dedicated API endpoints for task tracking within sessions.
Adds session forking capability to spin up new sessions branched from existing ones (API only).
Adds timeout message surfacing so users know when a command has exceeded its time limit.

3 details in Everything

v0.14.3 Oct 5, 2025 · release notes

OpenCode v0.14.3 adds Vertex AI providers, a debug config command, and a simplified SDK init function.

└──▷ GET THIS VERSION

$ git clone --branch v0.14.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.14.3

└──▷ TRY IT

Inspect the resolved runtime configuration — useful for verifying provider settings or diagnosing unexpected behavior.

$ opencode debug config

Adds google-vertex and google-vertex-anthropic providers for Vertex AI support.
New opencode debug config command outputs the current configuration as JSON for troubleshooting.
Introduces a simplified SDK initialization via a single createOpencode function that creates both server and client automatically.

3 details in Everything

v0.13.6 Oct 1, 2025 · release notes

OpenCode v0.13.6 adds directory support to @ mentions and overhauled file search.

└──▷ GET THIS VERSION

$ git clone --branch v0.13.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.13.6

Supports @ mentioning directories in addition to files for faster context inclusion.
Overhauled file search for improved discovery and usability.

2 details in Everything

v0.11.4 Sep 26, 2025 · release notes

OpenCode v0.11.4 adds a command palette, fuzzy file open, and a changes view to the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v0.11.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.11.4

Adds a command palette for quick access to actions within the TUI.
Adds fuzzy file open for fast file navigation.
Adds a changes view for reviewing file changes inline.

3 details in Everything

v0.11.2 Sep 23, 2025 · release notes

OpenCode v0.11.2 adds Java LSP server support for in-editor language intelligence.

└──▷ GET THIS VERSION

$ git clone --branch v0.11.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.11.2

v0.10.0 Sep 18, 2025 · release notes

OpenCode v0.10.0 adds GLM coding plan support and custom tool integration

└──▷ GET THIS VERSION

$ git clone --branch v0.10.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.10.0

Supports GLM coding plan for structured AI-assisted coding workflows.
Adds custom tools support, enabling users to define and integrate their own tools into OpenCode.
Includes plugin tool updates expanding the extensibility of the tool system.

3 details in Everything

v0.9.3 Sep 16, 2025 · release notes

OpenCode v0.9.3 adds npm package tracking and special reasoning support for the opencode provider.

└──▷ GET THIS VERSION

$ git clone --branch v0.9.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.9.3

Adds npm package tracking to provider model mapping for more accurate model resolution.
Implements special reasoning handling for the opencode provider.
Updates provider options mapping to use npm package names.

3 details in Everything

v0.9.1 Sep 15, 2025 · release notes

OpenCode v0.9.1 ships a new desktop/web app package.

└──▷ GET THIS VERSION

$ git clone --branch v0.9.1 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.9.1

v0.8.0 Sep 14, 2025 · release notes

OpenCode v0.8.0 adds autocompact control and a new subtask flag for subagent command execution.

└──▷ GET THIS VERSION

$ git clone --branch v0.8.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.8.0

└──▷ TRY IT

Prevent OpenCode from automatically compacting your context — useful when you want full control over what stays in the session.

$ OPENCODE_DISABLE_AUTOCOMPACT=1 opencode

New OPENCODE_DISABLE_AUTOCOMPACT environment variable lets users disable automatic context compaction.
Autocompact is now automatically disabled when context size is set to 0.
New --subtask flag on commands enables subagent-aware task execution.
Aborted messages are now retained in context instead of being discarded.

4 details in Everything

v0.7.3 Sep 11, 2025 · release notes

OpenCode v0.7.3 adds an experimental option to disable paste summaries

└──▷ GET THIS VERSION

$ git clone --branch v0.7.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.7.3

v0.6.6 Sep 8, 2025 · release notes

OpenCode v0.6.6 enables npm package installation on Windows and re-enables todo tools for Qwen models.

└──▷ GET THIS VERSION

$ git clone --branch v0.6.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.6.6

Supports npm package installation on Windows.
Re-enables todowrite and todoread tools for Qwen models.

2 details in Everything

v0.6.5 Sep 7, 2025 · release notes

OpenCode v0.6.5 adds a createOpencodeTui() SDK function for programmatic TUI launching.

└──▷ GET THIS VERSION

$ git clone --branch v0.6.5 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.6.5

v0.6.4 Sep 3, 2025 · release notes

OpenCode v0.6.4 adds OPENCODE_CONFIG_CONTENT env var support and API key generation.

└──▷ GET THIS VERSION

$ git clone --branch v0.6.4 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.6.4

└──▷ TRY IT

Inject OpenCode config without a config file — useful in ephemeral CI/CD environments.

$ OPENCODE_CONFIG_CONTENT='{"model":"anthropic/claude-3-5-sonnet"}' opencode run

Supports OPENCODE_CONFIG_CONTENT environment variable for supplying configuration content directly.
Adds API key generation capability.

2 details in Everything

v0.6.0 Sep 1, 2025 · release notes

OpenCode v0.6.0 adds per-provider timeout overrides, --command flag for run, LSP workspace config support, and a new project model replacing app.

└──▷ GET THIS VERSION

$ git clone --branch v0.6.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.6.0

└──▷ TRY IT

Run a one-shot prompt with a specific slash command without entering the TUI.

$ opencode run --command "/review" "Check this file for security issues"

Adds --command flag to opencode run for specifying a command directly at invocation.
Supports per-provider timeout overrides via a new provider timeout configuration.
Adds LSP workspace/didChangeConfiguration support, enabling dynamic LSP config updates.
Uses a single Rust LSP server instance across an entire Cargo workspace, improving multi-crate project performance.
Introduces a project concept (replacing app) with new endpoints to list projects and get the current project.

+2 more show less

Every API endpoint now accepts an optional directory parameter to operate as if OpenCode is running in that directory.
Plugins now receive directory (cwd) and worktree (git repo root) context.

7 details in Everything

└──▷ BREAKING ON UPGRADE

!Storage events have been removed.
!The app concept is gone; it is replaced by project, with new endpoints for listing projects and getting the current project.
!The session.chat function in the SDK has been renamed to session.prompt and no longer requires model to be passed in (model is now an object).
!Plugins no longer receive the previous app-scoped context; they now receive directory (cwd) and worktree (git repo root).

v0.5.29 Aug 30, 2025 · release notes

OpenCode v0.5.29 adds a file list API, ignored-file inclusion, home-dir app info, and Vercel AI Gateway dashboard deeplinks.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.29 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.29

New file list API for programmatic access to project file listings.
Supports including ignored files (e.g. .gitignored) in file operations.
Displays home directory path in app info output.
Vercel AI Gateway API keys now deep-link directly into the dashboard.
Adds a synthetic user message before bash execution when using !, improving context in conversation history.

+2 more show less

Uses a single Rust LSP server instance across an entire Cargo workspace, reducing resource overhead.
TUI now shows the actual error message when a command fails, replacing silent or generic failures.

7 details in Everything

v0.5.28 Aug 26, 2025 · release notes

OpenCode v0.5.28 adds a new opencode workflow capability.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.28 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.28

v0.5.18 Aug 23, 2025 · release notes

OpenCode v0.5.18 adds SSE streaming to the SDK and an option to disable automatic LSP installation.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.18 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.18

Adds SSE streaming support to the SDK for real-time event consumption.
New option to disable automatic LSP installation, giving practitioners control over which language servers are installed.

2 details in Everything

v0.5.15 Aug 22, 2025 · release notes

OpenCode v0.5.15 adds slash commands, createOpencodeServer JS SDK helper, and split @opencode-ai/sdk/server & /client imports.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.15 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.15

└──▷ USE IT

Programmatically start an OpenCode server in a Node.js script and wait until it is ready before issuing requests.

typescript

import { createOpencodeServer } from '@opencode-ai/sdk/server'

const server = await createOpencodeServer()
// server is ready — make SDK calls here

Import only the client-side SDK in a browser or edge environment without bundling server-only code.

typescript

import { OpenCodeClient } from '@opencode-ai/sdk/client'

Adds slash commands support in the CLI interface.
Adds createOpencodeServer to the JS SDK, including automatic readiness waiting and random port assignment for opencode serve.
Supports importing the JS SDK from @opencode-ai/sdk/server and @opencode-ai/sdk/client as separate entry points.
Config hooks are now awaited, enabling async initialization logic.

4 details in Everything

└──▷ BREAKING ON UPGRADE

!opencode serve now always uses a random port instead of a fixed port, which will break any hardcoded port references in scripts or clients.

v0.5.13 Aug 21, 2025 · release notes

OpenCode v0.5.13 adds a plugin hook for config

└──▷ GET THIS VERSION

$ git clone --branch v0.5.13 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.13

v0.5.6 Aug 18, 2025 · release notes

OpenCode v0.5.6 adds top-level tool config, rust-analyzer LSP support, and deeper agent file discovery.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.6

Adds top-level tool configuration support for defining tool settings at the project root.
Adds rust-analyzer as a supported LSP provider for Rust code intelligence.
Enables discovery of markdown agent files in nested subfolders under .opencode/agent/some-folder/*.md.

3 details in Everything

v0.5.5 Aug 16, 2025 · release notes

OpenCode v0.5.5 retains cache when cycling between subagent and parent sessions for faster TUI performance.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.5 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.5

v0.5.3 Aug 15, 2025 · release notes

OpenCode v0.5.3 adds configurable scroll speed, message navigation modal, and .zshenv loading with ZDOTDIR support.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.3

└──▷ USE IT

Tune scroll speed in the TUI for faster navigation through long outputs.

yaml

# In your opencode config file:
scroll_speed: 5

Adds scroll_speed configuration option to control TUI scroll behavior.
New message navigation modal lets you jump to and restore specific messages in a conversation.
Shell integration now loads .zshenv and respects ZDOTDIR when present.

3 details in Everything

v0.5.2 Aug 15, 2025 · release notes

OpenCode v0.5.2 adds Vue LSP support, subagent navigation, reverse model cycling, and new TUI/API capabilities.

└──▷ GET THIS VERSION

$ git clone --branch v0.5.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.5.2

Adds Vue LSP support and enables ESLint for .vue files.
Supports cycling recent models in reverse order in the TUI.
Renders tool metadata after permission rejection so users can inspect what was blocked.
New /tui/show-toast API endpoint for displaying toast notifications.
New API routes to get a session and its session children.

+2 more show less

Enables navigation of child sessions (subagents) in the TUI.
Improved queued visual indicator in the TUI.

7 details in Everything

v0.4.44 Aug 13, 2025 · release notes

OpenCode v0.4.44 converts deleted attachments to text, preserving context in the conversation.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.44 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.44

v0.4.43 Aug 13, 2025 · release notes

OpenCode v0.4.43 adds bash command execution and attachment-to-text conversion.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.43 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.43

└──▷ TRY IT

Run a shell command inline during an OpenCode session without leaving the CLI.

$ !ls -la

Adds bash command execution via ! prefix, letting you run shell commands directly from the OpenCode CLI.
Supports converting attachments to text when deleted, preserving content as inline text rather than losing it.

2 details in Everything

v0.4.40 Aug 12, 2025 · release notes

OpenCode v0.4.40 adds session renaming in the TUI and a revamped agent modal UI.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.40 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.40

New session rename functionality available directly from the TUI modal.
Revamped UI/UX for the agent modal with improved layout and experience.
Adds OpenAI prompt cache key support.

3 details in Everything

v0.4.27 Aug 12, 2025 · release notes

OpenCode v0.4.27 adds wildcard matching for tool names in config

└──▷ GET THIS VERSION

$ git clone --branch v0.4.27 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.27

Supports wildcard pattern matching for tool names in configuration, enabling bulk enable/disable of tool groups without listing each name explicitly.

1 detail in Everything

v0.4.20 Aug 11, 2025 · release notes

OpenCode v0.4.20 adds -c and -s args to the tui command, matching the run command pattern.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.20 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.20

└──▷ TRY IT

Pass a prompt and session flags directly to the TUI at launch, the same way you would with the run command.

$ opencode tui -c "review my last commit for security issues" -s <session-id>

Adds -c and -s flags to the tui command, aligning its interface with the run command pattern.

1 detail in Everything

v0.4.19 Aug 11, 2025 · release notes

OpenCode v0.4.19 adds a toggle to show or hide tool call details in the UI.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.19 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.19

v0.4.17 Aug 11, 2025 · release notes

OpenCode v0.4.17 adds wrap-around navigation in Models/Tools modals and a placeholder for pending assistant messages.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.17 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.17

Adds wrap-around navigation for list selection in the Models and Tools modals.
Adds a placeholder display on pending assistant messages in the TUI.
Makes the models key optional in config.

3 details in Everything

v0.4.15 Aug 11, 2025 · release notes

OpenCode v0.4.15 adds an agents dialog, F2 model cycling, and biome.jsonc config support.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.15 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.15

└──▷ TRY IT

Quickly switch to a recently used model without leaving the keyboard — press F2 to cycle through your last 5 models mid-session.

$ # While inside opencode TUI, press F2 to step through the 5 most recent models

New agents dialog in the TUI for managing and switching between agents.
Press F2 to cycle through the 5 most recently used models from anywhere in the TUI.
Supports biome.jsonc (JSON with comments) as a Biome config file.

3 details in Everything

v0.4.5 Aug 11, 2025 · release notes

OpenCode v0.4.5 adds ESLint LSP, thinking block rendering, webfetch permissions, and improved attachment pasting.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.5 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.5

Adds ESLint LSP integration for real-time lint feedback within the coding agent.
Renders thinking blocks in both the TUI and share page for supported models.
Adds webfetch permission support, giving users control over agent web-fetch requests.
Improves file attachment pasting workflow.
Displays agent name in the LLM response footer with updated ordering.

+1 more show less

Supports passing additional agent options through to the provider.

6 details in Everything

v0.4.2 Aug 9, 2025 · release notes

OpenCode v0.4.2 adds mode selection when creating agents.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.2

Supports mode selection at agent creation time, letting you pick the operating mode (e.g., plan or build) upfront.

1 detail in Everything

v0.4.0 Aug 8, 2025 · release notes

OpenCode v0.4.0 merges agents and modes into a single unified agent concept with tab-cycling and @-mention spawning.

└──▷ GET THIS VERSION

$ git clone --branch v0.4.0 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.4.0

└──▷ TRY IT

Switch between configured agents on the fly without leaving the session.

$ # Press <tab> during an active OpenCode session to cycle to the next configured agent

Unifies agent and mode into a single agent config field — configure one concept instead of two.
Cycle through primary agents with <tab> during a session.
Spawn a subagent inline by @-mentioning it by name.
Agents with a description field are automatically selected by the primary agent based on context.
Re-enables the todo tool for task tracking within sessions.

+1 more show less

Loosens the todo tool schema to accept a wider range of input formats.

6 details in Everything

└──▷ BREAKING ON UPGRADE

!The mode config field is deprecated and replaced by agent; existing configs using mode will need to be migrated to the agent field.

v0.3.132 Aug 6, 2025 · release notes

OpenCode v0.3.132 adds permissions disallow support, improved assistant message visuals, and a config option to disable snapshots.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.132 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.132

└──▷ USE IT

Disable session snapshots when you want to skip snapshot overhead in automated or ephemeral environments.

yaml

# In your opencode config file:
snapshot: false

Adds permissions disallow support to restrict what actions the assistant is allowed to perform.
Introduces a snapshot field in config to disable session snapshots.
Improves assistant message visual presentation.

3 details in Everything

v0.3.113 Aug 2, 2025 · release notes

OpenCode v0.3.113 enables Kimi k2 ↔ Claude trajectory handoff for multi-model workflows.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.113 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.113

v0.3.112 Aug 1, 2025 · release notes

OpenCode v0.3.112 adds provider search, configurable LSP, configurable top_p, and forced models.dev refresh on login.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.112 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.112

Adds search filtering in the provider selection UI.
Supports configurable LSP (language server protocol) settings.
Makes top_p model parameter configurable.
Forces models.dev refresh automatically on auth login.

4 details in Everything

v0.3.102 Jul 31, 2025 · release notes

OpenCode v0.3.102 adds a more scriptable TUI API, configurable permissions, and Azure OpenAI provider support.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.102 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.102

Adds a more scriptable TUI API for programmatic control of the terminal interface.
Introduces configurable permissions, allowing users to tune permission behavior.
Adds provider instructions for Azure OpenAI integration.

3 details in Everything

v0.3.90 Jul 31, 2025 · release notes

OpenCode v0.3.90 adds TreeSitter bash parsing, per-directory markdown config, and Azure Responses API support.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.90 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.90

Uses TreeSitter to parse bash commands and detect commands that escape the current working directory.
Adds per-directory markdown configuration loading for mode settings.
Supports the Responses API for Azure AI backends.
Adds http-referer header support for Vercel AI Gateway requests.

4 details in Everything

v0.3.82 Jul 29, 2025 · release notes

OpenCode v0.3.82 adds custom config file path via env var, git branch in status bar, and git diff in reverted messages.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.82 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.82

└──▷ TRY IT

Point OpenCode at a project-specific config file without modifying your default config — useful when switching between different AI provider setups per repo.

$ OPENCODE_CONFIG=~/projects/myapp/.opencode.json opencode

New OPENCODE_CONFIG environment variable lets you specify a custom config file path at startup.
Displays the current git branch in the status bar with responsive layout.
Shows git diff inline in reverted messages for easier review of undone changes.

3 details in Everything

v0.3.81 Jul 29, 2025 · release notes

OpenCode v0.3.81 adds OPENCODE_CONFIG env var for custom config file paths and strips todo tool instructions from non-Anthropic models.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.81 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.81

└──▷ TRY IT

Point OpenCode at a project-specific config file without modifying the default location — useful in CI or multi-project setups.

$ OPENCODE_CONFIG=/path/to/my-project.json opencode

Adds OPENCODE_CONFIG environment variable to specify a custom config file path, enabling per-project or per-environment configurations.
Strips todo tool instructions from non-Anthropic model prompts, improving compatibility and reducing noise when using alternative LLM backends.

2 details in Everything

v0.3.80 Jul 28, 2025 · release notes

OpenCode v0.3.80 adds a VS Code status bar button and new terminal keybindings for faster access.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.80 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.80

Shows an OpenCode button in the VS Code status bar when the terminal is focused.
Brings an existing OpenCode terminal to the front in VS Code instead of opening a duplicate.
Adds Cmd+Shift+Esc keybinding in VS Code to quickly open or focus the OpenCode terminal.

3 details in Everything

v0.3.65 Jul 25, 2025 · release notes

OpenCode v0.3.65 adds a configurable TUI scroll speed setting and improves Windows compatibility via zip.js.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.65 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.65

Adds a scroll speed setting in the TUI for configurable navigation pace.
Replaces unzip with @zip.js/zip.js for Windows compatibility.

2 details in Everything

v0.3.61 Jul 24, 2025 · release notes

OpenCode v0.3.61 adds mode passing into the task tool and a new Aura theme.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.61 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.61

Passes the current mode into the task tool, enabling mode-aware task execution.
Adds the Aura theme as a new UI color scheme option.

2 details in Everything

v0.3.26 Jul 19, 2025 · release notes

OpenCode v0.3.26 collapses the session header to a single line when sharing is disabled.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.26 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.26

└──▷ BREAKING ON UPGRADE

!The log level config key has been removed from the configuration.

v0.3.24 Jul 19, 2025 · release notes

OpenCode v0.3.24 adds Vercel AI Gateway support and Gemini tool schema sanitization.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.24 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.24

Adds Vercel AI Gateway as a supported provider integration.
Adds Gemini tool schema sanitization to improve compatibility with Gemini-based provider calls.

2 details in Everything

v0.3.18 Jul 17, 2025 · release notes

OpenCode v0.3.18 adds AWS bearer token auth for Bedrock, MCP header support, and cleaner sharing UX.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.18 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.18

Supports AWS_BEARER_TOKEN_BEDROCK environment variable for Amazon Bedrock provider autoloading.
Allows MCP servers to include custom headers in their configuration.
Highlights the current session in the sessions modal for easier navigation.
Removes share commands from the help menu when sharing is disabled.
Removes sharing info from the session header when sharing is disabled.

5 details in Everything

v0.3.15 Jul 16, 2025 · release notes

OpenCode v0.3.15 adds Shift+Tab backward mode cycling, full-width layout config, enhanced private npm registry support, and copy-last-message shortcut.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.15 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.15

Adds Shift+Tab keybinding to cycle through modes in reverse order.
New layout config option to render the TUI at full width.
Adds a copy last message action in the messages component.
Enhances private npm registry support.

4 details in Everything

v0.3.12 Jul 16, 2025 · release notes

OpenCode v0.3.12 adds /export command, Gemini CLI prompt support, and Anthropic custom mode spoofing.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.12 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.12

└──▷ TRY IT

Export the current conversation to your editor for sharing or archiving.

$ /export

New /export command exports the current conversation to your editor.
Adds support for modified Gemini CLI system prompt.
Supports Anthropic with custom modes via spoof prompt.
Uses a small model dedicated to conversation title generation.

4 details in Everything

v0.3.10 Jul 15, 2025 · release notes

OpenCode v0.3.10 adds a keymap to remove entries from recently used models and improves tool call rendering.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.10 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.10

Adds a keymap in the TUI to remove entries from the recently used models list.
Reduces the number of Unknown entries in tool call rendering during opencode run.
Adds a dedicated small model for session title generation.

3 details in Everything

v0.3.7 Jul 15, 2025 · release notes

OpenCode v0.3.7 adds Anthropic Console login, job-control suspend, and restores the task tool.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.7 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.7

Supports Anthropic Console login flow for direct browser-based authentication.
Adds job-control suspend support (Ctrl+Z / SIGTSTP) to pause and background the process like a native shell command.

2 details in Everything

v0.3.3 Jul 14, 2025 · release notes

OpenCode v0.3.3 adds word-jump key bindings and new-session creation from the session dialog.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.3 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.3

Adds Ctrl+Left / Ctrl+Right arrow key support for word-by-word cursor navigation in the TUI.
Enables creating a new session directly from the session dialog without leaving the UI.

2 details in Everything

v0.3.2 Jul 14, 2025 · release notes

OpenCode v0.3.2 adds configurable sharing options and expands file-listing ignore patterns.

└──▷ GET THIS VERSION

$ git clone --branch v0.3.2 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.3.2

Adds auto/disabled sharing config options for controlling session share behavior.
Expands ignore patterns in the ls tool to reduce noise from common non-source files.

2 details in Everything

v0.2.28 Jul 11, 2025 · release notes

OpenCode v0.2.28 adds a new API endpoint for retrieving GitHub App tokens.

└──▷ GET THIS VERSION

$ git clone --branch v0.2.28 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.2.28

v0.2.23 Jul 10, 2025 · release notes

OpenCode v0.2.23 adds modes support, a --mode CLI flag, token/cost session header, and env/file config pointers.

└──▷ GET THIS VERSION

$ git clone --branch v0.2.23 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.2.23

└──▷ TRY IT

Run a session in a specific mode (e.g. research) directly from the command line without entering the TUI first.

$ opencode run --mode research

Adds modes to the TUI, allowing practitioners to switch between configured operational modes during a session.
New --mode flag on the opencode run command lets you specify a mode at invocation time, which is also passed through to the TUI.
Displays token usage and cost information in the session header for real-time spend awareness.
Raises the max output token limit to 32,000, unlocking larger response payloads.
Supports environment variable and file pointers in config, enabling secrets and paths to be sourced externally.

5 details in Everything

v0.2.19 Jul 10, 2025 · release notes

OpenCode v0.2.19 adds @symbol attachments, smarter /editor behavior, and subscription cost hiding in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v0.2.19 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.2.19

└──▷ TRY IT

Use /editor to draft a multi-line prompt in your $EDITOR and land it in the input box for review before sending.

$ /editor

Adds @symbol attachments in the TUI for referencing symbols directly in chat input.
Hides cost display when using a subscription model so billing noise doesn't clutter the UI.
Changes /editor auto-send behavior to place content into the input box instead of sending immediately, giving users a chance to review before submitting.
Substitutes the current working directory's home path with ~ in the status bar for cleaner display.

4 details in Everything

v0.2.14 Jul 9, 2025 · release notes

OpenCode v0.2.14 adds configurable log levels, server-side logging, and smarter tsserver spawning.

└──▷ GET THIS VERSION

$ git clone --branch v0.2.14 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.2.14

Moves TUI logging to server logs for centralized log visibility.
Adds configurable log levels for tunable verbosity.
Adds Discord redirect integration.
LSP now spawns only a single tsserver per project root, reducing resource overhead.

4 details in Everything

v0.2.9 Jul 8, 2025 · release notes

OpenCode v0.2.9 adds Zig Language Server (ZLS) support and improves config JSON schema with defaults and examples.

└──▷ GET THIS VERSION

$ git clone --branch v0.2.9 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.2.9

Adds support for the Zig Language Server (ZLS), enabling Zig-aware code intelligence in OpenCode sessions.
Config JSON schema now declares default values and examples for improved in-IDE documentation and autocomplete.

2 details in Everything

v0.2.6 Jul 8, 2025 · release notes

OpenCode v0.2.6 adds --model/--prompt flags, image/PDF paste, and command aliases to the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v0.2.6 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.2.6

└──▷ TRY IT

Launch OpenCode with a specific model and an inline prompt to skip manual entry — useful in scripted or quick one-shot workflows.

$ opencode --model anthropic/claude-opus-4-5 --prompt "Review this code for security issues"

Adds --model and --prompt flags to the TUI for specifying model and initial prompt at launch.
Enables pasting images and PDFs directly into the TUI.
Adds command aliases in the TUI for faster navigation and actions.

3 details in Everything

v0.1.192 Jul 4, 2025 · release notes

OpenCode v0.1.192 adds file attachment support in the TUI, including rendering of PDFs and images.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.192 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.192

Adds file attachment support in the TUI, enabling users to attach files directly in the chat interface.
Renders attached files (including PDFs and images) inline within the TUI.
Removes the banned command concept, expanding the range of commands available to the AI.

3 details in Everything

v0.1.182 Jul 3, 2025 · release notes

OpenCode v0.1.182 adds an unshare command to the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.182 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.182

v0.1.177 Jul 2, 2025 · release notes

OpenCode v0.1.177 adds a TUI file viewer and message selection capability.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.177 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.177

New TUI file viewer lets practitioners browse and inspect files directly within the OpenCode interface.
New message selection capability in the TUI enables selecting individual messages in a session.

2 details in Everything

v0.1.166 Jun 30, 2025 · release notes

OpenCode v0.1.166 adds Ruby formatter and LSP support plus updated message layout.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.166 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.166

Adds Ruby formatter and LSP integration for Ruby development workflows.
Updates user and agent message width and alignment in the UI.

2 details in Everything

v0.1.158 Jun 28, 2025 · release notes

OpenCode v0.1.158 adds experimental hooks, auto-formatting for Elixir and Go, and a scroll-to-last-message button in the web UI.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.158 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.158

Adds experimental hooks feature for extending OpenCode behavior via shell scripts.
Adds auto-formatting support for Elixir files.
Adds auto-formatting support for Go files.
Adds a scroll-to-last-message button in the web UI for quick navigation to the latest output.
Lazy-loads formatters to improve startup performance.

5 details in Everything

v0.1.153 Jun 27, 2025 · release notes

OpenCode v0.1.153 adds Elixir file formatting support and lazy-loads all formatters for faster startup.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.153 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.153

Adds Elixir file formatting support.
Lazy-loads formatters to improve startup performance.

2 details in Everything

v0.1.146 Jun 26, 2025 · release notes

OpenCode v0.1.146 adds LSP diagnostics in the TUI, a default system theme, and expanded theme options.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.146 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.146

Displays LSP diagnostics inline for edit and write tool operations in the TUI.
Adds a default system theme that follows the OS/terminal color scheme.
Expands the theme library with additional built-in TUI themes.
Adds output length error reporting to surface truncation and limit issues explicitly.

4 details in Everything

v0.1.122 Jun 23, 2025 · release notes

OpenCode v0.1.122 adds smarter GitHub Copilot header editing to reduce rate limiting and optimistic user message rendering in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.122 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.122

Optimistically renders user messages in the TUI for a more responsive feel.

1 detail in Everything

v0.1.120 Jun 22, 2025 · release notes

OpenCode v0.1.120 adds GitHub Copilot OAuth authentication and combines bash tool stdout/stderr output.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.120 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.120

Adds GitHub Copilot OAuth authentication flow for seamless login without manual token management.
Combines stdout and stderr into a single stream in bash tool output for unified command result visibility.

2 details in Everything

v0.1.118 Jun 22, 2025 · release notes

OpenCode v0.1.118 adds a Matrix-inspired theme.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.118 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.118

New Matrix-inspired theme available in the theme dialog.

1 detail in Everything

v0.1.113 Jun 20, 2025 · release notes

OpenCode v0.1.113 adds a live theme switcher plus six built-in themes including Nord, Catppuccin, and Gruvbox.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.113 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.113

Adds an in-TUI theme switcher with live preview so you can cycle themes without restarting.
Supports custom themes, letting you define your own color scheme in config.
Adds global config support for session context handling.

3 details in Everything

v0.1.87 Jun 19, 2025 · release notes

OpenCode v0.1.87 overhauls config with a merged global+project JSON format and shows provider next to model in the TUI.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.87 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.87

Adds global config support at ~/.config/opencode/config.json, automatically merged with any project-level config.
Displays the provider name next to the model in the TUI for at-a-glance context.

2 details in Everything

└──▷ BREAKING ON UPGRADE

!Global providers config is removed; migrate provider settings to ~/.config/opencode/config.json.
!Global TOML config is removed; the new global config format is JSON at ~/.config/opencode/config.json.

v0.1.61 Jun 16, 2025 · release notes

OpenCode v0.1.61 restructures custom provider config with a new npm field for package loading.

└──▷ GET THIS VERSION

$ git clone --branch v0.1.61 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.1.61

Adds npm field to custom provider config entries to explicitly specify which npm package to load.
Adds validation on provider ID and improved error messages in opencode auth login.

2 details in Everything

└──▷ BREAKING ON UPGRADE

!The config structure has changed: custom providers now require an npm field to specify which npm package to load — existing custom provider configs will break without this update.
!Windows builds have been removed — Windows users can no longer install or run OpenCode from official release artifacts.

v0.0.52 May 22, 2025 · release notes

OpenCode v0.0.52 adds Codex Mini support, arrow-key message history navigation, and switches the default model to Claude Sonnet 4.

└──▷ GET THIS VERSION

$ git clone --branch v0.0.52 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.0.52

Adds support for OpenAI Codex Mini as a model option.
Adds message history navigation using arrow keys in the input.

2 details in Everything

└──▷ BREAKING ON UPGRADE

!The default model is now Claude Sonnet 4; existing workflows that relied on the previous default model will use Claude Sonnet 4 after upgrading unless explicitly overridden.

v0.0.51 May 17, 2025 · release notes

OpenCode v0.0.51 adds non-interactive mode with tool restriction flags, F9 tools dialog, image paste, and full 0-255 color themes.

└──▷ GET THIS VERSION

$ git clone --branch v0.0.51 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.0.51

└──▷ TRY IT

Run OpenCode headlessly in CI to execute a prompt without any interactive terminal — and restrict it to only safe read-only tools.

$ opencode --non-interactive --allow-tools read_file,grep "Summarize the authentication flow in src/auth/"

Adds non-interactive mode for scripted/CI use cases without a live terminal session.
Adds tool restriction flags to control which tools are available when running in non-interactive mode.
Adds a tools dialog accessible via F9 to browse and inspect available tools from within the TUI.
Supports 0-255 (xterm-256) color range in custom themes for richer terminal styling.
Enables configuring the shell via the config file instead of relying solely on the environment default.

+1 more show less

Supports pasting images directly into the prompt with Ctrl+V.

6 details in Everything

v0.0.50 May 15, 2025 · release notes

OpenCode v0.0.50 adds VertexAI as a supported LLM provider.

└──▷ GET THIS VERSION

$ git clone --branch v0.0.50 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.0.50

v0.0.49 May 15, 2025 · release notes

OpenCode v0.0.49 adds a batch tool, named arguments in custom commands, WebP image preview, and an improved status bar.

└──▷ GET THIS VERSION

$ git clone --branch v0.0.49 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.0.49

New batch tool enables running multiple tool calls in a single operation.
Custom commands now support named arguments for more flexible command definitions.
Supports previewing WebP images and pasting file paths directly in the TUI.
Improved status bar with better information display.

4 details in Everything

v0.0.48 May 15, 2025 · release notes

OpenCode v0.0.48 adds slash-triggered completions dialog and persistent model selection config.

└──▷ GET THIS VERSION

$ git clone --branch v0.0.48 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout v0.0.48

New completions module with a dialog UI and multiple providers, triggered by typing /.
Adds configuration persistence for model selections so chosen models are remembered across sessions.

2 details in Everything

0.0.45 May 14, 2025 · release notes

OpenCode 0.0.45 adds auto LSP discovery, auto-compact summarization, and a new logs page.

└──▷ GET THIS VERSION

$ git clone --branch 0.0.45 https://github.com/sst/opencode.git
# already have the repo? check out this version:
$ git checkout 0.0.45

Adds automatic LSP discovery and configuration — no manual language-server setup required.
Adds auto-compact/summarize to keep long-running sessions going indefinitely without hitting context limits.
New logs page for inspecting session activity directly in the UI.

3 details in Everything

OpenCode

Summary

How OpenCode helps

Languages

Features

What OpenCode offers you

release 35 total

api 39 total

release 11 total

api

release

api

release

api

release

docs

example

release

release 19 total

docs

example

api 18 total

release 14 total

docs 9 total

example

api

release

example

release 8 total

api 17 total

release

api 7 total

release

docs

example

api

release 10 total

example

api 8 total

release

api

release 34 total

docs

api 8 total

release 15 total

docs

example

api 13 total

release 8 total

example

api 9 total

release

release 10 total

api 9 total

release 14 total

example

api

release 8 total

example

release

docs

example

release

example

release

example

release

release

release

release

example

release

example

release

docs

docs

release

release

Command line

Release-note detail over time