opencode-acp-control

What problem does it solve?

OpenCode ACP control provides a direct, scriptable interface to manage OpenCode sessions, prompts, and updates without reliance on a GUI, enabling autonomous AI workflows.

Core Features & Use Cases

• Start OpenCode ACP sessions in the background and connect via JSON-RPC.
• Send prompts and stream responses in real time.
• Resume previous sessions and preserve full conversation history.
• Check OpenCode versions and trigger auto-update workflows.

Quick Start

Use the opencode-acp-control skill to initiate an ACP session and start interacting with OpenCode.

Start an OpenCode ACP process in the background:

• bash(command: "opencode acp --cwd /path/to/your/project", background: true, workdir: "/path/to/your/project")

Initialize the connection and create a session:

• process.write(sessionId: "bg_xxx", data: '{"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"}}}')
• process.write(sessionId: "bg_xxx", data: '{"jsonrpc":"2.0","id":1,"method":"session/new","params":{"cwd":"/path/to/your/project","mcpServers":[]}}')

Prompt example:

• process.write(sessionId: "bg_xxx", data: '{"jsonrpc":"2.0","id":2,"method":"session/prompt","params":{"sessionId":"sess_abc","prompt":[{"type":"text","text":"List files"}]}}')
• process.poll(sessionId: "bg_xxx") # poll every 2 seconds to stream updates

Stop when done:

• process.kill(sessionId: "bg_xxx")