acp-router

Route coding-agent tasks to ACP harness runtimes or direct acpx sessions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Routes plain-language or harness-related requests to the appropriate ACP runtime paths or direct acpx-driven sessions, enabling deterministic control over coding-agent workflows and thread management.

Core Features & Use Cases

  • Routes ACP harness tasks to either VikiClow ACP runtime sessions or direct acpx sessions.
  • Supports mapping of user-specified harness names to default agent IDs, and enforces policy if disallowed.
  • Provides safeguards for thread-spawn, runtime path selection, and task scoping to ensure reliable execution in multi-agent scenarios.
  • Use cases include starting new ACP harness sessions, continuing existing threads, or relaying prompts to external coding harnesses.

Quick Start

Read this skill before initiating any ACP harness work and provide the task in the ACP session payload.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route ACP harness requests to the right coding agent session?

To route ACP harness requests, map user-specified harness names to default agent IDs, which directs tasks to either VikiClow ACP runtime sessions or direct acpx sessions for deterministic workflow control.

Can I use ACP routing to continue existing coding threads across different agents?

Yes, ACP routing supports continuing existing threads by applying proper thread handling and relaying prompts to external coding harnesses like Pi, Claude Code, Codex, OpenCode, Gemini, or Kimi.

What is ACP runtime session spawning and when do I need it for coding-agent tasks?

ACP runtime session spawning is the process of initiating isolated execution paths for coding agents. You need it when starting new ACP harness sessions or scoping tasks in multi-agent scenarios to ensure reliable execution.

How do I map agent IDs and select modes for ACP harness sessions?

You map agent IDs and select modes by providing the task in the ACP session payload, which enforces policy for explicit agentId mapping and runtime path selection before routing the request.

Are there limitations when routing acpx sessions for multi-agent coding workflows?

Limitations include policy enforcement on disallowed harness names and required safeguards for thread-spawn and task scoping, ensuring that runtime path selection remains deterministic and explicitly mapped.

What's the best way to manage task scoping when spawning ACP runtime sessions?

The best way to manage task scoping is to satisfy runtime session spawning policies through the ACP session payload, ensuring explicit agentId mapping and proper mode selection for reliable multi-agent execution.