acp-router

Route user requests to OpenClaw ACP runtime or direct acpx sessions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/rigeoben/fairy --skill acp-router-rigeoben
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/rigeoben/fairy/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/rigeoben/fairy --skill acp-router-rigeoben

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route plain-language coding requests to the appropriate ACP harness backend (OpenClaw ACP runtime or direct acpx) and manage session lifecycles across multiple backends.

Core Features & Use Cases

  • Route requests to appropriate ACP backends (OpenClaw ACP runtime or direct acpx) for harness execution.
  • Support preflight checks, agentId mappings, and thread-based session management to keep conversations organized.
  • Use cases include initiating a new ACP harness session for a coding task, relaying prompts to an existing harness thread, or continuing a multi-harness workflow across Pi, Claude Code, Cursor, Codex, Gemini, and others.

Quick Start

Spawn an ACP session in a thread and have it route a sample coding task.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route coding requests to an ACP harness session?▼

You can route coding requests to an ACP harness session by directing them to either the OpenClaw ACP runtime using sessions_spawn or the direct acpx path, both of which execute coding workflows.

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

The OpenClaw ACP runtime path uses sessions_spawn to spawn and manage harness sessions, whereas the direct acpx path provides telephone-game style control for executing coding workflows.

Do I need a specific environment to spawn ACP harness sessions?▼

Yes, spawning ACP harness sessions requires a properly configured ACP environment, including the ACP runtime or pinned acpx tooling, along with explicit agentId mappings and preflight checks.

Can I relay prompts to an existing ACP harness thread?▼

Yes, you can relay prompts to an existing harness thread by utilizing the thread-based session management feature to keep conversations organized across multiple ACP backends.

Does ACP routing support multi-harness workflows across different coding agents?▼

ACP routing supports continuing multi-harness workflows across various coding environments, including Pi, Claude Code, Cursor, Codex, Gemini, and others, by managing session lifecycles across backends.