Skip to content

README.md

Latest commit

 

History

History
66 lines (47 loc) · 2.02 KB

README.md

File metadata and controls

66 lines (47 loc) · 2.02 KB

OpenCode ACP Control

Control OpenCode directly via the Agent Client Protocol (ACP).

This repository contains a reusable skill (.md-based instruction set) that enables AI coding agents to start, control, and monitor OpenCode sessions over the Agent Client Protocol (ACP).

What It Does

  • Start OpenCode in ACP mode
  • Create, resume, and cancel sessions
  • Send prompts and stream responses
  • Resume past conversations from saved session IDs
  • Check for and trigger OpenCode updates

Quick Start

# Clone
git clone https://github.com/berriosb/Opencode-Acp-Control.git
cd Opencode-Acp-Control

# Load as skill (Hermes Agent)
hermes skill install ./SKILL.md

# Or just copy SKILL.md to your agent's skills directory
cp SKILL.md ~/.hermes/profiles/<profile>/skills/

Requirements

  • OpenCode (≥ v1.1.0) — installed and available on $PATH
  • A terminal with background process support
  • An ACP-compatible agent (Hermes, Clawdbot, etc.)

How It Works

Step Action Description
1 opencode acp Start OpenCode in ACP (background) mode
2 initialize Initialize JSON-RPC 2.0 connection
3 session/new Create a new coding session
4 session/prompt Send prompts, stream responses
5 session/cancel Cancel mid-response if needed
6 session/load Resume a previous session by ID

Tool Requirements for AI Agents

This skill uses these agent tools (names vary by platform):

Generic Name Hermes Agent Clawdbot
Run command terminal() bash()
Write to process process.write() process.write()
Read process output process.poll() process.poll()
Kill process process.kill() process.kill()
Web fetch web_extract() webfetch()
User prompt clarify() askUser()

Files

  • SKILL.md — The skill definition (load this into your agent)
  • _meta.json — Registry metadata (Hermes)

License

MIT — see LICENSE.