OpenCode
v1.18.24 open-sourceThe open source coding agent.
az login --tenant TENANT_ID && opencode
AZURE_RESOURCE_GROUP=my-rg opencode
az account set --subscription NAME_OR_ID && opencode
OPENCODE_ENABLE_PARALLEL=1 opencode
az login --tenant TENANT_ID
az account set --subscription NAME_OR_ID
{
"azure": {
"gpt-5-mini": "gpt-production"
}
}
OPENCODE_SIDECAR_V2=1 opencode
OPENCODE_SIDECAR_V2=1 opencode
opencode --mini
# In your opencode config, set cwd on a local MCP server entry:
{
"mcpServers": {
"my-server": {
"command": "node",
"args": ["server.js"],
"cwd": "./tools/my-server"
}
}
}
opencode run --replay
OPENCODE_EXPERIMENTAL_WEBSOCKETS=true opencode
# In your opencode config file:
headerTimeout: 30000
opencode --replay --replay-limit 10
opencode debug info
opencode --agent <your-agent>
opencode export --sanitize
opencode run --dangerously-skip-permissions
OPENCODE_DISABLE_MOUSE=1 opencode
GOOGLE_VERTEX_LOCATION=us-east1 opencode
OPENCODE_EXPERIMENTAL_WORKSPACES=1 opencode
OPENCODE_SKIP_MIGRATIONS=1 opencode
opencode github run --variant <variant-name>
opencode attach --continue
# or to fork the session into a new branch:
opencode attach --fork
opencode db
opencode run --dir /path/to/project
// 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;
}
}
}
OPENCODE_CONFIG_CONTENT='{"model": "${MY_MODEL}"}' opencode
{
"$schema": "https://models.dev/opencode.json"
}
{
"$schema": "https://models.dev/opencode.json"
}
opencode run --thinking "Explain the authentication flow in this codebase"
// In your opencode plugin (shell.env hook)
export default {
hooks: {
"shell.env": (env) => ({
...env,
MY_API_KEY: "secret",
NODE_ENV: "production",
}),
},
};
opencode --mdns-domain mydevbox.local
OPENCODE_MODELS_PATH=/path/to/my-models.json opencode
opencode attach --dir /remote/path/to/project
OPENCODE_MODELS_DEV_DOMAIN=models.internal.corp opencode
OPENCODE_DISABLE_PROJECT_CONFIG=1 opencode
OPENCODE_DISABLE_FILETIME_CHECK=1 opencode
choco upgrade opencode
scoop update opencode
OPENCODE_SERVER_PASSWORD=mysecret opencode
# 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
{
"permission": {
"bash": {
"npm *": "allow",
"git *": "allow",
"rm *": "deny",
"*": "ask"
},
"edit": {
"*.md": "allow",
"*.ts": "ask",
"*": "deny"
}
}
}
opencode run --variant minimal
opencode debug agent <name>
/<mcp-prompt-name>
Ctrl+V (inside an active OpenCode session on Windows to paste a clipboard image)
# In your opencode config file:
default_agent: "<your-agent-name>"
/fork
OPENCODE_DISABLE_TERMINAL_TITLE=1 opencode
OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX=65536 opencode
OPENCODE_DISABLE_TERMINAL_TITLE=1 opencode
! gs
opencode --prompt "Audit all TODO comments in the codebase and create a summary report"
# In opencode config (e.g. opencode.json)
{
"experimental": {
"continue_loop_on_deny": true
}
}
# In opencode config
{
"experimental": {
"chat": {
"system": {
"transform": "path/to/system-transform-hook.js"
}
}
}
}
opencode attach --session <session-id>
OPENCODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe" opencode
opencode agent create --path ./agents/triage --description "Triage incoming issues" --mode auto --tools read,write
OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=10000 opencode
opencode uninstall
# In your opencode config
{
"experimental": {
"open_telemetry": true
}
}
experimental:
primary_tools:
- bash
- editor
keybinds:
tool_details: "ctrl+t"
messages_last_user: "ctrl+u"
opencode session list
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT=1 opencode
diff_style: unified
opencode models
opencode models --refresh
OPENCODE_EXPERIMENTAL_BASH_MAX_OUTPUT_LENGTH=500000 opencode
lsp: false
formatter: false
opencode agent list
/thinking
opencode import <share-link>
opencode run --attach
/export
Summarize this code and then ask @reviewer to check it for security issues
/mcp
echo $AGENT
opencode stats
/timeline
/timeline
/exit
/continue
opencode --prompt "Refactor the auth module to use JWT tokens"
/rename my-investigation-session
/editor
/theme
opencode upgrade 1.0.0
opencode upgrade 0.15.31
{
"model": {
"headers": {
"X-Custom-Auth": "my-token",
"X-Routing-Key": "team-a"
}
}
}
opencode run --title "nightly-audit" "Review all authentication handlers for injection risks"
OPENCODE_CONFIG_DIR=./infra/opencode-config opencode run "Scan for hardcoded secrets"
OPENCODE_FAKE_VCS=1 opencode
opencode run -f <path>
opencode attach --session <session-id>
import { createOpencode } from '@opencode/sdk';
const { server, client } = await createOpencode({ /* options */ });
import { createOpencodeTui } from '@opencode/sdk';
await createOpencodeTui({ /* options */ });
opencode attach --session <session-id>
opencode debug config
import { createOpencodeTui } from 'opencode'
await createOpencodeTui()
curl http://localhost:<port>/mcp
opencode debug config
OPENCODE_DISABLE_AUTOCOMPACT=1 opencode
OPENCODE_CONFIG_CONTENT='{"model":"anthropic/claude-3-5-sonnet"}' opencode run
opencode run --command "/review" "Check this file for security issues"
import { createOpencodeServer } from '@opencode-ai/sdk/server'
const server = await createOpencodeServer()
// server is ready — make SDK calls here
import { OpenCodeClient } from '@opencode-ai/sdk/client'
# In your opencode config file:
scroll_speed: 5
!ls -la
opencode tui -c "review my last commit for security issues" -s <session-id>
# While inside opencode TUI, press F2 to step through the 5 most recent models
# Press <tab> during an active OpenCode session to cycle to the next configured agent
# In your opencode config file:
snapshot: false
OPENCODE_CONFIG=~/projects/myapp/.opencode.json opencode
OPENCODE_CONFIG=/path/to/my-project.json opencode
/export
opencode run --mode research
/editor
opencode --model anthropic/claude-opus-4-5 --prompt "Review this code for security issues"
opencode --non-interactive --allow-tools read_file,grep "Summarize the authentication flow in src/auth/" Summary
OpenCode is an open-source AI coding agent that works alongside a developer inside their own codebase, available at no cost and run from a terminal, though a desktop app and IDE extension are also offered. It installs as a command-line tool via a script, npm, Homebrew, or platform package managers, then connects to an LLM provider of the user's choosing, including a curated set called OpenCode Zen, before being initialized inside a project directory. It's aimed at software developers who want an agent that can read, edit, and act on their code directly from the shell rather than through a chat window bolted onto an editor. It supports subagents running in the background, session replay for auditing what the agent did, and MCP server integration for extending its tool access. With over a thousand contributors, more than 17,000 commits and 81 releases in the past year, and a release 14 days ago, it is under active development.
The open source coding agent.
What OpenCode answers
Which LLM providers can I actually connect it to?
any provider with an API key, plus a curated set of pre-tested models called OpenCode Zen if you don't want to choose one yourself
What does it need on my machine before I can run it?
a modern terminal emulator and an API key for whichever LLM provider you pick, nothing else to provision
Can I review what the agent did after the fact?
every session can be replayed step by step, so a human can audit the changes an agent made without watching it live
Can multiple agents work on different things at once?
subagents can run in the background while the main session keeps going, rather than blocking on one task at a time
How do I extend what it's allowed to touch or do?
it connects to MCP servers, including ones scoped to a workspace or a specific subdirectory, to add tools beyond what ships in the box
Is this still being worked on or is it stalled?
over a thousand contributors and 81 releases in the past year, with the most recent one 14 days ago
Examples
Command line
No option matches that search.
| option | found in | since | description |
|---|
No option matches that search.
Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.
Release history
- docs update
OpenCode adds Microsoft Entra ID (Azure CLI) authentication, enabling keyless access to Azure OpenAI and Foundry models via
az login.└──▷ TRY ITAuthenticate to an Azure OpenAI resource in a non-default tenant without storing an API key — useful in zero-credential CI or shared workstation setups.$ az login --tenant TENANT_ID && opencode
Skip slow subscription-level resource listing and connect directly to a known Azure resource group — speeds up startup in environments with many subscriptions.$ AZURE_RESOURCE_GROUP=my-rg opencodePin a specific Azure deployment name when the deployed model name differs from the catalog name, avoiding model-discovery permission errors.$ az account set --subscription NAME_OR_ID && opencode
- ›Adds Microsoft Entra ID (Azure CLI) provider option, letting practitioners authenticate to Azure OpenAI and Foundry resources using an active
az loginsession instead of an API key. - ›Supports
az login --tenant TENANT_IDto access resources in a non-default Azure tenant. - ›Adds
AZURE_RESOURCE_GROUPenvironment variable to skip subscription-level resource listing and query a known Azure resource directly. - ›Supports
az account set --subscription NAME_OR_IDto target a resource in a non-default Azure subscription before connecting. - ›Allows explicit deployment name configuration (e.g., pairing model
gpt-5-miniwith deployment namegpt-production) for environments where model discovery via control-plane permissions is unavailable.
+2 moreshow less
- ›Automatically discovers deployed models from the active Azure CLI subscription when the identity holds sufficient Azure control-plane permissions; falls back to the Azure model catalog otherwise.
- ›Refreshes access tokens through the Azure CLI automatically, including CLI versions earlier than 2.54.0, requiring re-authentication only when the CLI session expires.
- ›Adds Microsoft Entra ID (Azure CLI) provider option, letting practitioners authenticate to Azure OpenAI and Foundry resources using an active
- docs update
OpenCode adds
OPENCODE_ENABLE_PARALLELenv var to enable parallel web search tools.└──▷ TRY ITRun OpenCode with parallel web search enabled to speed up multi-source research tasks.$ OPENCODE_ENABLE_PARALLEL=1 opencode- ›Adds
OPENCODE_ENABLE_PARALLELenvironment variable to enable parallel web search tools.
- ›Adds
- docs update
OpenCode adds support for three new models: Grok 4.6, GLM-5.3-Flash, and Qwen3.8 Flash
- ›Adds
grok-4.6model support (Grok 4.6), with tiered pricing at $12.00/M tokens (≤200K context) and $1.00/M tokens (>200K context), and per-request limits of 390 input, 32,500 cached, 120 output tokens. - ›Adds
glm-5.3-flashmodel support (GLM-5.3-Flash) at $0.15/M input and $0.03/M output tokens, with per-request limits of 1,000 input, 55,000 cached, 200 output tokens. - ›Adds
qwen3.8-flashmodel support (Qwen3.8 Flash) at $0.15/M input and $0.47/M output tokens, with per-request limits of 600 input, 58,000 cached, 200 output tokens.
- ›Adds
- docs update
OpenCode adds Microsoft Entra ID (Azure CLI) auth — use
az logininstead of an API key to access Azure OpenAI and Foundry models.└──▷ TRY ITAuthenticate to Azure OpenAI using your existing CLI session instead of an API key, targeting a specific tenant.$ az login --tenant TENANT_ID
Switch to the subscription that contains your Azure OpenAI resource so OpenCode can discover its deployed models.$ az account set --subscription NAME_OR_ID
Skip deployment discovery and pin a known model to its Azure deployment name when control-plane permissions are unavailable.{ "azure": { "gpt-5-mini": "gpt-production" } }- ›Adds Microsoft Entra ID (Azure CLI) as an authentication provider, letting practitioners run
az logininstead of supplying an API key when connecting to Azure OpenAI or Foundry resources. - ›Supports
az login --tenant TENANT_IDto authenticate against a non-default Azure tenant when the target resource lives in a different directory. - ›Supports
az account set --subscription NAME_OR_IDto select the correct Azure subscription before OpenCode discovers deployed models. - ›Adds explicit deployment name configuration under the
azureprovider key — map a model name (e.g.gpt-5-mini) to its deployment name (e.g.gpt-production) when automatic discovery is unavailable.
- ›Adds Microsoft Entra ID (Azure CLI) as an authentication provider, letting practitioners run
- v1.18.24
OpenCode v1.18.24 adds Azure CLI (Microsoft Entra ID) authentication and cross-version V1/V2 config compatibility.
└──▷ GET THIS VERSION$ git clone --branch v1.18.24 https://github.com/anomalyco/opencode.git # already have the repo? check out this version: $ git checkout v1.18.24
- ›Azure providers can now authenticate via the Azure CLI using Microsoft Entra ID instead of requiring an API key.
- ›V1 now reads supported V2 config fields, keeping newer config files working in mixed V1/V2 setups.
- 1.0.0
API surface changed: 1 modified
API CHANGEAPI surface changed: 1 modified
- ~ POST /global/upgrade: request body changed
- ›POST
/global/upgrade: request body changed
- docs update
OpenCode GitHub Action gains
variant,oidc_base_url, and custom token passthrough options for flexible CI deployments.- ›Adds
variantconfig key to set provider-specific reasoning effort (e.g.high,max, orminimal) for the GitHub Action. - ›Adds
oidc_base_urlconfig key to point the OIDC token exchange at a custom GitHub App installation instead of the defaulthttps://api.opencode.ai. - ›Adds
mentionsconfig key accepting a comma-separated, case-insensitive list of trigger phrases (defaults to/opencode,/oc) to control which PR/issue comments activate the bot. - ›Supports caller-provided token mode that skips OIDC exchange entirely, allowing a PAT or third-party GitHub App token stored as a secret to be passed directly — removing the requirement for
id-token: writepermission.
- ›Adds
- v1.18.19
OpenCode v1.18.19 adds native Cloudflare AI Gateway passthroughs for OpenAI and Anthropic, plus web search for the Go provider.
└──▷ 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
- ›Enables web search when using the OpenCode Go provider.
- ›Matches Codex rate limits more closely to ChatGPT subscription limits for OpenAI models.
- 1.0.0
OpenCode now publishes an API — 188 endpoints across 32 areas: Session, Sessions, Pty, …
- ›Session (27 endpoints) — Experimental HttpApi session routes.
- ›Sessions (17 endpoints) — Experimental session routes.
- ›Pty (15 endpoints) — PTY websocket route.
- ›Experimental (13 endpoints) — Experimental HttpApi read-only routes.
- ›Tui (13 endpoints) — Experimental HttpApi TUI routes.
+4 moreshow less
- ›Instance (12 endpoints) — Experimental HttpApi instance read routes.
- ›Mcp (8 endpoints) — Experimental HttpApi MCP routes.
- ›Integrations (7 endpoints) — Integration discovery and authentication routes.
- ›24 more areas: Permissions, Workspace, File, Global, Opencode Httpapi, Project, Projectcopy, Provider, Session Questions, Sync, Config, Control, Filesystem, Question, Permission, Providers, Commands, Controlplane, Event, Events, Messages, Models, Reference, Skills
- v1.18.16
OpenCode v1.18.16 adds right-click project menu on Home and tolerates unknown config fields.
└──▷ GET THIS VERSION$ git clone --branch v1.18.16 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.18.16
- ›Adds right-click context menu on the Home screen to open the project menu in the desktop app.
- ›Ignores unknown top-level config fields instead of failing config parsing, making configs more forward-compatible.
- v1.18.16
OpenCode v1.18.16 adds right-click project menu in the desktop Home view and improves macOS app lifecycle handling.
└──▷ 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 context menu on projects in the desktop Home view to open the project menu.
- ›Keeps the macOS desktop app running after the last window closes and reopens a window when the app is activated from the Dock.
- ›Unknown top-level config fields are now silently ignored instead of causing config parsing failures.
- v1.18.16
OpenCode v1.18.16 adds right-click project menu in the desktop Home view and improves macOS app lifecycle handling.
└──▷ 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 context menu on projects in the desktop Home view to open the project menu.
- ›Keeps the macOS desktop app running after the last window closes and reopens a window when the app is activated from the Dock.
- ›Unknown top-level config fields are now silently ignored instead of causing config parsing failures.
- v1.18.15
OpenCode v1.18.15 adds session transcript JSON export and broader locale coverage to the desktop app.
└──▷ GET THIS VERSION$ git clone --branch v1.18.15 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.18.15
- ›Export full session transcripts as JSON from the desktop UI.
- ›Added much broader locale coverage across the desktop app.
- v1.18.15
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 3-dot session dropdown menu, an Export session button in the Context tab, and asession.exportcommand palette action (/export) to export full session transcripts as JSON from the desktop UI. - ›Adds much broader locale coverage across the desktop app.
- ›Adds
- v1.18.15
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 3-dot session dropdown menu, an Export session button in the Context tab, and asession.exportcommand palette action (/export) to export full session transcripts as JSON from the desktop UI. - ›Adds much broader locale coverage across the desktop app.
- ›Adds
- v1.18.14
xAI login simplified to device-code flow for headless and remote environments.
└──▷ 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
- ›Simplifies xAI authentication to a single device-code flow, eliminating OAuth confusion in headless and remote environments.
- v1.18.14
xAI login simplified to device-code flow for headless and remote environments.
└──▷ 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
- ›Simplifies xAI authentication to a single device-code flow, eliminating OAuth confusion in headless and remote environments.
- v1.18.10
OpenCode v1.18.10 automatically discovers available Modal models and always surfaces the new session button.
└──▷ GET THIS VERSION$ git clone --branch v1.18.10 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.18.10
- ›Automatically discovers available Modal models so users no longer need to manually configure them.
- ›Always shows the new session button in the Desktop UI regardless of current state.
- v1.18.10
OpenCode v1.18.10 adds automatic Modal model discovery and improves desktop tab and notification UX.
└──▷ 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, regardless of current state.
- ›Improves toast notifications with better stacking, dismissal, and mobile layout in the desktop app.
- ›Refines desktop titlebar tab hover, active, and overflow states.
- v1.18.10
OpenCode v1.18.10 adds automatic Modal model discovery and improves desktop tab and notification UX.
└──▷ 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, regardless of current state.
- ›Improves toast notifications with better stacking, dismissal, and mobile layout in the desktop app.
- ›Refines desktop titlebar tab hover, active, and overflow states.
- v1.18.9
OpenCode v1.18.9 adds an opt-in V2 desktop sidecar via
OPENCODE_SIDECAR_V2=1and collapsible model provider sections in V2 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
└──▷ TRY ITSwitch the desktop app to the V2 background daemon to try the new sidecar architecture.$ OPENCODE_SIDECAR_V2=1 opencode- ›Adds
OPENCODE_SIDECAR_V2=1environment variable to initialize the desktop app from the V2 background daemon instead of the V1 utility sidecar, with daemon state persisted across desktop restarts. - ›Adds collapsible model provider sections in the V2 settings page, with collapse state persisted per server and search expanding matching sections temporarily without altering saved state.
- ›Adds
- v1.18.9
OpenCode v1.18.9 adds an opt-in V2 desktop sidecar via
OPENCODE_SIDECAR_V2=1and collapsible model provider sections in V2 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
└──▷ TRY ITSwitch the desktop app to the V2 background daemon to try the new sidecar architecture.$ OPENCODE_SIDECAR_V2=1 opencode- ›Adds
OPENCODE_SIDECAR_V2=1environment variable to initialize the desktop app from the V2 background daemon instead of the V1 utility sidecar, with daemon state persisted across desktop restarts. - ›Adds collapsible model provider sections in the V2 settings page, with collapse state persisted per server and search expanding matching sections temporarily without altering saved state.
- ›Adds
- v1.18.8
OpenCode v1.18.8 upgrades the MCP client SDK to v2 and adds a project-selector keyboard shortcut in the desktop app.
└──▷ 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
mod+shift+oshortcut to open the project selector on the new-session page in the desktop app (disabled when no projects are available).
- v1.18.8
OpenCode v1.18.8 upgrades the MCP client SDK to v2 and adds a project-selector keyboard shortcut in the desktop app.
└──▷ 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
mod+shift+oshortcut to open the project selector on the new-session page in the desktop app (disabled when no projects are available).
- v1.18.4
OpenCode v1.18.4 adds adaptive thinking controls for Kimi models and desktop terminal theme sync.
└──▷ GET THIS VERSION$ git clone --branch v1.18.4 https://github.com/sst/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 app theme in the desktop client.
- ›Rewrites the v2 prompt input in the desktop client for more reliable command, context, shell, attachment, and history interactions.
- ›Improves the review panel with better resizing, sticky controls, and open file tabs that stay aligned with the current diff view.
- v1.18.4
OpenCode v1.18.4 adds adaptive thinking controls for Kimi models and several desktop UI improvements.
└──▷ 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.
- ›Rewrites the v2 prompt input for more reliable command, context, shell, attachment, and history interactions.
- ›Syncs the embedded terminal theme with the app theme.
- ›Improves the review panel so open file tabs stay aligned with the current diff view.
- ›Improves review panel resizing and sticky controls.
- v1.18.4
OpenCode v1.18.4 adds adaptive thinking controls for Kimi models and several desktop UI improvements.
└──▷ 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.
- ›Rewrites the v2 prompt input for more reliable command, context, shell, attachment, and history interactions.
- ›Syncs the embedded terminal theme with the app theme.
- ›Improves the review panel so open file tabs stay aligned with the current diff view.
- ›Improves review panel resizing and sticky controls.
- v1.18.2
OpenCode v1.18.2 adds Mod+N shortcut for new tabs and a configurable subagent depth limit.
└──▷ GET THIS VERSION$ git clone --branch v1.18.2 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.18.2
- ›Adds Mod+N as an additional keyboard shortcut for opening a new tab in the desktop app.
- ›Adds configurable
subagent_depthlimit to control how deeply subagents can spawn nested subagents.
- v1.18.0
OpenCode Desktop v1.18.0 adds a layout switcher and completes the v2 migration with first-launch onboarding.
└──▷ GET THIS VERSION$ git clone --branch v1.18.0 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.18.0
- ›Adds a setting to switch between the new (v2) and legacy Desktop layouts during the transition period.
- ›Completes the Desktop v2 migration, including upgrade handling and first-launch onboarding flow.
- v1.17.19
OpenCode v1.17.19 adds per-prompt model selection, middle-click tab sessions, and a redesigned review panel with persistent file browsing.
└──▷ GET THIS VERSION$ git clone --branch v1.17.19 https://github.com/sst/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.
- ›Updates the review panel with persistent file browsing, improved file tabs, and easier open-in-app actions.
- ›Redesigns attachment cards and file comment chips in the new interface.
+1 moreshow less
- ›Restyled the Edit Project modal to match the new interface.
- v1.17.16
OpenCode desktop gains inline file browser tabs, a composer add menu, and per-session review panel memory.
└──▷ GET THIS VERSION$ git clone --branch v1.17.16 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.16
- ›Adds an 'Open containing folder' action for projects on the home screen.
- ›New composer add menu lets users attach files, commands, context, and toggle shell mode without losing draft text.
- ›Adds a provider setup tip on new sessions when no external providers are connected.
- ›Remembers review panel mode and selected file per session.
- ›Adds inline file browser tabs for opening and previewing files from the side panel.
- v1.17.14
OpenCode v1.17.14 adds a code mode MCP adapter, desktop tab management, and overhauled review panel.
└──▷ GET THIS VERSION$ git clone --branch v1.17.14 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.14
- ›Adds a code mode MCP adapter for running confined orchestration scripts against connected MCP tools.
- ›Shows the
executetool only when code mode is enabled, keeping it hidden otherwise. - ›Displays draft server status in the desktop title bar.
- ›Adds reopening of closed tabs and background tab opening in the desktop app.
- ›Adds recently closed projects to the desktop Home screen.
+6 moreshow less
- ›Improves model search in picker dialogs.
- ›Overhauled the v2 review panel in the desktop app.
- ›Unified the provider connect flow across the desktop app.
- ›Improved integrated terminal experience in the desktop app.
- ›Makes tab navigation respond on mouse down in the new desktop layout.
- ›Refined the session tab preview popover in the desktop app.
- v1.17.13
OpenCode desktop gains a searchable model picker, session tab hover previews, and streamlined WSL setup in v2 UI.
└──▷ GET THIS VERSION$ git clone --branch v1.17.13 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.13
- ›Adds a searchable model picker and model management flow in the v2 composer.
- ›Shows a hover preview for session tabs displaying project, path, branch, and server details.
- ›Streamlines WSL server setup with clearer distro checks and install flows in the v2 UI.
- v1.17.12
OpenCode v1.17.12 adds yolo auto-approve mode, SDK event streams, session history, and desktop MCP autocomplete.
└──▷ GET THIS VERSION$ git clone --branch v1.17.12 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.12
- ›Adds a yolo mode to the TUI that auto-approves all permission prompts without interruption.
- ›New live event subscription stream in the SDK for real-time session monitoring.
- ›SDK now exposes access to active sessions programmatically.
- ›Adds paged durable session history via the SDK.
- ›New SDK endpoints for creating and fetching session permission requests.
+4 moreshow less
- ›Autocomplete MCP resources directly in the desktop composer.
- ›Desktop shows stored token and cost totals in the session context panel.
- ›Desktop adds workspace controls when starting a new session.
- ›TUI passes ServerAuth headers through external served TUI connections.
- v1.17.11
OpenCode v1.17.11 adds session snapshots with revert controls, draggable tabs, and Chrome-style tab shortcuts.
└──▷ GET THIS VERSION$ git clone --branch v1.17.11 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.11
- ›Adds session snapshots and revert controls to roll back a session — including file changes — to any earlier message.
- ›Adds Chrome-style tab cycle shortcuts (
mod+1throughmod+9) in the desktop app. - ›Adds draggable tabs in the desktop app.
- v1.17.10
OpenCode v1.17.10 adds
--miniCLI mode, MCP resource tools, diff-viewer keybinds, and a V2 plugin API└──▷ GET THIS VERSION$ git clone --branch v1.17.10 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.10
└──▷ TRY ITRun OpenCode in a stripped-down mode suitable for scripting or low-resource environments.$ opencode --mini
- ›Adds
--miniCLI mode for a lightweight invocation of OpenCode. - ›Adds MCP resource template listing, enabling discovery of parameterized MCP resource templates.
- ›Adds MCP resource read tools, allowing agents to fetch MCP resources directly during sessions.
- ›Injects MCP server instructions into session context so models receive server-level guidance automatically.
- ›Adds a configurable keybind to open the diff viewer in the TUI.
+6 moreshow less
- ›Adds diff viewer support for comparing the working tree against the main branch.
- ›Adds Opencode-managed provider integration support, with integration IDs exposed in the SDK.
- ›Adds namespaced plugin hook APIs and a V2 plugin API supporting both Effect and Promise plugins.
- ›Adds video and audio media support to the Gemini protocol (community contribution).
- ›Desktop: adds a session progress indicator, mobile bottom navigation, collapsible server sections, and server-aware session routes.
- ›Desktop: keeps draft prompt state per tab for persistent multi-tab workflows.
- ›Adds
- v1.17.9
Adds high and max thinking variants for GLM-5.2 across supported providers.
└──▷ GET THIS VERSION$ git clone --branch v1.17.9 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.9
- ›Adds
highandmaxthinking variants for GLM-5.2 across supported providers.
- ›Adds
- v1.17.8
OpenCode v1.17.8 adds a Home tab toggle and a faster desktop file/folder picker in the v2 layout.
└──▷ GET THIS VERSION$ git clone --branch v1.17.8 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.8
- ›Adds a Home tab toggle in the desktop UI to quickly switch between the Home view and your last active tab.
- ›New desktop file and folder picker is faster and easier to navigate in the v2 layout.
- v1.17.7
OpenCode v1.17.7 lets MCP servers receive the current workspace as a client root and refreshes SDK model availability on integration changes.
└──▷ GET THIS VERSION$ git clone --branch v1.17.7 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.7
- ›MCP servers can now receive the current workspace as a client root, enabling workspace-aware MCP integrations.
- ›SDK clients now refresh model and provider availability automatically when integrations change.
- ›SDK credential update and remove calls now accept a
locationparameter.
- v1.17.5
OpenCode v1.17.5 adds external browser OAuth for Snowflake Cortex and refreshed oc-2 color theme.
└──▷ GET THIS VERSION$ git clone --branch v1.17.5 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.5
- ›Adds external browser OAuth support for the Snowflake Cortex provider.
- ›Refreshes the oc-2 color theme in the desktop app.
- v1.17.4
OpenCode v1.17.4 adds MCP server cwd support, connector-based auth, and new v2 session API endpoints.
└──▷ GET THIS VERSION$ git clone --branch v1.17.4 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.4
└──▷ USE ITPin a local MCP server to a specific subdirectory so it resolves paths relative to your project root rather than the shell's working directory.# In your opencode config, set cwd on a local MCP server entry: { "mcpServers": { "my-server": { "command": "node", "args": ["server.js"], "cwd": "./tools/my-server" } } }- ›Adds
cwdsupport 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.
- ›MCP server log notifications are now surfaced in opencode logs.
- ›Adds
- v1.17.1
OpenCode v1.17.1 adds richer reference metadata and a new desktop
/new-sessionroute with draft tabs.└──▷ GET THIS VERSION$ git clone --branch v1.17.1 https://github.com/sst/opencode.git # already have the repo? check out this version: $ git checkout v1.17.1
- ›References now support usage descriptions for agents, visibility control to hide entries from
@autocomplete, and inclusion in generated docs. - ›New
/new-sessiondesktop route introduces draft tabs that keep prompt and project selection together until the session is started.
- ›References now support usage descriptions for agents, visibility control to hide entries from
- v1.17.0
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-backedfile 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
reasoningas an interleaved field option for vLLM providers. - ›Enables
mcp addto work in non-interactive (scripted/CI) flows.
+6 moreshow less
- ›Enables
auth logoutto 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.
- ›Adds
- v1.16.2
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.
- v1.16.0
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 ITReplay a previous session interactively to review or audit AI agent actions step by step.$ opencode run --replay
- ›Adds
run --replayflag 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 moreshow 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.
- ›Adds
- v1.15.13
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.
- v1.15.12
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 ITEnable 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.
- ›Adds WebSocket transport for OpenAI responses, enabled via
- v1.15.11
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 ITSet a custom header timeout for slow provider endpoints to avoid premature connection drops.# In your opencode config file: headerTimeout: 30000
- ›Adds
headerTimeoutconfig option for provider requests (defaults to 10s for OpenAI setups) to control how long to wait for response headers. - ›Supports setting only
modalities.inputormodalities.outputin 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
disposehook for plugins in the Extensions API.
+1 moreshow less
- ›Desktop v2 home screen, prompt, status popover, and session controls refined.
- ›Adds
- v1.15.9
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.
- v1.15.7
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.
- v1.15.6
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
runprompt for running shell commands directly. - ›Replaces subagent tabs with an on-demand picker in
runfor 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 moreshow less
- ›Adds a native app menu on Windows.
- ›Adds Ukrainian locale support.
- v1.15.5
OpenCode v1.15.5 adds
--replayflags 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 ITResume a session and review the last N exchanges before continuing — useful for picking up context after an interruption.$ opencode --replay --replay-limit 10
- ›Adds
--replayand--replay-limitCLI 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.
- ›Adds
- v1.15.1
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.
- v1.15.0
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.
- v1.14.51
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.
- v1.14.50
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
- ›Adds
instance.directoryandinstance.workspacequery support to v2 SDK model and provider calls.
- ›Adds
- v1.14.49
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.jsoncconfig when none exists. - ›Enables
customize-opencodeby default with a linked full schema. - ›Adds autocomplete for configured
@mentionsin prompts.
+3 moreshow 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.
- v1.14.47
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.
- v1.14.46
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
- ›Adds a built-in
customize-opencodeskill so config edits are less likely to break startup.
- ›Adds a built-in
- v1.14.42
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 moreshow less
- ›Shows retrying sessions as active in the project sidebar.
└──▷ 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
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.
- v1.14.40
OpenCode v1.14.40 adds support for
.well-known/opencoderemote 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/opencodeconfigs 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.
- ›Supports
- v1.14.34
OpenCode v1.14.34 adds PTY connection tickets, v2 session failure events, and a new
debug infoTUI 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 ITDump 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 infoTUI command prints environment and diagnostic details.
- v1.14.31
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_dirand deny permissions, enabling consistent sandbox boundaries across spawned tasks.
- v1.14.30
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.
- v1.14.29
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_contentby 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 moreshow 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 createnow writes a validpermissions.denyconfig. - ›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.
- ›Enables DeepSeek OpenAI-compatible setups to interleave
- v1.14.27
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
- ›Adds a configurable default shell for terminals and agent shell commands, controllable via a Desktop setting.
- v1.14.26
OpenCode v1.14.26 adds Zed editor support and a
/connecttip 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
/connecttip in the TUI when no models are configured. - ›Sends an
opencode/<version>User-Agent header with all HTTP requests.
- v1.14.25
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.
- ›Adds Roslyn LSP support for Razor,
- v1.14.24
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.
- v1.14.22
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
.npmrcsettings during npm installs, enabling private registry and auth configs to be honoured automatically. - ›Enables per-project custom icon overrides that persist correctly across sessions.
- ›Supports
- v1.14.21
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.
└──▷ BREAKING ON UPGRADE- !C# support now uses Roslyn Language Server instead of
csharp-ls; any environment or config that relies oncsharp-lsbeing the backend will need to be updated.
- v1.14.20
OpenCode v1.14.20 adds GET
/configto 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 /configendpoint to the experimental HTTP API. - ›Adds a desktop setting to hide the session progress bar while the agent is working.
- ›Adds
- v1.14.19
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.
└──▷ 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
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_ATTRIBUTESenvironment 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.
- v1.4.10
OpenCode v1.4.10 passes
EXA_API_KEYto 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_KEYto thewebsearchtool, 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.
- ›Passes
- v1.4.9
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.
- v1.4.8
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/nullin revert diffs.
- v1.4.7
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 ITLock 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
xhighadaptive 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 moreshow less
- ›The
--agentflag on the command line is no longer overwritten by a session's saved agent.
- ›Supports
- v1.4.5
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.
- v1.4.4
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 ITExport 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 --sanitizeto redact PII and confidential data from transcripts. - ›Adds experimental
compaction.autocontinuehook 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 moreshow less
- ›Reading images no longer counts against quota.
- ›Snapshots now fully respect
.gitignore, including previously tracked files.
- v1.4.3
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.
- v1.4.1
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.
- v1.4.0
OpenCode v1.4.0 adds OTLP observability, HTTP proxy support, PDF drag-and-drop, and a new
--dangerously-skip-permissionsrun 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 ITAuto-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-permissionsflag 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.
└──▷ BREAKING ON UPGRADE- !Diff metadata in the edit and patch tool no longer contains
toandfromfields with full file contents — only apatchfield with the unified diff remains. Session and user message snapshot diffs follow the same format. - !
UserMessage.variantis now nested undermodel: useuserMessage.model.variantinstead ofuserMessage.variant.
- v1.3.16
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 ITDisable 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/azureusers. - ›Exposes session model and mode config options through ACP (Agent Control Protocol).
- ›Enables disabling TUI mouse capture via config or the
OPENCODE_DISABLE_MOUSEenvironment 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.
- ›Supports Azure model options on both chat and responses paths for
- v1.3.14
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 moreshow less
- ›Adds support for theme-only plugin packages (Extensions).
- v1.3.12
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
- ›Enables prompt caching and cache token tracking for Google Vertex Anthropic provider.
- v1.3.11
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.
- v1.3.7
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.
- v1.3.4
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 moreshow 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.
- v1.3.3
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
createDirectoryoption 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+arrowtocmd+opt+[/cmd+opt+]to preserve native cursor movement.
+1 moreshow less
- ›Respects agent permission configuration for the
todowritetool.
└──▷ BREAKING ON UPGRADE- !Message navigation keybinds changed from
cmd+arrowtocmd+opt+[/cmd+opt+]; existing muscle memory or documented shortcuts will no longer work. - !The
.jsonextension is removed from electron-store files, enabling seamless Tauri-to-Electron migration but altering the on-disk store path.
- v1.3.2
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
- ›New 'Write heap snapshot' command captures memory snapshots of both TUI and server processes, saving to
tui.heapsnapshotandserver.heapsnapshot.
- ›New 'Write heap snapshot' command captures memory snapshots of both TUI and server processes, saving to
- v1.3.1
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).
- v1.3.0
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 moreshow 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.
└──▷ BREAKING ON UPGRADE- !The Anthropic OAuth plugin has been removed.
- v1.2.26
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 moreshow less
- ›Fork session now copies the prompt into the new session.
- ›Synchronizes sidebar state across the application.
- v1.2.25
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 ITUse Vertex AI with a specific region by setting the new environment variable before running opencode.$ GOOGLE_VERTEX_LOCATION=us-east1 opencodeOpt 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_LOCATIONenvironment variable support for Vertex AI. - ›Adds thinking variants support for SAP AI provider.
- ›Adds a debug window to the desktop app.
+3 moreshow less
- ›Puts workspace routing behind
OPENCODE_EXPERIMENTAL_WORKSPACESfeature flag. - ›Blocks access to system directories.
- ›Displays development statistics in the desktop application.
- v1.2.24
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-07beta header. - ›Adds Copilot GPT-5.4
xhighmodel support.
- v1.2.22
OpenCode v1.2.22 adds
OPENCODE_SKIP_MIGRATIONSflag 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 ITSkip 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_MIGRATIONSenvironment 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.
- ›New
- v1.2.21
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 moreshow less
- ›Logs stack trace when schema validation fails, aiding debugging of configuration issues.
- v1.2.19
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.
- v1.2.18
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 logincommand 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.
- ›Adds options to
- v1.2.17
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
--attachflag, catching misconfiguration earlier. - ›Reworks workspace integration and adaptor interface for improved extensibility.
- v1.2.16
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 moreshow less
- ›Enables markdown rendering by default via OpenTUI upgrade to v0.1.86.
- ›Adds Go provider list command.
- ›Exposes
OPENCODE_PIDenvironment 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.
- v1.2.15
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.
- v1.2.14
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
- ›New message delete endpoint in the core API enables programmatic deletion of messages.
- v1.2.11
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 ITUse 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-servecommand 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
variantparameter in GitHub Actions andopencode github runcommand. - ›Caches platform binary in postinstall for faster startup.
+4 moreshow 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.
- ›Adds experimental
- v1.2.8
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.
- v1.2.7
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
sessionIDandcallIDto theshell.envhook input in plugins.
+6 moreshow less
- ›Surfaces plugin auth providers in the login picker.
- ›Emits
PROMPT_TOO_LARGEerror 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.
- v1.2.6
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 ITResume 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
dfmtformatter support for D language files. - ›Adds
cljfmtformatter support for Clojure files. - ›Adds OpenAI-compatible endpoint support for the Google Vertex provider.
- ›Adds Venice provider support for
temperature,topP,topK, andsmallOptionparameters. - ›Adds a database migration command to convert JSON storage to SQLite.
+2 moreshow less
- ›Adds
--continueand--forkflags to theattachcommand. - ›Prioritizes user-defined variables over environment variables in Google Vertex AI configuration.
- ›Adds
- v1.2.5
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.
- v1.2.4
OpenCode v1.2.4 adds a
dbcommand 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 ITInspect or query your local OpenCode database directly from the terminal.$ opencode db- ›New
dbcommand for database inspection and querying. - ›New 'Clear notifications' action in the desktop UI.
- ›New
- v1.2.1
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
PartDeltaSDK 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.
└──▷ 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
OpenCode v1.2.0 migrates storage to SQLite and adds a PartDelta SDK event plus a
--dirCLI 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 ITRun 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
PartDeltaSDK bus event (message.part.delta) delivers only incremental text-part changes, eliminating redundant full-content retransmissions. - ›New
--diroption on theruncommand 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.
└──▷ 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
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 ITOverride a built-in tool's description or parameters from a plugin to restrict or annotate its behavior for your team.// 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.definitionhook 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.
└──▷ BREAKING ON UPGRADE- !Worktree delete functionality has been removed.
- ›Adds
- v1.1.64
OpenCode v1.1.64 adds token substitution in
OPENCODE_CONFIG_CONTENTand 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 ITInject 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_CONTENTenvironment 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.
- ›Supports token substitution in the
- v1.1.62
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.
- v1.1.61
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.
- v1.1.60
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 moreshow less
- ›Adds a toggle to hide the session header in the TUI.
- ›Uses Promise.all for MCP listTools calls to improve performance.
- v1.1.58
OpenCode v1.1.58 adds mode-specific input placeholders, Ctrl+C dialog dismissal, and persistent
/sharelink 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
/sharecommand available after sharing so users can copy an existing share link at any time. - ›Enables notifications on child sessions in the desktop app.
- v1.1.57
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
/reviewprompt 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.
- v1.1.55
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
- ›Displays a helpful message when the free usage limit is exceeded, guiding users on next steps.
- v1.1.54
OpenCode v1.1.54 adds
--forkflag, 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 ITEnable model autocomplete in opencode.json by referencing the models.dev schema.{ "$schema": "https://models.dev/opencode.json" }- ›Adds Claude Code-style
--forkflag 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 moreshow 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
ContextOverflowErrortype 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.errorevent 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
isSidecarprop 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.
- ›Adds Claude Code-style
- v1.1.53
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.
- v1.1.52
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 ITEnable model autocomplete when editing opencode.json by referencing the models.dev schema.{ "$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 moreshow 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.
- v1.1.51
OpenCode v1.1.51 restores OSC52 clipboard support and prioritizes
OPENCODE_CONFIG_DIRfor 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_DIRenvironment variable when resolving theAGENTS.mdfile location. - ›Restores direct OSC52 clipboard support in the TUI.
- ›Prioritizes
- v1.1.50
OpenCode v1.1.50 adds shell.env hook, Trinity model support, skills directory loading, and
--thinkingflag 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 ITSee 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.// In your opencode plugin (shell.env hook) export default { hooks: { "shell.env": (env) => ({ ...env, MY_API_KEY: "secret", NODE_ENV: "production", }), }, };- ›Adds
shell.envhook for manipulating environment variables in tools and shell via plugins. - ›Adds Trinity model system prompt support.
- ›Supports reading skills from
.agents/skillsdirectories. - ›Adds
--thinkingflag to theruncommand to display reasoning blocks. - ›Allows theme colors in agent customization.
+4 moreshow less
- ›Adds
.slnxto C#/F# LSP root detection. - ›Makes the CLI
runcommand non-interactive. - ›Moves session search to the command palette in the desktop app.
- ›Allows empty prompt with review comments in the desktop app.
- ›Adds
- v1.1.49
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 ITExpose OpenCode on a custom mDNS hostname on your local network for easier discovery across devices.$ opencode --mdns-domain mydevbox.local
- ›Adds
--mdns-domainflag 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 moreshow 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.
- ›Adds
- v1.1.48
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 ITPoint 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_PATHenvironment 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_URLenvironment variable during the build process. - ›Excludes chat models from the
textVerbositysetting.
- ›Supports specifying a custom models file path via the
- v1.1.42
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.
- v1.1.41
OpenCode v1.1.41 adds
ctx.abortto the grep tool and AbortSignal support to Ripgrep.files() andGlobTool.└──▷ 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.abortto the grep tool, enabling cooperative cancellation of grep operations. - ›Adds
AbortSignalsupport to Ripgrep.files() andGlobTool, allowing callers to cancel file-search operations mid-flight. - ›Supports Copilot model variants with
maxTokensset, enabling use of previously broken model configurations.
- ›Adds
- v1.1.40
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 moreshow less
- ›Adds streaming prop to the markdown element for real-time rendering.
- v1.1.38
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
- ›Adds experimental OpenTUI markdown rendering component to the app, available behind an experimental flag.
- v1.1.37
OpenCode v1.1.37 adds headless ChatGPT/Codex auth, Kimi K2.5 tuning, dynamic AGENTS.md discovery, and a
/learncommand.└──▷ 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.directoryto custom tools for more accurate path resolution. - ›Adds worktree context to the plugin tool context.
+12 moreshow 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.
- v1.1.36
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
- ›Enables thinking mode for Google Vertex Anthropic models.
- v1.1.35
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
xhighreasoning 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 moreshow 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
onFiltercallback to the List component and hides the add-server row during search.
- v1.1.34
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
- ›Adds line selection functionality to the desktop app.
- v1.1.33
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 moreshow less
- ›Non-git projects can now be renamed in the desktop app.
- v1.1.32
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 ITAttach 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 moreshow 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
--dirflag in theattachcommand (TUI). - ›Moves markdown rendering to Rust in the desktop app for improved performance.
- ›Renames
setSessionModeltounstable_setSessionModelin the ACP API.
└──▷ BREAKING ON UPGRADE- !The
setSessionModelACP method is renamed tounstable_setSessionModel; any client code callingsetSessionModelwill break.
- v1.1.31
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.headershook 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.
└──▷ BREAKING ON UPGRADE- !The Desktop app's 'Chinese' language option is renamed to 'Chinese (Simplified)'.
- ›Adds
- v1.1.30
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 ITUse 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/listandsession/forksupport to ACP (Agent Communication Protocol). - ›Supports
~and$HOMEprefixes 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 moreshow less
- ›Tab key now selects suggestions in the desktop app.
- ›Adds
- v1.1.29
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 ITPrevent 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 opencodeSkip 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_CONFIGenvironment variable to disable project-level configuration loading. - ›New
OPENCODE_DISABLE_FILETIME_CHECKenvironment variable to skip file modification time checks. - ›Session titles now respond in the user's language.
+8 moreshow 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.
- v1.1.28
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 moreshow 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.
- v1.1.27
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.
- v1.1.26
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_patchtool for OpenAI models.
+10 moreshow 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
.fbsfiles as text instead of images in tool handling. - ›Opens the help dialog via the
tui/open-helproute. - ›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.
- v1.1.25
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.
- v1.1.24
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
/statusdialog in the TUI. - ›Adds tab navigation support for question prompts in the TUI.
+5 moreshow 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.
- ›Adds LiteLLM proxy provider option for explicit LiteLLM compatibility (
- v1.1.23
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 moreshow 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.
- v1.1.21
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 ITUpgrade OpenCode on Windows via Chocolatey to get the latest release without manual downloads.$ choco upgrade opencodeUpgrade 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.
- v1.1.19
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 moreshow less
- ›Ensures Bash tool invocations and external directory references render working directory details in the TUI.
- v1.1.18
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.
- v1.1.16
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 moreshow less
- ›Makes environment file reads prompt the user for permission instead of silently blocking.
- ›Stores API URL in session metadata.
- v1.1.15
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 ITSecure 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.
└──▷ BREAKING ON UPGRADE- !The
OPENCODE_PASSWORDenvironment variable is renamed toOPENCODE_SERVER_PASSWORD; existing setups usingOPENCODE_PASSWORDwill no longer authenticate correctly until updated.
- v1.1.14
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
resourcecontent 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 moreshow less
- ›Adds image preview support for image attachments in the desktop app.
- ›Supports
- v1.1.13
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.transformfor richer system prompt customization. - ›Follows symlinks by default in ripgrep searches.
- ›Supports configuring a default server URL for the desktop app.
+2 moreshow less
- ›Makes mouse hover and click work on prompt input autocomplete in the desktop app.
- ›Disables telemetry in the PHP language server.
- v1.1.12
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-Idheader, enabling use with ChatGPT organization subscriptions.
- ›Supports
- v1.1.11
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.
- v1.1.10
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.
└──▷ 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
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 moreshow less
- ›Adds Vesper theme to the desktop app.
- v1.1.7
OpenCode v1.1.7 adds an interactive question tool, overlay sidebar for narrow screens, expandable bash output, and
.claudeprompt 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
.claudeprompt and skills loading via flags. - ›Writes truncated tool outputs to files instead of silently dropping them.
+4 moreshow less
- ›Adds
kind,title, andrawInputfields to ACPtool_call_updateevents. - ›Improves responsive TUI layout by hiding header and footer when sidebar is visible.
- ›Shows custom models without a valid
release_datein the web UI model selector. - ›Adds help text to the
debugcommand and its subcommands.
- v1.1.6
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-caflag 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 moreshow 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.
- ›Adds
- v1.1.4
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 ITPlace 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_DIRinto 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 moreshow 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.
- v1.1.3
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 moreshow 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.
- ›Supports
- v1.1.2
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 moreshow less
- ›Implements auto-scroll for the active command in the slash popover (desktop).
- v1.1.1
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 ITSet fine-grained per-tool permissions using glob patterns in your project config to control what the agent can touch.{ "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
permissionconfig replacestools, supporting glob-pattern rules per tool (e.g., allownpm *, denyrm *, 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/replyAPI endpoint for responding to permission requests programmatically.
+15 moreshow less
- ›Adds CORS whitelist support via
server.corsconfig option. - ›New
tui.session.selectAPI endpoint for TUI session navigation from plugins. - ›Adds
--variantflag to theruncommand for selecting agent variants. - ›Adds
/compactsession command to compress conversation history. - ›Adds image preview support in the desktop session viewer.
- ›New Osaka Jade theme available in TUI.
- ›Agent
stepsfield replaces deprecatedmaxStepsfor 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.
└──▷ BREAKING ON UPGRADE- !The
PermissionNext.Eventstructure replacesPermission.Event: event name changed frompermission.updatedtopermission.asked;typefield renamed topermission;pattern(string) replaced bypatterns(array of strings);messagefield removed;responserenamed toreply;permissionIDrenamed torequestID; newalwaysfield added. - !Old endpoint
POST /session/:sessionID/permissions/:permissionIDis deprecated in favor ofPOST /permission/:requestID/reply. - !
GET /permissionnow returnsPermissionNext.Request[]instead ofPermission.Info[]. - !Mode and plugin globs no longer search subdirectories — only top-level files are matched.
- !Agent
toolsfield is deprecated — usepermissioninstead. - !Agent
maxStepsfield is deprecated — usestepsinstead.
- ›New granular
- v1.0.222
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.
- v1.0.221
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/didChangeWatchedFilesnotification 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 moreshow less
- ›Adds input changes functionality to the desktop app.
- v1.0.220
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 ITQuickly 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.
- ›New
- v1.0.219
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 ITInvoke 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
statscommand. - ›Adds
rustfmtformatter support for Rust files. - ›Adds Gemini 3 Flash to the fast models list.
- ›Bundles
@ai-sdk/vercelv1.0.31 for AI SDK v5 support.
+3 moreshow less
- ›Adds configurable timeout for MCP tool calls to prevent hanging requests.
- ›Adds configurable CORS hosts.
- ›Adds model variants support to the desktop app.
- v1.0.218
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
- v1.0.214
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.
- v1.0.210
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 moreshow less
- ›Adds system notifications support for the desktop application.
- v1.0.209
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
formatparameter optional in WebFetch, defaulting to markdown.
- v1.0.208
OpenCode v1.0.208 adds Bedrock region/bearer-token config,
.claude/skillssupport, 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
regionandbearer tokenconfiguration in Amazon Bedrock provider. - ›Adds support for
.claude/skillsdirectory for organizing reusable skill definitions. - ›Installs local plugin dependencies from
package.jsonautomatically. - ›Adds auto-accept edits toggle in the desktop application.
- ›Adds image preview and deduplication for file uploads in the desktop application.
+2 moreshow less
- ›Adds project editing functionality in the desktop application.
- ›Makes authentication URLs clickable regardless of line wrapping in the TUI.
- ›Adds support for
- v1.0.207
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.
- v1.0.205
OpenCode v1.0.205 adds bash completions, themes, thinking/tool-call visibility in
/copyand/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
/copyand/exportcommands. - ›Supports line numbers and ranges in autocomplete.
- ›Introduces themes support.
- v1.0.204
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.readandFile.listoperations. - ›Adds
shfmtformatter 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 moreshow less
- ›Adds permissions support.
- ›Adds support for GitHub
issuesandworkflow_dispatchevents.
- ›Adds path traversal protection to
- v1.0.203
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
- ›Adds Haskell Language Server (LSP) support for Haskell development workflows.
- v1.0.194
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_changednotifications 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.
- v1.0.191
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
mcpCLI 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.
- ›Adds ability to debug MCP OAuth via the
- v1.0.186
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 ITPaste 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 moreshow less
- ›Exposes
autoparameter insession.summarizefor plugin authors. - ›Improves built-in
/reviewprompt. - ›Adds Minimax m2.1 model with topP support alongside adjusted Minimax m2 topK.
- ›Adds mobile responsiveness to the UI.
- v1.0.185
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
.etsfiles. - ›Supports schedule events in GitHub Actions integration.
- ›Switches to the official MCP SDK for improved tool schema handling.
- ›Adds syntax highlighting for
- v1.0.181
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 ITSet a default agent so every session automatically uses it without specifying one each time.# 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_agentacross all API and user surfaces. - ›Appending
.mdto docs page URLs now serves raw markdown content.
- v1.0.180
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
- ›Adds endpoints to delete and update individual message parts via the API.
- v1.0.170
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.
- v1.0.168
OpenCode v1.0.168 adds Ty language server support, a TUI fork slash command, shell mode for desktop, and
OIDC_BASE_URLfor 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 ITFork the current session without leaving the keyboard when working in the TUI.$ /fork- ›Adds experimental support for the Ty language server.
- ›New
/forkslash command in the TUI enables keyboard-friendly session forking. - ›Adds shell mode for the desktop app.
- ›Supports
OIDC_BASE_URLfor custom GitHub App installs. - ›Removes interleaved thinking filter for certain Kimi K2 thinking model providers.
- v1.0.167
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 ITSuppress 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_TITLEenvironment 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.
- ›Adds option to disable terminal title in the TUI via the
- v1.0.165
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 ITOverride the default 32k output token cap when working with models that support larger outputs.$ OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX=65536 opencodeSuppress terminal title changes when running OpenCode inside a multiplexer or shared terminal session.$ OPENCODE_DISABLE_TERMINAL_TITLE=1 opencode- ›Adds
session.compactingexperimental 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_MAXenvironment variable to override the default 32k output token limit. - ›Adds
OPENCODE_DISABLE_TERMINAL_TITLEenvironment variable to suppress terminal title updates. - ›Shows loaded plugins in the
/statuscommand output.
+8 moreshow 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.
- ›Adds
- v1.0.164
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 ITRun a shell command via!using an alias defined in your shell config — useful when your workflow relies on custom aliases likegsforgit 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 moreshow less
- ›Desktop app now shows write tool output.
- ›Adds a flag to completely disable the git branch file watcher.
- v1.0.158
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
- ›Improves fuzzy search ranking to surface results that start with the user's input first.
- v1.0.154
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 ITRun 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.# 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.# In opencode config { "experimental": { "chat": { "system": { "transform": "path/to/system-transform-hook.js" } } } }- ›Adds
experimental.chat.system.transformhook for transforming the system prompt at runtime (alongside the restoredexperimental.chat.messages.transformhook). - ›Auto-submits the prompt when the
--promptCLI flag is used, removing the need for a manual confirmation step. - ›New
experimental.continue_loop_on_denyconfig 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.
- ›Adds
- v1.0.153
OpenCode v1.0.153 adds Gleam, Dockerfile, and TeX language servers, ARM64 Docker images, and a new
--sessionflag 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 ITAttach 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
--sessionflag to theattachcommand.
+4 moreshow less
- ›Adds support for
GITHUB_TOKENauthentication and skips OIDC in GitHub environments. - ›Adds
server_error,rate_limit, andno_kv_spaceretry logic to accommodate Foundry API issues. - ›Adds
topKfunction to transform, with temperature defaults for GLM and Minimax models. - ›Falls back to provider default for temperature when no value is configured.
- v1.0.152
OpenCode gains Windows Git Bash detection and
OPENCODE_GIT_BASH_PATHenv 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 ITPoint 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_PATHenvironment variable to explicitly set the Git Bash path.
- ›Adds automatic detection of Git Bash on Windows and supports the
- v1.0.151
OpenCode v1.0.151 adds an experimental
chat.messages.transformhook 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.transformhook 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.
- ›Adds experimental
- v1.0.150
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
- ›Supports the super modifier (Command/Windows key) in keybinds, enabling shortcuts like
super+zfor undo andsuper+shift+zfor redo.
- ›Supports the super modifier (Command/Windows key) in keybinds, enabling shortcuts like
- v1.0.147
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.
- v1.0.144
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 moreshow 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.
└──▷ 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
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 ITScript 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 theagent createcommand for scripting and automation.
- ›Adds Windows support for shell mode (
- v1.0.141
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 ITCap 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_MSenvironment variable to configure bash command timeout.
+2 moreshow less
- ›Enables project discovery for experimental builds.
- ›Improves interleaved thinking support.
- v1.0.138
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.
- v1.0.137
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 ITRemove 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 moreshow less
- ›Adds PDF support in the read tool.
- ›Adds
uninstallcommand. - ›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.
- v1.0.134
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 ITEnable OpenTelemetry spans to trace opencode agent calls through your existing OTEL-compatible observability stack.# In your opencode config { "experimental": { "open_telemetry": true } }- ›Adds
max_stepsconfiguration for supervisor and sub-agents to cap agentic step counts. - ›Adds experimental
experimental.open_telemetryconfig option to emit OTEL spans for tracing. - ›Adds Vercel theme for the TUI.
- ›Increases default scroll speed in the TUI.
- ›Adds
- v1.0.133
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.
- v1.0.130
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 ITRestrict sensitive tools so only your primary agent can invoke them, preventing sub-agents from accessing them.experimental: primary_tools: - bash - editorBind a key totool_detailsand bindmessages_last_userto jump back to your last prompt in a long session.keybinds: tool_details: "ctrl+t" messages_last_user: "ctrl+u"
- ›Adds
experimental.primary_toolssetting to restrict specified tools to primary agents only. - ›Adds
messages_last_userTUI command to jump the view to the last user message. - ›Adds
tool_detailskeybind (no default assigned) for accessing tool detail views. - ›Enhances DeepSeek reasoning content handling.
- ›Adds retry logic for Grok resource-exhausted errors.
- ›Adds
- v1.0.129
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 ITList existing sessions directly from the terminal without entering the TUI.$ opencode session listDisable 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 listcommand to list sessions from the CLI. - ›Adds toggle to hide username in the TUI.
- ›Adds
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECTenvironment variable to disable copy-on-select behavior. - ›Homebrew update check now uses Homebrew registry version info for more accurate update detection.
- ›Adds basic
- v1.0.127
OpenCode v1.0.127 adds an overridable
/reviewslash 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
/reviewslash command for customizable code review workflows. - ›Adds ability to toggle tool details visibility in the TUI interface.
- ›Adds an overridable
- v1.0.123
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
- ›Adds an 'Open docs' command to the command palette for quick access to documentation.
- v1.0.120
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.
- v1.0.115
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 ITDisable columnar side-by-side diffs if you prefer a unified diff view in the TUI.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_styleoption to allow disabling columnar diffs. - ›Shows the current git branch in the TUI.
- ›Enables Exa code/websearch integration.
└──▷ BREAKING ON UPGRADE- !The
vcs.changedconfig key is renamed tovcs.branch.updated; any existing configuration usingvcs.changedwill break.
- v1.0.113
OpenCode v1.0.113 adds
setCacheKeyoption 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
setCacheKeyoption 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.
- ›Adds
- v1.0.112
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_asyncfunctionality to submit prompts and return immediately without blocking. - ›Enhances the
statscommand 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.
- ›Adds
- v1.0.111
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 ITList all available models in alphabetical order to quickly locate a specific provider/model combination.$ opencode models- ›Adds
prompt_asynccommand to submit a prompt and return immediately without waiting for a response. - ›Enhances
opencode modelsoutput with alphabetical ordering for easier scanning. - ›Expands
statscommand to display average and median token counts per session. - ›Adds
setCacheKeyoption in provider options for cache control. - ›Improves theme selector UX with a current-theme indicator and easier selection flow.
- ›Adds
- v1.0.110
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
- ›Adds basic auth support to the OpenCode SDK.
- v1.0.109
OpenCode v1.0.109 adds
--refreshflag 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 ITForce-refresh the cached model list after adding a new provider or when models seem stale.$ opencode models --refresh
- ›Adds
--refreshflag to themodelscommand to force-refresh the available model list. - ›Adds autoupdate notification feature to alert users when a new version is available.
- ›Adds
- v1.0.107
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.
- v1.0.100
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
- v1.0.91
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.
- v1.0.86
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.
- v1.0.84
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.
- v1.0.82
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/leftto<leader>right/left. - ›Updates editor preference to use the
VISUALenvironment variable overEDITORper Unix convention.
└──▷ BREAKING ON UPGRADE- !The default child session cycle keybinds are changed from
ctrl+right/leftto<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
VISUALenvironment variable overEDITOR; if your environment sets both to different values, a different editor may open than before.
- v1.0.81
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 ITRaise 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_LENGTHenv 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.
└──▷ BREAKING ON UPGRADE- !The
/exportcommand now writes to the current working directory; any workflow that relied on the previous fixed output path will need to be updated.
- ›Adds
- v1.0.79
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 ITDisable all LSPs and formatters project-wide when you want a lightweight session without language server overhead.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 moreshow less
- ›Adds top-level
lsp: falseandformatter: falseconfig options to disable all LSPs or all formatters at once. - ›Disables fetch timeout by default in provider options, removing artificial request limits.
- v1.0.76
OpenCode v1.0.76 adds
opencode agent listto 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 ITDiscover which agents are configured and available before starting a session.$ opencode agent list- ›New
opencode agent listcommand displays all available agents with their details.
- ›New
- v1.0.73
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.
└──▷ BREAKING ON UPGRADE- !
scroll_speednow only accepts positive integers; non-integer positive numbers that were previously valid are no longer accepted.
- v1.0.69
OpenCode v1.0.69 adds Azure Cognitive Services support, a
/thinkingtoggle 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 ITToggle thinking block visibility mid-session to inspect model reasoning when debugging complex responses.$ /thinking- ›Adds
/thinkingslash 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.
- ›Adds
- v1.0.66
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 moreshow less
- ›Adds GPT-5-nano model as a selectable option.
- v1.0.63
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.
- v1.0.62
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
- ›Adds expandable sections to the sidebar for improved navigation.
- v1.0.59
OpenCode v1.0.59 adds agent color configuration and hides
/sharewhen 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
/sharecommand from the UI when sharing is disabled.
- v1.0.57
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.
- v1.0.56
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 moreshow less
- ›Upgrades toast notification system for better user feedback.
- v1.0.53
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
inputcontext fields tochat.paramsandchat.message. - ›Displays a 'Free' badge on zero-cost models in the model selection dialog.
- ›Adds startup logging when creating project instances to aid debugging.
- v1.0.52
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
- v1.0.50
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
- ›Adds
sessionID,agent,model, andmessageIDinput context tochat.paramsandchat.messageplugin hooks
- ›Adds
- v1.0.45
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.
- ›Supports reading opencode.json(c) config from a
- v1.0.43
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.
- v1.0.40
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
webcommand.
- v1.0.37
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.
- v1.0.36
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 ITImport a shared session directly from a share link instead of a local file.$ opencode import <share-link>- ›Adds share link support to the
importcommand, enabling direct import of shared sessions via URL. - ›Adds a big dot (●) indicator in the session modal to highlight the current active session.
- ›Adds share link support to the
- v1.0.27
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.
- v1.0.26
OpenCode v1.0.26 adds
--attachflag toopencode runand 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 ITAttach to an already-running OpenCode session instead of spawning a new one.$ opencode run --attach
- ›Adds
--attachflag toopencode runfor 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.
- ›Adds
- v1.0.25
OpenCode v1.0.25 adds
/exportand/copyTUI 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 ITExport the current session to a file or copy it to clipboard directly from the TUI.$ /exportReference 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
/exportand/copycommands to the TUI for sharing or extracting session content. - ›Enables
@agentreferences anywhere in a prompt, not just at the start. - ›Adds Clojure syntax highlighting support.
- ›Adds R language formatter support.
- ›Adds
- v1.0.24
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 formatas a formatter. - ›Adds GitHub Enterprise support for Copilot.
- v1.0.21
OpenCode v1.0.21 adds scoped npm plugin support,
/mcpalias, 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 ITQuickly check MCP server status using the new/mcpalias instead of/status.$ /mcp- ›Supports scoped npm packages as plugins (e.g.,
@org/plugin-name). - ›Adds
/mcpas an alias for the/statuscommand. - ›Honors the
disable_paste_summarysetting to suppress paste summaries.
- ›Supports scoped npm packages as plugins (e.g.,
- v1.0.20
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 ITReference 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.
- v1.0.19
OpenCode v1.0.19 adds a
statscommand 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 ITCheck your session usage statistics without leaving the terminal.$ opencode stats- ›New
statscommand displays usage statistics directly from the CLI.
- ›New
- v1.0.18
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.
- v1.0.16
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
dirsparameter to the file search API, enabling scoped file searches within specific directories. - ›Enhances task display to surface subagent type information.
- ›Adds optional
- v1.0.15
OpenCode v1.0.15 adds
/timelinecommand 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 ITJump to a specific point in a long session without scrolling through the entire history.$ /timeline- ›New
/timelinecommand lets you jump directly to specific messages within a session history.
- ›New
- v1.0.13
OpenCode v1.0.13 adds
/timelinecommand 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 ITJump to a specific earlier message in a long session without scrolling manually.$ /timeline- ›New
/timelinecommand lets you quickly navigate to specific messages within a session's history.
- ›New
- v1.0.9
OpenCode v1.0.9 adds
/exitcommand 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 ITExit the TUI cleanly from the command prompt instead of using a keyboard interrupt.$ /exitResume a previous session using the more intuitive/continuealias.$ /continue- ›Adds
/exitcommand (with aliases/quitand/q) to quit the TUI without reaching for Ctrl-C. - ›Adds
/summarizeas an alias for/compact,/clearas an alias for/new, and/resume//continueas aliases for/session. - ›Extends TUI autocomplete to recognise all new command aliases.
- ›Adds
- v1.0.8
OpenCode v1.0.8 adds
--promptCLI 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 ITKick off a coding session with a pre-filled prompt without typing it interactively.$ opencode --prompt "Refactor the auth module to use JWT tokens"
- ›Adds
--promptoption 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
/shareURL is copied to clipboard. - ›Makes
/inita default slash command on the server side.
- ›Adds
- v1.0.3
OpenCode v1.0.3 adds
/rename,/editor,/themecommands, 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 ITRename your current session to something meaningful without leaving the TUI.$ /rename my-investigation-sessionOpen the current context in your external editor mid-session for richer editing.$ /editorSwitch your UI theme interactively while working.$ /theme- ›New
/renamecommand lets you rename the current session from within the TUI. - ›New
/editorcommand (available in autocomplete) opens an external editor. - ›New
/themecommand for switching themes interactively. - ›Adds theme support in config, allowing themes to be set persistently.
- ›Allows Ctrl+D to exit the application.
+1 moreshow less
- ›Improved error boundary now includes a button to quickly create a GitHub issue.
└──▷ BREAKING ON UPGRADE- !The
setSelectedThemefunction is renamed tosetin the theme selection API — any tooling or scripts callingsetSelectedThemewill break. - !The
-halias is removed from TUI spawn and thread commands — scripts using-has a short flag for those commands will break.
- ›New
- v1.0.2
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.
- v1.0.0
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 ITUpgrade an existing OpenCode installation to 1.0 without waiting for auto-update.$ opencode upgrade 1.0.0Roll 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.
└──▷ BREAKING ON UPGRADE- !The
systemtheme has not been ported to the new TUI and is unavailable. - !Custom themes are not loaded in the new TUI.
- !Keybind
messages_revertis renamed tomessages_undo. - !Keybind
switch_agentis renamed toagent_cycle. - !Keybind
switch_agent_reverseis renamed toagent_cycle_reverse. - !Keybind
switch_modeis renamed toagent_cycle. - !Keybind
switch_mode_reverseis renamed toagent_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, andthinking_blockshave been removed.
- v0.15.30
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 ITPass custom authentication or routing headers to a model API endpoint without modifying the request pipeline.{ "model": { "headers": { "X-Custom-Auth": "my-token", "X-Routing-Key": "team-a" } } }- ›Adds optional
headersfield to model configuration, enabling custom HTTP headers for API requests.
- ›Adds optional
- v0.15.23
OpenCode v0.15.23 adds
--titleflag for named run sessions andOPENCODE_CONFIG_DIRfor 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 ITLabel 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
--titleflag toopencode runfor setting custom session titles. - ›Adds
OPENCODE_CONFIG_DIRenvironment variable to load configuration from a custom directory.
- ›Adds
- v0.15.19
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 ITTest 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.startedevent that triggers when a new session is created. - ›Adds
OPENCODE_FAKE_VCSflag for VCS testing.
- ›Adds MCP server support, file diffs, and default slash commands (
- v0.15.18
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
noReplyparameter to control whether a response is returned. - ›Enables disabling of provider timeout via the
timeoutparameter.
- ›Adds
- v0.15.17
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.
- v0.15.15
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
- ›Adds wildcard parsing support for flags in the bash tool, enabling broader glob-style argument matching.
- v0.15.14
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 moreshow less
- ›Improves editor detection with auto-discovery and better error messages.
- v0.15.11
OpenCode v0.15.11 adds
-f/--fileflag 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 ITRun a specific script or prompt file directly without interactive mode.$ opencode run -f <path>
- ›Adds
-f/--fileflag to theopencode runcommand to execute files directly.
- ›Adds
- v0.15.9
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
- ›Adds Astro language server support with automatic installation for .astro files
- v0.15.4
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 ITReconnect 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.import { createOpencode } from '@opencode/sdk'; const { server, client } = await createOpencode({ /* options */ });Launch the TUI programmatically from within another Node.js application or automation script.import { createOpencodeTui } from '@opencode/sdk'; await createOpencodeTui({ /* options */ });- ›Adds
--sessionoption to theattachcommand for connecting to a specific session. - ›Adds Slack integration package with Bolt framework support.
- ›Simplifies SDK setup with a single
createOpencodefunction 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 moreshow less
- ›Enables the
readtool to handle image files. - ›Adds
useCompletionUrlsoption 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.
- ›Adds
- v0.15.3
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 ITConnect to a specific existing session by name instead of the default session.$ opencode attach --session <session-id>
- ›Adds
sessionoption to theattachcommand, enabling connection to a specific named session. - ›New Slack integration package with Bolt framework support for building OpenCode-powered Slack bots.
- ›Exports
trimDifffunction from the edit tool, making it available as part of the public API.
- ›Adds
- v0.15.0
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
.opencodefolder.
- v0.14.7
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 ITInspect the fully resolved OpenCode config to verify provider keys, tool settings, and plugin hooks are loaded correctly.$ opencode debug configProgrammatically launch the TUI from a Node.js script — useful for embedding OpenCode in custom developer tooling or wrappers.import { createOpencodeTui } from 'opencode' await createOpencodeTui()- ›Adds Vertex AI support via
google-vertexandgoogle-vertex-anthropicproviders - ›Enables the
readtool to handle images, not just text files - ›New
--output-formatflag streams JSON output from commands - ›New
debug configcommand for inspecting resolved configuration - ›Adds session forking functionality and corresponding API endpoints
+10 moreshow less
- ›New
todo listAPI 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
createOpencodeServerfunction with readiness waiting and random port usage - ›Simplified JS SDK setup via single
createOpencodefunction;/clientand/serverimport 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/watcherfor improved cross-platform performance
- ›Adds Vertex AI support via
- v0.14.6
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 ITCheck which MCP servers are connected and their current status without leaving your workflow.$ curl http://localhost:<port>/mcp- ›New
GET /mcpendpoint 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.
- ›New
- v0.14.4
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.
- v0.14.3
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 ITInspect the resolved runtime configuration — useful for verifying provider settings or diagnosing unexpected behavior.$ opencode debug config- ›Adds
google-vertexandgoogle-vertex-anthropicproviders for Vertex AI support. - ›New
opencode debug configcommand outputs the current configuration as JSON for troubleshooting. - ›Introduces a simplified SDK initialization via a single
createOpencodefunction that creates both server and client automatically.
- ›Adds
- v0.13.6
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.
- v0.11.4
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.
- v0.11.2
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
- ›Adds Java LSP server support, enabling language server protocol features (completions, diagnostics, etc.) for Java projects.
- v0.10.0
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.
- v0.9.3
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.
- v0.9.1
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
- ›Adds a desktop/web app package, enabling OpenCode to be run as a desktop or web application.
- v0.8.0
OpenCode v0.8.0 adds autocompact control and a new
subtaskflag 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 ITPrevent 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_AUTOCOMPACTenvironment variable lets users disable automatic context compaction. - ›Autocompact is now automatically disabled when context size is set to 0.
- ›New
--subtaskflag on commands enables subagent-aware task execution. - ›Aborted messages are now retained in context instead of being discarded.
- ›New
- v0.7.3
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
- ›Adds experimental option to disable paste summaries when pasting content into the prompt
- v0.6.6
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
todowriteandtodoreadtools for Qwen models.
- v0.6.5
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
- ›Adds createOpencodeTui() function to the SDK for launching the OpenCode TUI programmatically from external scripts or tooling.
- v0.6.4
OpenCode v0.6.4 adds
OPENCODE_CONFIG_CONTENTenv 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 ITInject 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_CONTENTenvironment variable for supplying configuration content directly. - ›Adds API key generation capability.
- ›Supports
- v0.6.0
OpenCode v0.6.0 adds per-provider timeout overrides,
--commandflag forrun, LSP workspace config support, and a new project model replacingapp.└──▷ 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 ITRun a one-shot prompt with a specific slash command without entering the TUI.$ opencode run --command "/review" "Check this file for security issues"
- ›Adds
--commandflag toopencode runfor specifying a command directly at invocation. - ›Supports per-provider timeout overrides via a new provider timeout configuration.
- ›Adds LSP
workspace/didChangeConfigurationsupport, enabling dynamic LSP config updates. - ›Uses a single Rust LSP server instance across an entire Cargo workspace, improving multi-crate project performance.
- ›Introduces a
projectconcept (replacingapp) with new endpoints to list projects and get the current project.
+2 moreshow less
- ›Every API endpoint now accepts an optional
directoryparameter to operate as if OpenCode is running in that directory. - ›Plugins now receive
directory(cwd) andworktree(git repo root) context.
└──▷ BREAKING ON UPGRADE- !Storage events have been removed.
- !The
appconcept is gone; it is replaced byproject, with new endpoints for listing projects and getting the current project. - !The
session.chatfunction in the SDK has been renamed tosession.promptand no longer requiresmodelto be passed in (model is now an object). - !Plugins no longer receive the previous app-scoped context; they now receive
directory(cwd) andworktree(git repo root).
- ›Adds
- v0.5.29
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 moreshow 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.
- v0.5.28
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
- ›Adds opencode workflow support.
- v0.5.18
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.
- v0.5.15
OpenCode v0.5.15 adds slash commands,
createOpencodeServerJS SDK helper, and split@opencode-ai/sdk/server&/clientimports.└──▷ 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 ITProgrammatically start an OpenCode server in a Node.js script and wait until it is ready before issuing requests.import { createOpencodeServer } from '@opencode-ai/sdk/server' const server = await createOpencodeServer() // server is ready — make SDK calls hereImport only the client-side SDK in a browser or edge environment without bundling server-only code.import { OpenCodeClient } from '@opencode-ai/sdk/client'- ›Adds slash commands support in the CLI interface.
- ›Adds
createOpencodeServerto the JS SDK, including automatic readiness waiting and random port assignment foropencode serve. - ›Supports importing the JS SDK from
@opencode-ai/sdk/serverand@opencode-ai/sdk/clientas separate entry points. - ›Config hooks are now awaited, enabling async initialization logic.
└──▷ BREAKING ON UPGRADE- !
opencode servenow always uses a random port instead of a fixed port, which will break any hardcoded port references in scripts or clients.
- v0.5.13
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
- ›Adds a plugin hook for config, enabling plugins to tap into configuration loading
- v0.5.6
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.
- v0.5.5
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
- ›Retains cache when cycling between subagent and parent sessions, reducing redundant recomputation in the TUI.
- v0.5.3
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 ITTune scroll speed in the TUI for faster navigation through long outputs.# In your opencode config file: scroll_speed: 5
- ›Adds
scroll_speedconfiguration 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
.zshenvand respectsZDOTDIRwhen present.
- ›Adds
- v0.5.2
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
.vuefiles. - ›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-toastAPI endpoint for displaying toast notifications. - ›New API routes to get a session and its session children.
+2 moreshow less
- ›Enables navigation of child sessions (subagents) in the TUI.
- ›Improved queued visual indicator in the TUI.
- ›Adds Vue LSP support and enables ESLint for
- v0.4.44
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
- ›Converts attachments to text when deleted, keeping their content available in the conversation context.
- v0.4.43
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 ITRun 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.
- ›Adds bash command execution via
- v0.4.40
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.
- v0.4.27
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.
- v0.4.20
OpenCode v0.4.20 adds
-cand-sargs 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 ITPass 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
-cand-sflags to thetuicommand, aligning its interface with theruncommand pattern.
- ›Adds
- v0.4.19
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
- ›Adds toggle to show or hide tool details visibility in the interface.
- v0.4.17
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
modelskey optional in config.
- v0.4.15
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 ITQuickly 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.
- v0.4.5
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 moreshow less
- ›Supports passing additional agent options through to the provider.
- v0.4.2
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.
- v0.4.0
OpenCode v0.4.0 merges agents and modes into a single unified agent concept with tab-cycling and @
-mentionspawning.└──▷ 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 ITSwitch 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
agentconfig field — configure one concept instead of two. - ›Cycle through primary agents with
<tab>during a session. - ›Spawn a subagent inline by @
-mentioningit by name. - ›Agents with a
descriptionfield are automatically selected by the primary agent based on context. - ›Re-enables the todo tool for task tracking within sessions.
+1 moreshow less
- ›Loosens the todo tool schema to accept a wider range of input formats.
└──▷ BREAKING ON UPGRADE- !The
modeconfig field is deprecated and replaced byagent; existing configs usingmodewill need to be migrated to theagentfield.
- ›Unifies agent and mode into a single
- v0.3.132
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 ITDisable session snapshots when you want to skip snapshot overhead in automated or ephemeral environments.# In your opencode config file: snapshot: false
- ›Adds permissions disallow support to restrict what actions the assistant is allowed to perform.
- ›Introduces a
snapshotfield in config to disable session snapshots. - ›Improves assistant message visual presentation.
- v0.3.113
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
- ›Enables Kimi k2 ⇄ Claude trajectory handoff, allowing sessions to transfer context between Kimi k2 and Claude models.
- v0.3.112
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_pmodel parameter configurable. - ›Forces models.dev refresh automatically on auth login.
- v0.3.102
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.
- v0.3.90
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-refererheader support for Vercel AI Gateway requests.
- v0.3.82
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 ITPoint 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_CONFIGenvironment 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.
- ›New
- v0.3.81
OpenCode v0.3.81 adds
OPENCODE_CONFIGenv 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 ITPoint 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_CONFIGenvironment 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.
- ›Adds
- v0.3.80
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.
- v0.3.65
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.
- v0.3.61
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.
- v0.3.26
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
- ›Collapses the session header into a single line in the TUI when sharing is disabled, reducing UI clutter.
└──▷ BREAKING ON UPGRADE- !The
log levelconfig key has been removed from the configuration.
- v0.3.24
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.
- v0.3.18
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_BEDROCKenvironment 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.
- ›Supports
- v0.3.15
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.
- v0.3.12
OpenCode v0.3.12 adds
/exportcommand, 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 ITExport the current conversation to your editor for sharing or archiving.$ /export- ›New
/exportcommand 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.
- ›New
- v0.3.10
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.
- v0.3.7
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.
- v0.3.3
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.
- v0.3.2
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/disabledsharing config options for controlling session share behavior. - ›Expands ignore patterns in the
lstool to reduce noise from common non-source files.
- ›Adds
- v0.2.28
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
- ›New API endpoint for retrieving GitHub App tokens, enabling programmatic access to GitHub App authentication within OpenCode.
- v0.2.23
OpenCode v0.2.23 adds modes support, a
--modeCLI 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 ITRun 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
--modeflag on theopencode runcommand 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.
- v0.2.19
OpenCode v0.2.19 adds @symbol attachments, smarter
/editorbehavior, 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 ITUse/editorto 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
/editorauto-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.
- v0.2.14
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.
- v0.2.9
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.
- v0.2.6
OpenCode v0.2.6 adds
--model/--promptflags, 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 ITLaunch 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
--modeland--promptflags 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.
- ›Adds
- v0.1.192
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.
- v0.1.182
OpenCode v0.1.182 adds an
unsharecommand 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
- ›Adds
unsharecommand in the TUI to revoke sharing of a session or resource.
- ›Adds
- v0.1.177
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.
- v0.1.166
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.
- v0.1.158
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.
- v0.1.153
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.
- v0.1.146
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.
- v0.1.122
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.
- v0.1.120
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.
- v0.1.118
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.
- v0.1.113
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.
- v0.1.87
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.
└──▷ 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.
- ›Adds global config support at
- v0.1.61
OpenCode v0.1.61 restructures custom provider config with a new
npmfield 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
npmfield 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.
└──▷ BREAKING ON UPGRADE- !The config structure has changed: custom providers now require an
npmfield 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.
- ›Adds
- v0.0.52
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.
- ›Switches the default model to Claude Sonnet 4.
└──▷ 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
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 ITRun 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 moreshow less
- ›Supports pasting images directly into the prompt with Ctrl+V.
- v0.0.50
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
- ›Adds VertexAI provider support, enabling use of Google Cloud Vertex AI models.
- v0.0.49
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.
- v0.0.48
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.
- ›New completions module with a dialog UI and multiple providers, triggered by typing
- 0.0.45
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.