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>
This repo doubles as a fully-configured OpenCode project so readers can
see real files instead of abstract format docs.
Agents (.opencode/agents/, OpenCode YAML + markdown body):
- code-reviewer.md — read-only subagent, glob-gated bash perms,
Severity/Where/Why/Fix output format. Rewrites the pre-refactor file
which used incorrect frontmatter shape (no YAML, claude-sonnet-4.6
as bare ID, made-up tool keys).
- security-auditor.md — OWASP-focused review subagent, deny edit,
ask bash, CWE-aware output template.
Commands (.opencode/commands/):
- review.md, pr.md, test.md, optimize.md — uses real placeholders
($ARGUMENTS, @file, !shell), points the right agent at each task.
Plugins (.opencode/plugins/):
- protect-secrets.js — blocks tool calls touching .env*, secrets/,
credentials*, SSH keys, .npmrc, .pypirc. Pure JS, no deps.
- audit-log.js — appends one JSON line per successful tool call to
.opencode/audit.jsonl (also added to .gitignore).
- README.md — how to install/disable, sample audit-log line, link to
docs/plugins.md.
Skills (.opencode/skills/git-release/SKILL.md):
- Proper folder-with-SKILL.md format. Trigger-shaped description so the
model actually loads it when the conversation touches release prep.