acpx

Manage agent-to-agent communication over the Agent Client Protocol via a headless CLI client.

3.1k|318|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/openclaw/acpx --skill acpx-openclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acpx
Source: https://github.com/openclaw/acpx/tree/main/skills/acpx
Command: npx skills add https://github.com/openclaw/acpx --skill acpx-openclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the problem of direct, structured communication between AI agents and orchestrators, eliminating the need for PTY scraping and enabling efficient multi-agent workflows.

Core Features & Use Cases

  • Persistent Sessions: Maintain multi-turn conversations across invocations, scoped per repository.
  • Named Sessions: Run parallel workstreams within the same repository.
  • Prompt Queueing: Submit prompts while one is already running, executing in order.
  • Session Controls: Manage session modes, configurations, and metadata.
  • Session Export/Import: Move session records between machines.
  • Use Case: For a software development team, use acpx to manage sessions with coding agents like Codex, Claude, and OpenClaw, facilitating efficient code reviews, debugging, and development workflows.

Quick Start

Install acpx globally with npm i -g acpx and run a prompt with acpx codex 'summarize this repo'.

Frequently Asked Questions about acpx

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

FAQPage Schema
How do I manage agent-to-agent communication over ACP without PTY scraping?

You can manage agent-to-agent communication over ACP using a headless CLI client. This approach eliminates PTY scraping by handling structured communication, persistent sessions, and multi-agent workflows directly through the Agent Client Protocol.

Can I run parallel multi-agent workflows within the same repository?

Yes, you can run parallel multi-agent workflows within the same repository using named sessions. This feature allows you to maintain multiple distinct workstreams and multi-turn conversations scoped to a single project simultaneously.

How do I queue prompts for an AI agent while it is already running?

To queue prompts for an AI agent while one is running, you can use prompt queuing functionality. This allows you to submit multiple prompts sequentially, which the system will execute in the order they were received.

What is the best way to maintain multi-turn conversations with coding agents like Claude and Codex?

To maintain multi-turn conversations with coding agents like Claude and Codex, use a CLI client that supports persistent sessions. This keeps conversation context across invocations, enabling efficient code reviews and debugging workflows.

Can I export and import agent session records between different machines?

Yes, you can export and import agent session records between machines. The session export and import controls allow you to move session metadata and configurations, facilitating multi-agent workflows across different development environments.

Do I need ACP-compatible orchestrators to use this CLI for agent communication?

Yes, you need ACP-compatible agents and orchestrators to use this CLI for agent communication. The headless client manages structured interactions over the Agent Client Protocol, requiring compatible endpoints to function properly.