# Send Opencode Acp Control to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "opencode-acp-control-2", "name": "Opencode Acp Control", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/studio-hakke/opencode-acp-control-2", "canonicalUrl": "https://clawhub.ai/studio-hakke/opencode-acp-control-2", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/opencode-acp-control-2", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=opencode-acp-control-2", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "_meta.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "opencode-acp-control-2", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-06T16:38:54.354Z", "expiresAt": "2026-05-13T16:38:54.354Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=opencode-acp-control-2", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=opencode-acp-control-2", "contentDisposition": "attachment; filename=\"opencode-acp-control-2-0.1.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "opencode-acp-control-2" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/opencode-acp-control-2" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/opencode-acp-control-2", "downloadUrl": "https://openagent3.xyz/downloads/opencode-acp-control-2", "agentUrl": "https://openagent3.xyz/skills/opencode-acp-control-2/agent", "manifestUrl": "https://openagent3.xyz/skills/opencode-acp-control-2/agent.json", "briefUrl": "https://openagent3.xyz/skills/opencode-acp-control-2/agent.md" } } ``` ## Documentation ### OpenCode ACP Skill Control OpenCode directly via the Agent Client Protocol (ACP). ### Metadata For ACP Protocol Docs (for Agents/LLMs): https://agentclientprotocol.com/llms.txt GitHub Repo: https://github.com/bjesuiter/opencode-acp-skill If you have issues with this skill, please open an issue ticket here: https://github.com/bjesuiter/opencode-acp-skill/issues ### Quick Reference ActionHowStart OpenCodebash(command: "opencode acp --cwd /path/to/project", background: true)Send messageprocess.write(sessionId, data: "\\n")Read responseprocess.poll(sessionId) - repeat every 2 secondsStop OpenCodeprocess.kill(sessionId)List sessionsbash(command: "opencode session list", workdir: "...")Resume sessionList sessions → ask user → session/loadCheck versionbash(command: "opencode --version") ### Starting OpenCode bash( command: "opencode acp --cwd /path/to/your/project", background: true, workdir: "/path/to/your/project" ) Save the returned sessionId - you'll need it for all subsequent commands. ### Protocol Basics All messages are JSON-RPC 2.0 format Messages are newline-delimited (end each with \\n) Maintain a message ID counter starting at 0 ### Step 1: Initialize Connection Send immediately after starting OpenCode: {"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{"fs":{"readTextFile":true,"writeTextFile":true},"terminal":true},"clientInfo":{"name":"clawdbot","title":"Clawdbot","version":"1.0.0"}}} Poll for response. Expect result.protocolVersion: 1. ### Step 2: Create Session {"jsonrpc":"2.0","id":1,"method":"session/new","params":{"cwd":"/path/to/project","mcpServers":[]}} Poll for response. Save result.sessionId (e.g., "sess_abc123"). ### Step 3: Send Prompts {"jsonrpc":"2.0","id":2,"method":"session/prompt","params":{"sessionId":"sess_abc123","prompt":[{"type":"text","text":"Your question here"}]}} Poll every 2 seconds. You'll receive: session/update notifications (streaming content) Final response with result.stopReason ### Step 4: Read Responses Each poll may return multiple lines. Parse each line as JSON: Notifications: method: "session/update" - collect these for the response Response: Has id matching your request - stop polling when stopReason appears ### Step 5: Cancel (if needed) {"jsonrpc":"2.0","method":"session/cancel","params":{"sessionId":"sess_abc123"}} No response expected - this is a notification. ### State to Track Per OpenCode instance, track: processSessionId - from bash tool (clawdbot's process ID) opencodeSessionId - from session/new response (OpenCode's session ID) messageId - increment for each request you send ### Polling Strategy Poll every 2 seconds Continue until you receive a response with stopReason Max wait: 5 minutes (150 polls) If no response, consider the operation timed out ### Common Stop Reasons stopReasonMeaningend_turnAgent finished respondingcancelledYou cancelled the promptmax_tokensToken limit reached ### Error Handling IssueSolutionEmpty poll responseKeep polling - agent is thinkingParse errorSkip malformed line, continueProcess exitedRestart OpenCodeNo response after 5minKill process, start fresh ### Example: Complete Interaction 1. bash(command: "opencode acp --cwd /home/user/myproject", background: true, workdir: "/home/user/myproject") -> processSessionId: "bg_42" 2. process.write(sessionId: "bg_42", data: '{"jsonrpc":"2.0","id":0,"method":"initialize",...}\\n') process.poll(sessionId: "bg_42") -> initialize response 3. process.write(sessionId: "bg_42", data: '{"jsonrpc":"2.0","id":1,"method":"session/new","params":{"cwd":"/home/user/myproject","mcpServers":[]}}\\n') process.poll(sessionId: "bg_42") -> opencodeSessionId: "sess_xyz789" 4. process.write(sessionId: "bg_42", data: '{"jsonrpc":"2.0","id":2,"method":"session/prompt","params":{"sessionId":"sess_xyz789","prompt":[{"type":"text","text":"List all TypeScript files"}]}}\\n') 5. process.poll(sessionId: "bg_42") every 2 sec until stopReason -> Collect all session/update content -> Final response: stopReason: "end_turn" 6. When done: process.kill(sessionId: "bg_42") ### Resume Session Resume a previous OpenCode session by letting the user choose from available sessions. ### Step 1: List Available Sessions bash(command: "opencode session list", workdir: "/path/to/project") Example output: ID Updated Messages ses_451cd8ae0ffegNQsh59nuM3VVy 2026-01-11 15:30 12 ses_451a89e63ffea2TQIpnDGtJBkS 2026-01-10 09:15 5 ses_4518e90d0ffeJIpOFI3t3Jd23Q 2026-01-09 14:22 8 ### Step 2: Ask User to Choose Present the list to the user and ask which session to resume: "Which session would you like to resume? 1. ses_451cd8ae... (12 messages, updated 2026-01-11) 2. ses_451a89e6... (5 messages, updated 2026-01-10) 3. ses_4518e90d... (8 messages, updated 2026-01-09) Enter session number or ID:" ### Step 3: Load Selected Session Once user responds (e.g., "1", "the first one", or "ses_451cd8ae..."): Start OpenCode ACP: bash(command: "opencode acp --cwd /path/to/project", background: true, workdir: "/path/to/project") Initialize: {"jsonrpc":"2.0","id":0,"method":"initialize","params":{...}} Load the session: {"jsonrpc":"2.0","id":1,"method":"session/load","params":{"sessionId":"ses_451cd8ae0ffegNQsh59nuM3VVy","cwd":"/path/to/project","mcpServers":[]}} Note: session/load requires cwd and mcpServers parameters. On load, OpenCode streams the full conversation history back to you. ### Resume Workflow Summary function resumeSession(workdir): # List available sessions output = bash("opencode session list", workdir: workdir) sessions = parseSessionList(output) if sessions.empty: notify("No previous sessions found. Starting fresh.") return createNewSession(workdir) # Ask user to choose choice = askUser("Which session to resume?", sessions) selectedId = matchUserChoice(choice, sessions) # Start OpenCode and load session process = bash("opencode acp --cwd " + workdir, background: true, workdir: workdir) initialize(process) session_load(process, selectedId, workdir, mcpServers: []) notify("Session resumed. Conversation history loaded.") return process ### Important Notes History replay: On load, all previous messages stream back Memory preserved: Agent remembers the full conversation Process independent: Sessions survive OpenCode restarts ### Updating OpenCode OpenCode auto-updates when restarted. Use this workflow to check and trigger updates. ### Step 1: Check Current Version bash(command: "opencode --version") Returns something like: opencode version 1.1.13 Extract the version number (e.g., 1.1.13). ### Step 2: Check Latest Version webfetch(url: "https://github.com/anomalyco/opencode/releases/latest", format: "text") The redirect URL contains the latest version tag: Redirects to: https://github.com/anomalyco/opencode/releases/tag/v1.2.0 Extract version from the URL path (e.g., 1.2.0) ### Step 3: Compare and Update If latest version > current version: Stop all running OpenCode processes: process.list() # Find all "opencode acp" processes process.kill(sessionId) # For each running instance Restart instances (OpenCode auto-downloads new binary on start): bash(command: "opencode acp --cwd /path/to/project", background: true, workdir: "/path/to/project") Re-initialize each instance (initialize + session/load for existing sessions) ### Step 4: Verify Update bash(command: "opencode --version") If version still doesn't match latest: Inform user: "OpenCode auto-update may have failed. Current: X.X.X, Latest: Y.Y.Y" Suggest manual update: curl -fsSL https://opencode.dev/install | bash ### Update Workflow Summary function updateOpenCode(): current = bash("opencode --version") # e.g., "1.1.13" latestPage = webfetch("https://github.com/anomalyco/opencode/releases/latest") latest = extractVersionFromRedirectUrl(latestPage) # e.g., "1.2.0" if semverCompare(latest, current) > 0: # Stop all instances for process in process.list(): if process.command.includes("opencode"): process.kill(process.sessionId) # Wait briefly for processes to terminate sleep(2 seconds) # Restart triggers auto-update bash("opencode acp", background: true) # Verify newVersion = bash("opencode --version") if newVersion != latest: notify("Auto-update may have failed. Manual update recommended.") else: notify("OpenCode is up to date: " + current) ### Important Notes Sessions persist: opencodeSessionId survives restarts — use session/load to recover Auto-update: OpenCode downloads new binary automatically on restart No data loss: Conversation history is preserved server-side ## Trust - Source: tencent - Verification: Indexed source record - Publisher: studio-hakke - Version: 0.1.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-06T16:38:54.354Z - Expires at: 2026-05-13T16:38:54.354Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/opencode-acp-control-2) - [Send to Agent page](https://openagent3.xyz/skills/opencode-acp-control-2/agent) - [JSON manifest](https://openagent3.xyz/skills/opencode-acp-control-2/agent.json) - [Markdown brief](https://openagent3.xyz/skills/opencode-acp-control-2/agent.md) - [Download page](https://openagent3.xyz/downloads/opencode-acp-control-2)