acp-router

Routes natural language coding requests to AI harnesses via ErnOS ACP or acpx CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill intelligently directs plain-language coding requests to the appropriate execution environment, whether it's ErnOS's internal ACP runtime or a direct acpx command-line interface, ensuring efficient and accurate task handling.

Core Features & Use Cases

  • Intelligent Routing: Automatically determines the best path for coding tasks based on user intent and system availability.
  • Flexible Harness Support: Supports Pi, Claude Code, Codex, OpenCode, and Gemini CLI through either ErnOS ACP or direct acpx execution.
  • Use Case: When you say "run this Python script in Codex," the skill will either set up an ErnOS ACP session for Codex or use the acpx command to execute it directly, depending on the optimal path.

Quick Start

Route the request "run this code in Pi" to the ErnOS ACP runtime.

Frequently Asked Questions about acp-router

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

FAQPage Schema
How does routing natural language coding requests to an AI harness work?

Routing natural language coding requests works by mapping plain text intent to a specific AI coding harness like Pi, Claude Code, or Gemini CLI, and then directing the task to either an ErnOS ACP runtime session or a direct acpx CLI execution path.

Can I use Claude Code and Codex through the acpx command-line interface?

Yes, you can use Claude Code and Codex through the acpx command-line interface. The router flexibly supports these harnesses by setting up either an ErnOS ACP session or executing the task directly via acpx based on availability.

What is the best way to execute a Python script in Codex using natural language?

The best way to execute a Python script in Codex is to issue a plain language request, which the router intelligently maps to the Codex agent ID and delegates the code execution task through the optimal available ACP backend or acpx CLI.

How do I handle code execution when an ACP backend is unavailable?

When an ACP backend is unavailable, code execution handles the failure through built-in fallback mechanisms that automatically redirect the coding task to a direct acpx CLI execution path, ensuring robust task delegation without interruption.

Do I need an ErnOS ACP runtime session to route tasks to Gemini CLI?

No, you do not need an ErnOS ACP runtime session to route tasks to Gemini CLI. The router intelligently selects between ErnOS ACP sessions and direct acpx execution paths based on system availability and your preferences.

Why does my coding task route to acpx instead of the ErnOS ACP runtime?

Your coding task routes to acpx instead of the ErnOS ACP runtime because the router intelligently determines the best execution path based on system availability, agent ID mapping, and optimal task delegation requirements.