Update the guide to the current release (v1.16.2, 2026-06-05), verified
against opencode.ai/docs and github.com/anomalyco/opencode.
Correctness fixes:
- Plugins: tool.execute.before/after and shell.env are top-level hooks
with an (input, output) signature, not event.type values. Rewrite both
shipped example plugins plus the docs/migration examples so they fire.
- Permissions: bash glob maps resolve last-matching-rule-wins (catch-all
"*" first), not most-specific-wins. Fix prose, reorder examples, and fix
the shipped opencode.json (rm -rf* deny was shadowed by a later rm *).
- Drop non-existent permission keys repo_clone/repo_overview (15 keys, not
17); fix steps (integer), deprecate maxSteps/tools, move reasoningEffort
into model options; fix the `mise` install command.
Currency updates:
- v1.15.4 -> v1.16.2; add v1.16 highlights and a changelog section.
- Refresh OpenCode Zen lineup/pricing (Claude Opus 4.8, gpt-5.4,
gemini-3.5-flash, qwen3.7, grok-build-0.1; correct free-tier IDs).
- Add `opencode mcp add`, run --replay, extra skill paths, shift+tab, and
native GitHub commands; correct the specialist-prompt count; bump dates.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
markdownlint
- Disable MD028 (no-blanks-blockquote): we intentionally separate
adjacent blockquote callouts (a tip + a warning side-by-side) with
a blank line; visually this renders as two callouts, which is the
intent.
- Switch MD029 (ol-prefix) to "one_or_ordered": both "1. / 2. / 3."
and "1. / 1. / 1." (auto-renumber) are valid; the rule was hitting
ordered lists that have intervening code blocks, where the lint
loses count.
- Add blank lines before lists in five places where MD032 fired
(test.md, git-release/SKILL.md, agents.md, skills.md, migration.md).
- Fix nested code-fence bug in database-engineer-prompt.md: the
outer ``` was being closed by an inner ```sql; switched the outer
fence to ```` (4 backticks) so the inner one stays nested.
link-check
- Ignore https://mcp.grep.app and https://ai.google.dev/ — the first
returns 405 to HEAD requests (verified working via GET); the second
trips an infinite-redirect bug in the link checker (real URL works).
- Ignore github.com/anomalyco/opencode/discussions — the upstream
repo currently has discussions disabled.
- Add 405 to aliveStatusCodes for endpoints that accept GET but
reject HEAD.
- quickstart.md: 5-minute path from curl to first commit
- zen.md: model gateway with full lineup, pricing, BYOK, patterns
- tui.md: keybinds, leader chords, themes, customization, sessions
- agents.md: custom agents and subagents, full frontmatter, permission map
- commands.md: custom slash commands, placeholders, patterns, override rules
- skills.md: discoverable workflows, SKILL.md format, description-as-trigger
- plugins.md: lifecycle hooks, full event catalog, four real patterns
- mcp.md: local/remote MCP, OAuth (DCR), token budget, featured servers,
with mermaid N×M → N+M diagram
- migration.md: Claude Code, Cursor, Copilot, Aider — with "what X does
better" subsections so the comparisons aren't one-sided
- workflows.md: seven real recipes (TDD, bug investigation, multi-agent
review, cross-repo research, migrations, CI, visual iteration) — CI
example shows GitHub Actions + GitLab CI to avoid platform bias
Every model slug, permission key, config key, env var, and CLI flag
verified against the JSON schema or the live docs site.