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.