opencode-plugin-cc
Multi-client companion plugin that delegates code review and rescue workflows to the local opencode CLI from Claude Code, Codex, and OpenCode.
What it does
- Delegates read-only code review of your local changes to
opencode (the plan agent).
- Runs an adversarial review for design-level scrutiny.
- Sends rescue/diagnosis tasks to
opencode, read-only by default; write tasks use the build agent.
- Manages background jobs (status, result, cancel) per workspace.
All work runs through your local opencode install, honoring your existing opencode auth and config.
How it differs from agy
This plugin mirrors the structure of agy-plugin-cc but targets the opencode CLI. Key adaptations:
| Concern | agy (Antigravity) | opencode |
|---|
| Read-only mode | --sandbox flag | --agent plan (no file modifications) |
| Write mode | drop --sandbox | --agent build (full read/write/execute) |
| One-shot prompt | --print <prompt> | run <prompt> |
| Resume | --continue / --conversation | --continue / --session <id> |
| Write gate | Antigravity trustedWorkspaces | optional OPENCODE_COMPANION_TRUSTED |
Requirements
- A working local
opencode executable in your PATH.
- At least one opencode provider configured (
opencode auth login).
- Node.js >= 18.
Install
Claude Code
claude plugin marketplace add udeope/opencode-plugin-cc
claude plugin install opencode@opencode-plugin-cc
For local development from a clone:
claude plugin marketplace add .
claude plugin install opencode@opencode-plugin-cc
Then verify:
/opencode:setup --auth-check
Commands
| Command | Description |
|---|
/opencode:setup | Check opencode availability and optional auth smoke test. |
/opencode:review | Read-only review of local changes (plan agent). |
/opencode:adversarial-review | Adversarial, design-focused review. |
/opencode:rescue | Delegate a rescue/diagnosis task (read-only by default; build agent for writes). |
/opencode:status | Show background job status. |
/opencode:result | Show saved output for a job id. |
/opencode:cancel | Cancel a running job. |
Read-only vs write
opencode has no --sandbox flag. Read-only work runs on the built-in plan agent (no file modifications). A rescue task runs on the build agent (full read/write/execute) when you pass --write or the task contains a write verb (fix, apply, edit, implement, refactor, create, delete, ...).
Optional write gate
Set OPENCODE_COMPANION_TRUSTED to a path-delimited list of directories to restrict writes to those workspaces:
export OPENCODE_COMPANION_TRUSTED="$HOME/projects/app:$HOME/work"
When unset, writes are unrestricted and opencode's own build permission model applies.
Background jobs
Pass --background to review, adversarial-review, or rescue to run without blocking.
Job metadata and logs are stored under a per-workspace directory
($OPENCODE_COMPANION_DATA, then $CLAUDE_PLUGIN_DATA, then the OS temp dir).
Other options
--base <ref> — include a diff against a base ref in the review context.--model <provider/model> — override the opencode model for a single run.--continue / --session <id> — resume an opencode session for iterative rescue.--json — request opencode's raw JSON event stream (--format json).
License
Apache-2.0
