Files
Wesam Abousaid a3f328c043 docs: refresh for OpenCode v1.17.13, add Go coverage, and rebrand
- Bump every version pin, pricing table, and model ID to the verified
  2026-07-05 state (v1.17.13): Claude Fable 5 / Sonnet 5 on Zen, new
  free tier, deprecation sunset table, v1.17.x changelog section
- Cover gaps: OpenCode Go vs Zen billing, Anthropic subscription-login
  removal (PR #18186), MCP resources, --mini mode, --auto flag, yolo mode
- Fix correctness bugs: command-template !`cmd` syntax in docs and
  .opencode/commands, protect-secrets regex missing 'cat .env', dual
  plugin exports, quickstart PATH fix, Playwright MCP flags, ctrl+d
  keybind conflict, agent/command required-field claims
- Fix links: cursor.com, windsurf.com, platform.claude.com,
  code.claude.com, opencode.ai/discord, Vercel Grep announcement
- Rebrand: banner (Images/banner.svg), 1280x640 social preview asset,
  hero redesign with star CTA, ecosystem stats, private vulnerability
  reporting channel, CI-matching local checks, MD060 lint opt-out
2026-07-05 14:11:51 +02:00

5.5 KiB
Raw Permalink Blame History

Changelog Highlights

Notable OpenCode releases. For the authoritative, complete list, see github.com/anomalyco/opencode/releases.

This document tracks what's new at a high level — the things that change how you use OpenCode. Bug fixes and small polish items aren't listed here.

v1.17.x — June–July 2026

Current stable line. Run opencode upgrade to get the latest.

Verified latest release: v1.17.13, published 2026-07-01 (GitHub release).

Highlights:

  • Session snapshots & revert (v1.17.11) — roll a session back to an earlier message, including file changes; plus desktop Chrome-style tabs (mod+1–9).
  • TUI yolo mode (v1.17.12) — auto-approve permissions from inside the TUI; plus adaptive thinking for Claude Sonnet 5.
  • --mini CLI mode, MCP resources, V2 plugin API (v1.17.10) — MCP resource template listing + resource read tools, MCP server instructions appended to session context, and a V2 plugin API (Effect and Promise plugins).
  • Agent steps limits honored (v1.17.9) — hitting the limit forces a final text response instead of failing mid-run.
  • cwd option for local MCP servers (v1.17.4) — plus connector-based auth and stored provider credentials.
  • Faster file search (fff-backed), WSL-backed Desktop on Windows, Cohere North models (v1.17.0) — plus non-interactive opencode mcp add.
  • reference config key renamed to references (v1.17.1) — the old key still loads; see Deprecations below.
  • Searchable v2 model picker in the desktop composer (v1.17.13) — plus session tab hover preview.

v1.16.x — June 2026

Latest: v1.16.2, published 2026-06-05 (GitHub release). The headline features shipped in v1.16.0 the same day.

Highlights:

  • File-based agent loading & skill discovery — drop-in agent markdown files and SKILL.md discovery are GA; scaffold an agent with opencode agent create.
  • Managed workspace cloning — clones keep dirty and untracked files intact.
  • Session mobility — move sessions between workspaces and directories.
  • opencode run --replay — interactive replay of a run as it streams.
  • OpenAI models via AWS Bedrock, plus GitHub Copilot token-based usage tracking.
  • ~38% faster startup, and a desktop app refresh (color themes, thinking-level selector, Servers tab, in-app updates).
  • GitHub extension now requires an existing git author identity before committing.

v1.15.x — May 2026

Latest: v1.15.4, published 2026-05-17 17:44 UTC (GitHub release).

Highlights:

  • Agent Skills compatibility — discoverable workflows via SKILL.md folders; compatible with Claude Code skill format.
  • Glob-pattern bash permissions — fine-grained allow/ask/deny per command pattern; rules match in order with the last match winning (list * first).
  • Managed configs — /Library/Application Support/opencode/ (macOS), /etc/opencode/ (Linux), %ProgramData%\opencode (Windows), plus macOS MDM preferences for enterprise rollouts.
  • ACP server (opencode acp) — Agent Client Protocol server for editor integrations.
  • Remote MCP with auto-OAuth — Dynamic Client Registration (RFC 7591) handled automatically.
  • Desktop app (beta) — macOS, Windows, Linux at opencode.ai/download.
  • AGENTS.md is canonical — CLAUDE.md remains a fallback for migration (OPENCODE_DISABLE_CLAUDE_CODE=1 disables it).

Earlier 2026

  • Plugin event surface expanded — session.idle, session.compacted, tui.toast.show and more.
  • opencode pr <num> — check out a GitHub PR branch and start a session in it.
  • opencode stats — per-day, per-model, per-project breakdowns.
  • TUI command palette (ctrl+p) — fuzzy-pick slash commands.
  • tools glob patterns — enable/disable groups of MCP tools.
  • /details and /thinking — toggle tool-output and thinking-block visibility from inside the TUI.

2025

Founding releases. Highlights from this period:

  • TUI launch — terminal UI as the primary interface.
  • MCP support — both local and remote servers.
  • Plugin system — JS/TS event-driven extensions.
  • OpenCode Zen — curated model gateway with pay-as-you-go billing.
  • /share — public conversation links via opncd.ai/s/<id>.
  • opencode serve / opencode web — headless and web-UI modes.

Coming soon (roadmap topics)

These are themes the OpenCode team has discussed publicly — not commitments to ship by a specific date.

  • Deeper IDE integrations via ACP
  • Expanded plugin event surface
  • More built-in agents and skills
  • Workspace sync across devices

For the current state, check the GitHub repo, the discussions, and opencode.ai/docs.


Deprecations

  • reference config key — renamed to references in v1.17.1. (The old key still loads.)
  • CLAUDE.md as a primary instructions file — use AGENTS.md. (Fallback still works; disable with OPENCODE_DISABLE_CLAUDE_CODE=1.)

Last reviewed: 2026-07-05 · For the authoritative list, see GitHub releases · Canonical docs: opencode.ai/docs.