acp-router

Route plain-language requests into NanoSolana ACP runtime or direct acpx sessions.

Updated Mar 11, 2026

Search Tags:#routing #harness #thread-management #acp #sessions_spawn #acp-router

Ready to run

npx skills add https://github.com/x402agent/NanoSolana --skill acp-router-x402agent

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: acp-router
Source: https://github.com/x402agent/NanoSolana/tree/main/extensions/acpx/skills/acp-router
Command: npx skills add https://github.com/x402agent/NanoSolana --skill acp-router-x402agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Route plain-language requests for ACP harness work into either NanoSolana ACP runtime sessions or direct acpx-driven sessions. For coding-agent thread requests, read this skill first, then use only sessions_spawn for thread creation.

Core Features & Use Cases

Intent detection and routing across Pi, Claude Code, Codex, OpenCode, Gemini CLI, or ACP harness.
Mode selection between NanoSolana ACP runtime path and direct acpx path, with clear decision criteria.
Thread/sessions management: handles spawning, thread creation, and task queuing with explicit agentId mapping.
Recovery and safety: includes preflight checks, ACPX guidance, and automatic local repair flows when needed.

Quick Start

Route a request to spawn a Codex ACP session with the prompt "Say hi" and run it in session mode.

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 tasks to the correct coding agent session?▼

ACP harness tasks are routed by detecting intent and directing requests into either NanoSolana ACP runtime sessions or direct acpx-driven sessions using explicit agentId mapping.

What's the best way to spawn a thread for Claude Code or Codex using ACP runtime?▼

To spawn a thread for Claude Code or Codex, use the sessions_spawn command for thread creation, which ensures proper thread control and task queuing within the ACP runtime.

When should I choose the direct acpx path over the NanoSolana ACP runtime for harness tasks?▼

Choose the direct acpx path when available and suitable for your environment, otherwise default to the NanoSolana ACP runtime path based on specific decision criteria for your coding agent tasks.

Does ACP routing work with Gemini CLI and OpenCode harness requests?▼

Yes, ACP routing supports intent detection and task relaying across Pi, Claude Code, Codex, OpenCode, and Gemini CLI harnesses by mapping requests to the correct sessions.

How do I fix acpx installation issues when spawning ACP sessions?▼

The routing workflow includes a built-in thread-spawn recovery and acpx-install-repair flow that runs preflight checks and automatically triggers local repair when needed.

Why does my coding-agent thread request require explicit agentId mapping?▼

Explicit agentId mapping is enforced during session spawning and thread creation to ensure that plain-language prompts are accurately relayed to the correct ACP harness runtime.