OpenCode 2 Version Tracker: Environment Variables, Config & Features per Release#

Published September 26, 2026 by Alex Sorokoletov

OpenCode 2 is the ground-up TypeScript rewrite of OpenCode, published on npm as @opencode/cli since 2.0.0 on September 11, 2026, and developed on the repository's v2 branch while the 1.x line keeps shipping. Its tags carry no release notes, so each analysis attributes features and fixes to the release that added them, and checks behaviour against the OpenCode 2 docs, including the migration guide from 1.x.

Still on 1.x? The OpenCode Version Tracker covers the opencode-ai releases. Tracking the other agents too? See the Claude Code Version Tracker, Codex CLI Version Tracker, Gemini CLI Version Tracker, and Amp Version Tracker.

Version History#

v2.0.26 — October 8, 2026#

OPENCODE_RELEASE_NOTES · Vertex via gcloud ADC · secret remote subdomain · faster change tracking

v2.0.26 lets OpenCode authenticate to Google Vertex through local gcloud Application Default Credentials with no API key (#53798), and serves remote access on a randomly generated subdomain that it redacts and treats as secret (#53962). Clicking a wrapped link in the terminal transcript now opens it from any row, untracked-file diffs are batched instead of spawning git per file, and a new publish-pipeline variable, OPENCODE_RELEASE_NOTES, writes reviewed notes into a CHANGELOG.md the v2 tags had not carried before.

v2.0.25 — October 8, 2026#

Office file previews · Brotli-compressed web UI · QR pairing · between_tools thinking

v2.0.25 adds no new environment variables over v2.0.24 and puts its weight on the graphical surfaces and the server. The app previews Word, Excel and PowerPoint files, lists recently closed tabs and recent sessions, and reworks mobile navigation; the desktop browser bar was redesigned. The CLI embeds its browser UI as raw bytes and serves it brotli-compressed, pairing QR codes now encode every address, and the server streams fs.read with HTTP Range support. Core drops the prompt for directories outside the project by default, removes tool-name and namespace length caps, and stops sending API key metadata in the request body; providers gain between_tools thinking in Anthropic Messages and missing OpenAI and Google service tiers.

v2.0.24 — October 6, 2026#

Vercel AI Gateway · AI SDK v6 default · Azure catalog routing · Codex sign-in labels

v2.0.24 is a provider-and-interface release. Vercel AI Gateway becomes a native provider (#53432) with its language models in the catalog (#52643), the provider packages move to AI SDK v6 by default (#53287), and catalog fixes route completions-shaped Azure models through chat (#53395), exclude non-text models (#53295), and resolve GitLab Duo reasoning variants (#51082). OpenAI sign-in methods are relabeled Codex (#53467), and the terminal interface lists sessions awaiting input at the top of the open menu (#53435).

v2.0.23 — October 5, 2026#

native Cohere provider · ACP editor fixes · disable-model-invocation skill flag · no new env vars

v2.0.23 ships no new config surface and spends the release on provider breadth, the Agent Client Protocol, and reliability. A native Cohere chat provider joins the ai layer, and system-role text is now preserved for Gemini, Mistral, and Cohere requests. The ACP cluster (compaction reporting, out-of-band permission settling, remote image references, protocol docs) hardens running OpenCode inside Zed, JetBrains, and Neovim. Skill frontmatter adds disable-model-invocation to hide a skill from the model's advertised list while keeping it loadable by explicit ID.

v2.0.22 — October 2, 2026#

opencode acp · Plugin session API · Provider error classification · Azure discovery · No new env vars

v2.0.22 puts most of its feature work on the Agent Client Protocol: a session can span extra workspace directories, follows model and agent changes from other connected clients, and answers V2 forms by elicitation, with fixes to usage reporting, file-tool locations, and command delivery. Plugins can now remove a session, trigger compaction, and create a parent session. Provider failures across DeepInfra, Novita, Together, xAI, and Z.ai are classified as context overflow or authentication errors rather than generic failures, and a blocked response reports why. Azure deployment discovery and prompt caching for DigitalOcean widen provider coverage. No environment variables or experimental flags changed.

v2.0.21 — October 1, 2026#

Cloudflare AI Gateway passthroughs · OpenRouter prompt cache · Workers AI + Nova overflow · grouped session reads · ACP session catalog

v2.0.21 is a routing-and-interface release over v2.0.20. On the provider side, Cloudflare AI Gateway Claude and OpenAI requests take native passthroughs (#52222), OpenRouter Anthropic and Qwen requests carry prompt cache breakpoints (#52110), Workers AI and Amazon Nova over-limit responses are classified as context overflow (#52128, #52131), and GitHub Copilot Responses settings pass through (#52182). The session view groups adjacent file reads into one row, keeps the open group header sticky, and opens session IDs referenced in markdown (#52207, #52210, #52231); the desktop in-app browser can comment on page elements (#52217). The Agent Client Protocol server now follows server defaults and refreshes the session catalog (#52286). No env vars or experimental flags changed.

v2.0.20 — September 29, 2026#

opencode auth import · ChatGPT sign-in for OpenAI · owner-only database files · run survives a rejected permission

v2.0.20 adds auth export and auth import to move provider credentials as JSON to another machine, and a way to disable the background service. Signing in through ChatGPT registers a separate token-sharing OAuth method and uses those tokens for OpenAI models, backed by a usage-limit dialog and errors that explain token-sharing failures. Database files are restricted to their owner, denied permissions no longer stop a non-interactive run, and provider fixes surface raw error bodies and correct reasoning-block handling for Bedrock, Mistral, and Workers AI.

v2.0.19 — September 29, 2026#

OPENCODE_SESSION_ID · 256k output cap · context-window fit · ElevenLabs Scribe route · repo relative-path reject

v2.0.19 is a reliability and provider pass over v2.0.18. Output limits are fitted to the room the prompt leaves in the context window and capped at 256k tokens. The shell tool's environment is aligned with agent conventions and now sets OPENCODE_SESSION_ID on every command, so a script the agent launches can read the active session. Media routes add ElevenLabs Scribe transcription and better handling of truncated Gemini speech and transcription results, and repository host references reject relative path segments.

v2.0.18 — September 27, 2026#

OPENCODE_CLI_CONFIG_CONTENT · 2 env vars · Code Mode · media generation

v2.0.18 closes an eighteen-release week for OpenCode 2. Code Mode, where the model drives tools by writing JavaScript in a bounded interpreter, took the bulk of the work, gaining language built-ins, guardrails, and MCP tools and resources as callable Code Mode tools. Media generation landed beside it with image, video, speech, and transcription routes across Black Forest Labs, fal, Replicate, Stability, and AssemblyAI. Two env vars arrive: OPENCODE_CLI_CONFIG_CONTENT for inline config and OPENCODE_GITLAB_AUTH_CLIENT_ID for GitLab OAuth. New experimental keys add fs.write, WebSocket plugin hooks, MCP lifecycle control, session export and import, and an evaluation API.