Six reference pages, each a single-purpose cheatsheet: - cli.md: full CLI surface (21 commands + global flags + experimental env vars) sourced from packages/web/src/content/docs/cli.mdx - slash-commands.md: every built-in TUI slash command verified against packages/web/src/content/docs/tui.mdx - permissions.md: all 17 permission keys verified against PermissionConfig in the JSON schema (read, edit, bash, glob, grep, list, task, todowrite, question, external_directory, repo_clone, repo_overview, webfetch, websearch, lsp, skill, doom_loop) - faq.md: covers free-vs-paid, OpenCode vs Claude Code, offline, model picks (multi-provider, not Anthropic-only), config locations, sharing, privacy, migration, troubleshooting - changelog.md: notable releases through v1.15.4 (verified via GitHub releases API, published 2026-05-17T17:44Z) - further-reading.md: curated external resources — only links that resolve (link-checked at commit time)
3.2 KiB
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.15.x — May 2026
Current stable line. Run opencode upgrade to get the latest.
Verified latest release: v1.15.4, published 2026-05-17 17:44 UTC (GitHub release).
Highlights:
- Agent Skills compatibility — discoverable workflows via
SKILL.mdfolders; compatible with Claude Code skill format. - Glob-pattern bash permissions — fine-grained
allow/ask/denyper command pattern, with most-specific wins. - 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.mdis canonical —CLAUDE.mdremains a fallback for migration (OPENCODE_DISABLE_CLAUDE_CODE=1disables it).
Earlier 2026
- Plugin event surface expanded —
session.idle,session.compacted,tui.toast.showand 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. toolsglob patterns — enable/disable groups of MCP tools./detailsand/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 viaopncd.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
CLAUDE.mdas a primary instructions file — useAGENTS.md. (Fallback still works; disable withOPENCODE_DISABLE_CLAUDE_CODE=1.)
Last reviewed: 2026-05-18 · For the authoritative list, see GitHub releases · Canonical docs: opencode.ai/docs.