acp-router

Route natural language coding requests to ACP runtime or acpx sessions.

5.1k|1.2k|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/linuxhsj/openclaw-zero-token --skill acp-router-linuxhsj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/linuxhsj/openclaw-zero-token/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/linuxhsj/openclaw-zero-token --skill acp-router-linuxhsj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of directing plain-language coding requests to various AI coding environments like Pi, Claude Code, Codex, Gemini CLI, or the ACP harness, ensuring they are handled by the appropriate runtime, either OpenClaw ACP or a direct acpx session.

Core Features & Use Cases

  • Intelligent Routing: Automatically detects user intent to run code in specific AI coding tools.
  • Threaded Session Management: Manages the creation and interaction with coding sessions within threads for persistent conversations.
  • Flexible Execution Paths: Supports both the OpenClaw ACP runtime for integrated workflows and direct acpx CLI execution for simpler relay tasks.
  • Use Case: When a user says, "Start a new thread for Codex and ask it to write a Python script for web scraping," this skill ensures the request is correctly routed to a Codex session within a thread, bypassing standard subagent or PTY methods.

Quick Start

Use the acp-router skill to spawn a new thread for codex and ask it to say hi.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How do I route natural language coding requests to AI coding environments like Codex or Claude Code?

To route coding requests to AI environments like Codex or Gemini CLI, the system detects intent and maps the agentId, managing execution via either the OpenClaw ACP runtime or direct acpx sessions.

What is the difference between OpenClaw ACP runtime and direct acpx sessions for code execution?

OpenClaw ACP runtime provides integrated workflows for complex coding tasks, while direct acpx sessions offer simpler relay execution. The router handles mode selection between them based on the specific needs of the coding request.

How do I spawn a new thread for Codex or Gemini CLI to run a coding task?

Spawning a new thread for Codex or Gemini CLI involves using sessions_spawn to create a persistent conversation session. This bypasses standard subagent or PTY methods to ensure direct interaction with the coding environment.

Does the ACP router handle acpx installation and version management?

Yes, the ACP router manages acpx installation and version policies for direct execution. This ensures the correct acpx environment is configured when routing coding tasks to direct sessions rather than the OpenClaw runtime.

Can I use plain language to start a coding session in an ACP harness?

Yes, you can use plain language to start a coding session in an ACP harness. The router interprets the natural language request, selects the appropriate runtime, and initiates the session within a managed thread.