mirror of
https://github.com/wesammustafa/opencode-primer.git
synced 2026-11-18 18:04:22 +00:00
- 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
95 lines
5.5 KiB
Markdown
95 lines
5.5 KiB
Markdown
# Changelog Highlights
|
||
|
||
> Notable OpenCode releases. For the authoritative, complete list, see [github.com/anomalyco/opencode/releases](https://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](https://github.com/anomalyco/opencode/releases/tag/v1.17.13)).
|
||
|
||
**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](https://github.com/anomalyco/opencode/releases/tag/v1.16.2)). 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](https://github.com/anomalyco/opencode/releases/tag/v1.15.4)).
|
||
|
||
**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](https://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](https://github.com/anomalyco/opencode), the [discussions](https://github.com/anomalyco/opencode/discussions), and [opencode.ai/docs](https://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](https://github.com/anomalyco/opencode/releases) · Canonical docs: [opencode.ai/docs](https://opencode.ai/docs/).*
|