invoke-opencode-acp

When to Use

• Triggers: >=2 file modifications / refactor / batch ops / code review / multi-step reasoning / git ops
• Avoid: single-file quick edits / recursive OpenCode calls

Core Intent

• Save tokens (50-90%) / main model decides / subagent executes details

Efficiency Priority

• acp_client.cjs (this dir) > manual protocol
• opencode acp > run/serve (avoid HTTP)

Constraints

• Default sandbox blocks writes to ~/.config/opencode and ~/.cache/opencode and blocks network
• First run plugin install ~30s; acp_client.cjs default SESSION_TIMEOUT=10s
• Fix: run acp_client.cjs outside sandbox to allow ~ writes and network; or install once then retry; or raise SESSION_TIMEOUT > 30s
• Evidence: ~/.local/share/opencode/log/*.log records bun add/install and duration

Workflow

1. Pick timeout: simple >=180s / medium >=600s / complex >=1800s
2. If first run or PermissionDenied/Timeout(10000ms) -> retry non-sandbox or install then retry
3. Run:

node ~/.claude/skills/invoke-opencode-acp/acp_client.cjs "$PWD" "task description" -o /tmp/output.txt -t 300

4. Listen session/update -> drop <thinking> -> result.stopReason === 'end_turn'
5. Return: OK / Timeout:{reason} / Error:{reason}

Protocol Notes

• initialize -> session/new(cwd,mcpServers:[]) -> session/prompt(prompt:[] shape)
• Error codes: -32001 not found / -32002 rejected / -32003 state / -32601 method / -32602 params

Dependencies

• Node.js
• OpenCode CLI: npm install -g opencode