{"id":"7a7aa62f-8b3e-4959-8f46-2f1d904599d0","entityType":"agent","slug":"clawhub-skills-ailois-opencode-acp","name":"opencode-acp","canonicalUrl":"https://www.xpersona.co/agent/clawhub-skills-ailois-opencode-acp","canonicalPath":"/agent/clawhub-skills-ailois-opencode-acp","generatedAt":"2026-10-09T12:40:04.600Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"Collaborate with OpenCode via ACP protocol for code modifications, refactoring, and feature implementation. --- name: opencode-acp description: Collaborate with OpenCode via ACP protocol for code modifications, refactoring, and feature implementation. metadata: { \"openclaw\": { \"emoji\": \"🔧\", \"requires\": { \"anyBins\": [\"opencode\"] } }, } --- OpenCode ACP Collaboration Use OpenCode via ACP (Agent Client Protocol) for code modifications, refactoring, and feature implementation. Quick Start Automated Workflow (Recommended) Use","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"clawhub skill install skills:ailois:opencode-acp","sourceUrl":"https://github.com/openclaw/skills/tree/main/skills/ailois/opencode-acp","homepage":null,"primaryLinks":[{"label":"View on ClawHub","url":"https://github.com/openclaw/skills/tree/main/skills/ailois/opencode-acp","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":50,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Collaborate with OpenCode via ACP protocol for code modifications, refactoring, and feature implementation. --- name: opencode-acp description: Collaborate with"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"other","status":"self-declared"},{"label":"delegate","status":"self-declared"},{"label":"use","status":"self-declared"},{"label":"coordinate","status":"self-declared"},{"label":"both","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":6,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"other","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"delegate","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"use","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"coordinate","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"both","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:other|supported|profile capability:delegate|supported|profile capability:use|supported|profile capability:coordinate|supported|profile capability:both|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No source adoption metrics were available."},"stars":null,"forks":null,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-25T05:57:04.750Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-25T05:57:04.750Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-26T05:57:04.750Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install skills:ailois:opencode-acp","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T12:40:04.600Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-ailois-opencode-acp/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"---\nname: opencode-acp\ndescription: Collaborate with OpenCode via ACP protocol for code modifications, refactoring, and feature implementation.\nmetadata:\n  {\n    \"openclaw\": { \"emoji\": \"🔧\", \"requires\": { \"anyBins\": [\"opencode\"] } },\n  }\n---\n\n# OpenCode ACP Collaboration\n\nUse OpenCode via ACP (Agent Client Protocol) for code modifications, refactoring, and feature implementation.\n\n## Quick Start\n\n### Automated Workflow (Recommended)\n\nUse the provided Python script for automated OpenCode collaboration:\n\n> On first run, the skill auto-creates a local `.venv` (Python 3.9+) in this skill directory and re-runs inside that environment.\n> If the current interpreter is below 3.9, it auto-discovers a local Python 3.9+ executable (`python3.12`/`python3.11`/`python3.10`/`python3.9`/`python3`/`python`; on Windows also `py -3.x`).\n\n```bash\n# Run from this repository root\n# Simple task\npython opencode_acp_client.py \\\n  --project /path/to/project \\\n  --task \"Add --version flag to CLI\"\n\n# With verbose logging\npython opencode_acp_client.py \\\n  --project /path/to/project \\\n  --task \"Refactor authentication module\" \\\n  --verbose\n\n# With custom timeout (default: 600 seconds)\npython opencode_acp_client.py \\\n  --project /path/to/project \\\n  --task \"Build REST API for todos\" \\\n  --timeout 1200\n```\n\n**What it does:**\n1. Starts OpenCode ACP server\n2. Initializes ACP connection\n3. Creates session\n4. Sends task\n5. Monitors progress and displays output\n6. Stops OpenCode when done\n\n**Output:**\n- Real-time progress updates\n- Tool calls and status\n- Agent messages\n- Completion status\n\n### Manual Workflow (Advanced)\n\nFor fine-grained control, use manual JSON-RPC messages:\n\n```bash\n# Start OpenCode ACP server in background\nexec pty:true workdir:/path/to/project background:true command:\"opencode acp\"\n# Returns sessionId (e.g., \"neat-zephyr\")\n\n# Initialize connection\nprocess action:write sessionId:neat-zephyr data:'{\"jsonrpc\":\"2.0\",\"id\":0,\"method\":\"initialize\",\"params\":{\"protocolVersion\":1,\"clientCapabilities\":{\"fs\":{\"readTextFile\":true,\"writeTextFile\":true},\"terminal\":true},\"clientInfo\":{\"name\":\"Claw\",\"title\":\"Claw AI Assistant\",\"version\":\"1.0.0\"}}}\\n'\n\n# Wait for response\nprocess action:log sessionId:neat-zephyr\n\n# Create session\nprocess action:write sessionId:neat-zephyr data:'{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"session/new\",\"params\":{\"cwd\":\"/path/to/project\",\"mcpServers\":[]}}\\n'\n\n# Wait for session ID\nprocess action:log sessionId:neat-zephyr\n\n# Send task\nprocess action:write sessionId:neat-zephyr data:'{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"session/prompt\",\"params\":{\"sessionId\":\"ses_xxx\",\"prompt\":[{\"type\":\"text\",\"text\":\"Your task here\"}]}}\\n'\n\n# Monitor progress\nprocess action:log sessionId:neat-zephyr\n\n# Kill when done\nprocess action:kill sessionId:neat-zephyr\n```\n\n## The Pattern: Plan → Execute → Verify\n\n### Step 1: Analyze Requirements\n\n**Your job (as planner):**\n- Understand user needs\n- Identify technical constraints\n- Assess impact and risks\n\n**Output:**\n- Clear, specific requirements\n- Technical constraints\n- Risk assessment\n\n### Step 2: Create Plan\n\n**Your job (as planner):**\n- Break down into executable steps\n- Define acceptance criteria\n- Provide implementation guidance\n\n**Format:**\n```markdown\n# Task: [Task Name]\n\n## Objective\n[Goal description]\n\n## Requirements\n1. [Requirement 1]\n2. [Requirement 2]\n...\n\n## Acceptance Criteria\n- ✅ [Criterion 1]\n- ✅ [Criterion 2]\n...\n\n## Implementation Guidance\n1. [Step 1]\n2. [Step 2]\n...\n\n## Verification\n[How to verify]\n```\n\n### Step 3: Execute with OpenCode\n\n**Start OpenCode ACP server:**\n```bash\nexec pty:true workdir:/path/to/project background:true command:\"opencode acp\"\n```\n\n**Initialize connection:**\n```json\n{\"jsonrpc\":\"2.0\",\"id\":0,\"method\":\"initialize\",\"params\":{\"protocolVersion\":1,\"clientCapabilities\":{\"fs\":{\"readTextFile\":true,\"writeTextFile\":true},\"terminal\":true},\"clientInfo\":{\"name\":\"Claw\",\"title\":\"Claw AI Assistant\",\"version\":\"1.0.0\"}}}\n```\n\n**Create session:**\n```json\n{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"session/new\",\"params\":{\"cwd\":\"/path/to/project\",\"mcpServers\":[]}}\n```\n\n**Send task:**\n```json\n{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"session/prompt\",\"params\":{\"sessionId\":\"ses_xxx\",\"prompt\":[{\"type\":\"text\",\"text\":\"[Your plan from Step 2]\"}]}}\n```\n\n### Step 4: Monitor Progress\n\n**Poll for updates:**\n```bash\nprocess action:log sessionId:neat-zephyr\n```\n\n**Key update types:**\n- `agent_thought_chunk` - OpenCode's thinking process\n- `tool_call` - Tool invocations (search, analyze, edit)\n- `plan` - Task plan updates\n- `stopReason` - Task completion signal\n\n**Stop conditions:**\n- `stopReason: \"end_turn\"` - Normal completion\n- `stopReason: \"cancelled\"` - Task cancelled\n- Timeout (suggest: 5-10 minutes)\n\n### Step 5: Verify Results\n\n**Verification checklist:**\n- ✅ Code changes match requirements\n- ✅ Acceptance criteria met\n- ✅ Code style consistent\n- ✅ Tests pass\n- ✅ No regressions\n\n**Verification methods:**\n1. Review OpenCode's change summary\n2. Run relevant tests\n3. Manual verification of key features\n4. Code quality check\n\n### Step 6: Cleanup\n\n**Stop OpenCode:**\n```bash\nprocess action:kill sessionId:neat-zephyr\n```\n\n**Record results:**\n- Update memory/YYYY-MM-DD.md\n- Record success/failure reasons\n- Document lessons learned\n\n## ⚠️ First-Time Project Setup\n\nIf this is OpenCode's first time working on a project, initialize the knowledge base first:\n\n1. **Start OpenCode TUI** (not acp mode):\n   ```bash\n   cd /path/to/project\n   opencode\n   ```\n\n2. **Run initialization**:\n   ```\n   /init-deep\n   ```\n\n3. **Wait for completion**:\n   - OpenCode creates hierarchical AGENTS.md knowledge base\n   - Analyzes project structure and code\n   - Builds project context\n\n4. **Exit and restart in acp mode**:\n   - After initialization, exit TUI\n   - Restart with `opencode acp` for collaboration\n\n**Why init-deep?**\n- Helps OpenCode understand project structure\n- Builds code knowledge graph\n- Improves execution efficiency and accuracy\n- Reduces unnecessary exploration and trial-and-error\n\n## OpenCode Configuration\n\n**Location:** `/root/.opencode/opencode.json`\n\n**Recommended mode:** `sisyphus` (AI orchestrator)\n\n## ACP Protocol Details\n\n**Protocol version:** 1\n\n**Transport format:** JSON-RPC 2.0\n\n**Message delimiter:** Newline (\\n)\n\n**Communication:** stdin/stdout\n\n## Available OpenCode Modes\n\n- **sisyphus** (recommended): Powerful AI orchestrator, excels at planning and delegation\n- **hephaestus**: Autonomous deep worker, end-to-end task completion\n- **prometheus**: Planning agent\n- **atlas**: Task orchestrator\n\n## Best Practices\n\n### 1. Clear Requirements\n\n**Good:**\n```markdown\n# Task: Add Version Command\n\n## Objective\nAdd --version flag to display project version from package.json\n\n## Requirements\n1. Support both --version and -v\n2. Display format: \"QMD Memory v1.0.0\\nOpenClaw memory plugin\"\n3. Exit after displaying version\n\n## Acceptance Criteria\n- ✅ `bun src/qmd.ts --version` works\n- ✅ Version matches package.json\n- ✅ No impact on existing commands\n```\n\n**Bad:**\n```markdown\nAdd version command\n```\n\n### 2. Acceptance Criteria\n\n**Good criteria:**\n- Specific, measurable, verifiable\n- Include positive and negative tests\n- Consider edge cases\n\n**Example:**\n- ✅ Run `command --version` displays correct version\n- ✅ Run `command -v` displays same result\n- ✅ Version matches package.json\n- ✅ Exit code is 0\n- ✅ No impact on other commands\n\n### 3. Progress Monitoring\n\n**Key metrics:**\n- Task breakdown count (typically 3-7 subtasks)\n- Background agents count (typically 2-4)\n- Tool call count (search, analyze, edit)\n- Execution time (typically 2-10 minutes)\n\n**Warning signs:**\n- Long silence (> 2 minutes)\n- Repeated error messages\n- Tool call failures\n- Timeout\n\n### 4. Error Handling\n\n**Common errors:**\n1. **GLIBC version issues**: Some tools (like ast_grep) may be incompatible\n   - Solution: OpenCode auto-switches to other tools\n2. **Agent not found**: e.g., \"librarian\" agent unavailable\n   - Solution: OpenCode uses other agents\n3. **Timeout**: Task execution too long\n   - Solution: Break into smaller tasks or increase timeout\n\n## Collaboration Principles\n\n### Planner's Responsibilities\n\n1. **Clear requirements**:\n   - Specific, measurable, verifiable\n   - Include context and constraints\n   - Provide examples and references\n\n2. **Reasonable plan**:\n   - Break into small steps\n   - Consider technical feasibility\n   - Estimate workload\n\n3. **Effective verification**:\n   - Clear acceptance criteria\n   - Executable verification methods\n   - Timely feedback\n\n### Executor's Characteristics (OpenCode)\n\n1. **Automatic planning**:\n   - Break requirements into subtasks\n   - Auto-select tools and methods\n   - Parallel execution of multiple tasks\n\n2. **Intelligent execution**:\n   - Use sisyphus mode (AI orchestrator)\n   - Launch background explore agents\n   - Auto-search and analyze code\n\n3. **Continuous feedback**:\n   - Real-time progress reports\n   - Show thinking process\n   - Provide execution summary\n\n## Real-World Example\n\n### Case: Add Version Command to QMD\n\n**Requirement:** Add `--version` command-line option\n\n**Planner's work:**\n1. Analyze requirement: Need to read package.json version, display project info\n2. Create plan:\n   - Locate CLI argument parsing logic\n   - Add version flag handling\n   - Implement version info output\n   - Add tests\n3. Set acceptance criteria:\n   - `bun src/qmd.ts --version` displays correct version\n   - `-v` alias works\n   - Version matches package.json\n   - No impact on existing features\n\n**OpenCode's work:**\n1. Auto-break into 5 subtasks\n2. Launch 3 explore agents in parallel\n3. Search code structure (parseCLI, version info, tests)\n4. Implement code changes\n5. Run tests for verification\n\n**Result:**\n- ✅ Collaboration mode verified successfully\n- ✅ OpenCode auto-plans and executes\n- ✅ Parallel processing improves efficiency\n- ✅ Real-time progress feedback\n\n## Common Questions\n\n### Q1: What to do for first-time project?\n\n**A:**\nFirst-time project must initialize knowledge base:\n\n1. Start OpenCode TUI:\n   ```bash\n   cd /path/to/project\n   opencode\n   ```\n\n2. Run initialization:\n   ```\n   /init-deep\n   ```\n\n3. Exit after completion, then use acp mode for collaboration\n\n**Purpose:**\n- Create hierarchical AGENTS.md knowledge base\n- Analyze project structure and dependencies\n- Build code context, improve execution efficiency\n\n### Q2: How to choose OpenCode mode?\n\n**A:**\n- **sisyphus** (default): Suitable for most tasks, auto-planning and parallel execution\n- **hephaestus**: Suitable for complex tasks requiring deep analysis\n- **prometheus**: Suitable for planning-only scenarios, no execution needed\n\n### Q3: How to handle OpenCode execution failure?\n\n**A:**\n1. Check error messages and logs\n2. Analyze failure reason (unclear requirements? technical limitations?)\n3. Adjust plan or requirements\n4. Restart OpenCode\n5. If multiple failures, consider manual implementation\n\n### Q4: How to optimize collaboration efficiency?\n\n**A:**\n1. **Clear requirements**: Reduce OpenCode's guessing and trial-and-error\n2. **Reasonable breakdown**: Break large tasks into small tasks\n3. **Parallel execution**: OpenCode auto-parallelizes\n4. **Timely feedback**: Monitor progress, adjust promptly\n\n### Q5: How can other Agents use this workflow?\n\n**A:**\n- **Butler Agent**: When making long-term plans, can delegate code modification tasks to OpenCode\n- **Challenger Agent**: When finding optimization opportunities, can use OpenCode for quick implementation\n- **Main Agent**: When receiving user requirements, can coordinate OpenCode execution\n\nAll Agents follow the same workflow: analyze requirements → create plan → start OpenCode → monitor progress → verify results.\n\n## Rules\n\n1. **Always use pty:true** - OpenCode needs a terminal\n2. **Initialize first-time projects** - Run `/init-deep` before first use\n3. **Clear requirements** - Specific, measurable, verifiable\n4. **Monitor progress** - Check logs regularly, don't just wait\n5. **Verify results** - Always check acceptance criteria\n6. **Record lessons** - Update memory with successes and failures\n7. **Be patient** - Don't kill sessions prematurely\n8. **Use process:log** - Check progress without interfering\n\n## Progress Updates\n\nWhen spawning OpenCode in background, keep user informed:\n\n- Send 1 short message when starting (what's running + where)\n- Update only when something changes:\n  - Milestone completes (build finished, tests passed)\n  - OpenCode asks a question / needs input\n  - Error occurs or user action needed\n  - OpenCode finishes (include what changed + where)\n- If killing session, immediately say why\n\nThis prevents \"Agent failed before reply\" confusion.\n\n## Auto-Notify on Completion\n\nFor long-running tasks, append wake trigger to prompt:\n\n```\n... your task here.\n\nWhen completely finished, run this command to notify me:\nopenclaw system event --text \"Done: [brief summary]\" --mode now\n```\n\n**Example:**\n\n```bash\nexec pty:true workdir:~/project background:true command:\"opencode acp\"\n# ... initialize, create session ...\n# Send prompt with wake trigger:\n{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"session/prompt\",\"params\":{\"sessionId\":\"ses_xxx\",\"prompt\":[{\"type\":\"text\",\"text\":\"Build a REST API for todos.\\n\\nWhen completely finished, run: openclaw system event --text \\\"Done: Built todos REST API with CRUD endpoints\\\" --mode now\"}]}}\n```\n\nThis triggers immediate wake event — you get notified in seconds, not minutes.\n\n## Version History\n\n- **v1.0** (2026-02-16): Initial version\n  - OpenCode 1.2.1\n  - ACP protocol version 1\n  - sisyphus mode\n  - Test project: openclaw-qmd\n\n---\n\n**Last updated:** 2026-02-16  \n**Maintainer:** Claw 🐾  \n**Status:** ✅ Verified\n","readmeExcerpt":"--- name: opencode-acp description: Collaborate with OpenCode via ACP protocol for code modifications, refactoring, and feature implementation. metadata: { \"openclaw\": { \"emoji\": \"🔧\", \"requires\": { \"anyBins\": [\"opencode\"] } }, } --- OpenCode ACP Collaboration Use OpenCode via ACP (Agent Client Protocol) for code modifications, refactoring, and feature implementation. Quick Start Automated Workflow (Recommended) Use ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Run from this repository root\n# Simple task\npython opencode_acp_client.py \\\n  --project /path/to/project \\\n  --task \"Add --version flag to CLI\"\n\n# With verbose logging\npython opencode_acp_client.py \\\n  --project /path/to/project \\\n  --task \"Refactor authentication module\" \\\n  --verbose\n\n# With custom timeout (default: 600 seconds)\npython opencode_acp_client.py \\\n  --project /path/to/project \\\n  --task \"Build REST API for todos\" \\\n  --timeout 1200"},{"language":"bash","snippet":"# Start OpenCode ACP server in background\nexec pty:true workdir:/path/to/project background:true command:\"opencode acp\"\n# Returns sessionId (e.g., \"neat-zephyr\")\n\n# Initialize connection\nprocess action:write sessionId:neat-zephyr data:'{\"jsonrpc\":\"2.0\",\"id\":0,\"method\":\"initialize\",\"params\":{\"protocolVersion\":1,\"clientCapabilities\":{\"fs\":{\"readTextFile\":true,\"writeTextFile\":true},\"terminal\":true},\"clientInfo\":{\"name\":\"Claw\",\"title\":\"Claw AI Assistant\",\"version\":\"1.0.0\"}}}\\n'\n\n# Wait for response\nprocess action:log sessionId:neat-zephyr\n\n# Create session\nprocess action:write sessionId:neat-zephyr data:'{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"session/new\",\"params\":{\"cwd\":\"/path/to/project\",\"mcpServers\":[]}}\\n'\n\n# Wait for session ID\nprocess action:log sessionId:neat-zephyr\n\n# Send task\nprocess action:write sessionId:neat-zephyr data:'{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"session/prompt\",\"params\":{\"sessionId\":\"ses_xxx\",\"prompt\":[{\"type\":\"text\",\"text\":\"Your task here\"}]}}\\n'\n\n# Monitor progress\nprocess action:log sessionId:neat-zephyr\n\n# Kill when done\nprocess action:kill sessionId:neat-zephyr"},{"language":"markdown","snippet":"# Task: [Task Name]\n\n## Objective\n[Goal description]\n\n## Requirements\n1. [Requirement 1]\n2. [Requirement 2]\n...\n\n## Acceptance Criteria\n- ✅ [Criterion 1]\n- ✅ [Criterion 2]\n...\n\n## Implementation Guidance\n1. [Step 1]\n2. [Step 2]\n...\n\n## Verification\n[How to verify]"},{"language":"bash","snippet":"exec pty:true workdir:/path/to/project background:true command:\"opencode acp\""},{"language":"json","snippet":"{\"jsonrpc\":\"2.0\",\"id\":0,\"method\":\"initialize\",\"params\":{\"protocolVersion\":1,\"clientCapabilities\":{\"fs\":{\"readTextFile\":true,\"writeTextFile\":true},\"terminal\":true},\"clientInfo\":{\"name\":\"Claw\",\"title\":\"Claw AI Assistant\",\"version\":\"1.0.0\"}}}"},{"language":"json","snippet":"{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"session/new\",\"params\":{\"cwd\":\"/path/to/project\",\"mcpServers\":[]}}"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"CLAWHUB","editorialOverview":"Collaborate with OpenCode via ACP protocol for code modifications, refactoring, and feature implementation. --- name: opencode-acp description: Collaborate with OpenCode via ACP protocol for code modifications, refactoring, and feature implementation. metadata: { \"openclaw\": { \"emoji\": \"🔧\", \"requires\": { \"anyBins\": [\"opencode\"] } }, } --- OpenCode ACP Collaboration Use OpenCode via ACP (Agent Client Protocol) for code modifications, refactoring, and feature implementation. Quick Start Automated Workflow (Recommended) Use","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":362,"uniquenessScore":63,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:40:04.600Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}