| name | opencode |
| description | Use when the user types /opencode or asks to run opencode for an external review, research pass, or second opinion. Runs the opencode CLI non-interactively in the background and reports back its verdict. Defaults to a strong reasoning model and supports alternates on request. |
opencode — external pass
Summon a fresh opencode CLI run as an independent outside model for a review, research pass, or second opinion. Use when the user writes /opencode "..." or asks to involve opencode.
Prerequisites
opencode CLI installed (opencode --version).- The default below uses opencode's free
opencode/deepseek-v4-flash-free (the opencode Zen free tier) — no API key, just opencode auth login. Swap in any model you have configured — see Model selection.
Default command
Run from the relevant workspace root:
opencode run "<prompt>" --model "opencode/deepseek-v4-flash-free" > /tmp/opencode-<tag>.log 2>&1
- Pick a unique
<tag> per call (a short topic slug).
- opencode streams tool usage before its final verdict — the final answer is at the end of the log. Read the whole file but report the concluding verdict.
--dir <path> to root opencode elsewhere; --format json for machine-readable events.
Model selection
Run opencode models to list everything available to you, then pass --model "<provider>/<model>".
Free (opencode Zen — no API key):
opencode/deepseek-v4-flash-free — DeepSeek V4 Flash (the default)- alternatives:
opencode/nemotron-3-ultra-free, opencode/mimo-v2.5-free, opencode/north-mini-code-free
Premium (needs your own provider auth via opencode auth login) — stronger; the author's picks:
- DeepSeek:
--model "deepseek/deepseek-v4-pro" --variant "max"
- Kimi:
--model "moonshot/kimi-k2.7-code" --variant "max"
- Qwen:
--model "qwen/qwen3.6-plus" --variant "max"
--variant "max" only applies to providers that support variants — drop it for the free models.
Execution (background + wait)
The external model can take a while, so run it in the background and wait — don't block the turn:
- Claude Code: Bash tool with
run_in_background: true; you're re-invoked on exit, then read /tmp/opencode-<tag>.log.
- Other agents / plain shell: background it (
... &) and wait for exit, or run foreground with a generous timeout.
Don't treat partial streamed output as final — wait for the process to exit, then summarize the concluding answer.
Prompt shape
Include:
- repo/workspace path and current task context;
- whether the request is read-only or may edit files (default read-only unless the user explicitly asks opencode to implement changes);
- focus areas: correctness, regressions, tests, infra risk, production behavior, or the research questions;
- requested output shape: verdict, blocking issues, non-blocking issues, recommended fixes.
After it answers
Check important findings against local code before recommending changes. Summarize the verdict, noting where you agree or disagree.
