skills.rest
srgaba
srgabaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

acp-router

Routes coding-agent requests to ACP runtime sessions or direct acpx CLI sessions.

Updated Mar 30, 2026
Search Tags:#routing#cli#session management#acp#coding agents#acpx#thread spawn
One-click install
npx skills add https://github.com/srgaba/open-claw --skill acp-router-srgaba
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/srgaba/open-claw/tree/main/project/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/srgaba/open-claw --skill acp-router-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires acpx.

What problem does it solve? It decides how to handle plain-language requests to run work in external coding harnesses (Pi, Claude Code, Codex, Cursor, Copilot, Gemini, Qwen, and others) by routing them through the correct ACP-aware path instead of subagent runtimes or PTY scraping. ## Core Features & Use Cases - Intent detection and routing: Recognizes requests to run or continue work in supported ACP harnesses and selects between the OpenClaw ACP runtime path and the direct acpx telephone-game path. - Thread spawn policy: Enforces sessions_spawn with runtime acp for thread creation, including automatic repair and retry when the ACP backend is unavailable. - Direct acpx session management: Provides pinned-version install policy, deterministic session naming, and command templates for persistent sessions, one-shot execution, cancellation, and cleanup. - Use Case: A user says "spawn a Codex session in a thread and tell it to say hi" — the skill routes this to sessions_spawn with runtime acp, agentId codex, and thread mode, without asking the user to run any CLI commands. ## Quick Start Ask the assistant to run a task in a named harness, for example: "Start a Claude Code session in a thread and have it review the src directory."

Frequently Asked Questions about acp-router

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a task in Claude Code or Codex from OpenClaw?▼

Name the harness in your request and the router maps it to an agentId, then spawns an ACP runtime session via sessions_spawn with thread mode. You do not need to run slash commands or CLI tools yourself.

What is the difference between the ACP runtime path and the direct acpx path?▼

The ACP runtime path uses sessions_spawn and is the default for thread-based harness work. The direct acpx path drives the harness CLI through exec commands and is used when the user explicitly asks for it or the ACP runtime is unavailable.

Which coding agents does acpx support?▼

acpx includes built-in aliases for claude, codex, copilot, cursor, droid, gemini, iflow, kilocode, kimi, kiro, openclaw, opencode, pi, and qwen. Overrides in ~/.acpx/config.json replace these defaults.

What happens when the ACP backend is unavailable during thread spawn?▼

The router first attempts automatic repair by installing the pinned plugin-local acpx in extensions/acpx, verifying its version, and restarting the gateway. It retries the spawn once and only then reports the error with fallback options.

Why should I avoid PTY scraping or subagent runtime for harness control?▼

The skill explicitly prohibits subagent runtime and PTY scraping for supported ACP harnesses because acpx and the ACP runtime provide structured session lifecycle management. These fallbacks lose thread context and reliable output relay.

Related Skills

Explore More Software Engineering Skills→
openclawopenclaw
385.7k

acp-router

Route natural language requests to AI coding harnesses and ACP runtime sessions.

Official
Advanced
CodingHeaderCodingHeader

extract-transcripts

Convert Claude Code and Codex session JSONL files into readable Markdown transcripts.

Community
Advanced
Agent-Pattern-LabsAgent-Pattern-Labs
4

acp-router

Route user requests to ACP harnesses and manage sessions in OpenClaw ACP runtime or acpx.

Official
Advanced
shalevaminshalevamin

acp-router

Routes coding-agent requests to ACP runtime sessions or direct acpx CLI sessions.

Community
Advanced