OpenCode Version Tracker: Environment Variables, Config & Experimental Flags#

Published July 13, 2026 by Alex Sorokoletov

We analyze OpenCode releases to document the environment variables, config-schema keys, and experimental flags of each build. OpenCode, built by SST, is fully open source, so every finding links the release on GitHub and the official release notes, including the OPENCODE_EXPERIMENTAL_* flags that preview what's coming next. Each analysis names the two versions it compares.

On OpenCode 2? The OpenCode 2 Version Tracker covers the @opencode/cli rewrite. 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#

v1.19.0 — October 11, 2026#

opencode upgrade --major · Manual /update · PTY origin + ticket checks · Agent-readable stats

v1.19.0 turns major-version movement into a deliberate act: opencode upgrade --major is an opt-in door from the 1.x line into OpenCode 2, and the TUI no longer installs updates on its own, so /update does both jobs when you ask. The range also validates PTY connection origins and tickets before confirming a terminal exists, accepts OpenAI's ultrafast service tier, serves usage stats as agent-readable JSON and Markdown, and passes supported images through xAI tool results.

v1.18.34 — September 30, 2026#

0 env var changes · Developer ID-signed macOS builds · macOS 27+ compat · session identity headers

A maintenance point release over v1.18.33. Two of the three Core bugfixes cover macOS binary signing: release binaries now carry a Developer ID signature, and locally compiled binaries are re-signed so they run reliably on macOS 27 and newer. The third sends namespaced session and parent-session identity headers with model requests. A community fix corrects plugin-name extraction in the TUI /status dialog. No environment variables or experimental config keys changed.

v1.18.33 — September 28, 2026#

Bugfix release · 0 new env vars · debug output redacted · Cloudflare Gateway timeouts

v1.18.33 follows v1.18.32 with no environment-variable or experimental-flag changes and four fixes, three of them in the model-provider path. Debug configuration output now masks credentials and sensitive headers so a shared config dump stops leaking keys, Cloudflare AI Gateway models honor configured response and stream timeouts, MCP browser launch failures surface instead of failing silently, and Gemini thinking defaults and effort options match the controls each model generation supports.

v1.18.32 — September 26, 2026#

Provider retry resilience · Azure Entra ID sign-in · Cloudflare AI Gateway · 19 releases

v1.18.32 closes a nineteen-release run since v1.18.13 spent on provider reliability rather than new features. The agent loop now retries more network and mid-stream errors, caps retries with jitter to avoid storms, and defaults provider-header and streamed-chunk timeouts to five minutes so slow model startups stop failing early; failed subagent calls come back with a resumable task_id. Provider reach widened too: Azure sign-in through the Azure CLI with Microsoft Entra ID, native OpenAI and Anthropic passthroughs for Cloudflare AI Gateway, and a simplified single device-code xAI login for headless use.

v1.18.13 — August 4, 2026#

OPENCODE_SIDECAR_V2 · 1 new env var · subagent_depth · 15 releases

The window from v1.17.19 to v1.18.13 is a desktop-heavy one: 15 releases finished the Desktop v2 migration, and the single new env var, OPENCODE_SIDECAR_V2, toggles the app onto its new bundled-CLI backend while the old one keeps shipping alongside it. The harness change worth noting is subagent_depth, a config cap (default 1) that stops subagents from spawning nested subagents by default. Right-to-left layout and expanded localization point the desktop client at a broad, non-English audience, a bet the terminal-first closed harnesses are not making.

v1.17.19 — July 14, 2026#

120 env vars · 20 experimental flags · baseline snapshot

The first tracked OpenCode build. 120 OPENCODE_ env vars and 20 experimental flags map a server-first, provider-agnostic agent with a hosted console, workspaces, and a session-moving control plane growing around the open-source core. The baseline every later post diffs against.