← Back to Skills Marketplace
OpenCode ACP Control v2
by
Bastian Berrios Alarcon
· GitHub ↗
· v2.2.1
372
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install opencode-acp-control-v2
Description
Control OpenCode directly via the Agent Client Protocol (ACP). Start sessions, send prompts, resume conversations, and manage OpenCode updates. Includes auto...
Usage Guidance
This skill appears to implement what it promises (starting and managing a local OpenCode ACP session), but there are a few red flags you should check before installing:
- The metadata declares no required binaries, but the script and docs require an 'opencode' binary and the 'jq' tool; ensure those are present and trusted on your system.
- The included script will delete lock files under ~/.openclaw/agents and may kill processes; this is intended for cleanup but can affect other agents or sessions on the same host—backup important state and understand the command scope before running.
- There is no homepage or verified source; the author/email in SKILL.md and a GitHub URL are present in docs but the registry 'source' is unknown. Prefer installing only from a verified repository or after manual inspection of the script.
- If you plan to integrate with external MCPs (Supabase/GitHub), the skill mentions them but does not request credentials—you will need to supply and protect any required tokens separately.
If you want higher confidence: verify the opencode binary you will use (origin, checksums), ensure jq is installed from a trusted package manager, and manually review the opencode-session.sh contents (especially the find/rm commands) to confirm the cleanup logic matches your expectations.
Capability Analysis
Type: OpenClaw Skill
Name: opencode-acp-control-v2
Version: 2.2.1
The skill bundle provides a framework for controlling the OpenCode Agent Client Protocol (ACP), which requires high-risk capabilities including background process execution and shell-based file manipulation. Specifically, SKILL.md and opencode-session.sh instruct the agent to execute shell commands like 'rm -f' and 'find' to manage lock files in the ~/.openclaw directory. While these actions are plausibly necessary for the stated purpose of session recovery and management, the reliance on broad shell execution and the instruction for the AI to manage its own process lifecycle constitute a significant attack surface without robust input sanitization.
Capability Assessment
Purpose & Capability
The skill claims to control OpenCode via ACP, and its instructions and included script do exactly that. However the registry metadata says "required binaries: none" while SKILL.md and opencode-session.sh clearly rely on an installed 'opencode' binary and the script uses 'jq' and standard shell tools; this mismatch is incoherent and could confuse users about what needs to be present.
Instruction Scope
Runtime instructions focus on starting OpenCode, sending JSON-RPC, polling, and recovering stuck processes—consistent with the stated purpose. They also instruct deleting lock files (find/rm on ~/.openclaw/agents) and killing processes; these are powerful but relevant to session cleanup. There are no instructions to access or exfiltrate unrelated files or network endpoints.
Install Mechanism
This is an instruction-only skill with an included helper script (no network downloads or installers). That minimizes install-time risk.
Credentials
The skill does not request environment variables or credentials. The config file is local and optional. The absence of requested secrets is proportionate to the described functionality.
Persistence & Privilege
The skill does not force permanent inclusion (always:false) and doesn’t modify other skills. However, it performs global cleanup operations under ~/.openclaw/agents (deleting lock files across agents), which could affect other agent sessions on the same host—this is a privileged filesystem operation within the OpenClaw area and worth reviewing for unintended side effects.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install opencode-acp-control-v2 - After installation, invoke the skill by name or use
/opencode-acp-control-v2 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.2.1
v2.2.1: Added opencode-session.sh helper script with auto-retry, adaptive polling
v2.2.0
v2.2.0: Added opencode-session.sh helper script for automatic workflow with retry, adaptive polling, cleanup
v2.1.0
Improved version with auto-retry, stuck detection, adaptive polling, config file, templates
Metadata
Frequently Asked Questions
What is OpenCode ACP Control v2?
Control OpenCode directly via the Agent Client Protocol (ACP). Start sessions, send prompts, resume conversations, and manage OpenCode updates. Includes auto... It is an AI Agent Skill for Claude Code / OpenClaw, with 372 downloads so far.
How do I install OpenCode ACP Control v2?
Run "/install opencode-acp-control-v2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenCode ACP Control v2 free?
Yes, OpenCode ACP Control v2 is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OpenCode ACP Control v2 support?
OpenCode ACP Control v2 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenCode ACP Control v2?
It is built and maintained by Bastian Berrios Alarcon (@studio-hakke); the current version is v2.2.1.
More Skills