Claude Skill

openclaw/acpx

acpx is a TypeScript-based headless CLI client for managing stateful Agent Client Protocol sessions, enabling command-line interaction with agent systems.

Overview

Stars2,930
Forks286
LanguageTypeScript
Last pushed2026-07-02
Last synced2026-07-03
View on GitHub

Repository

Owneropenclaw
Repositoryacpx
Full nameopenclaw/acpx
Repo ID1,160,289,278
GitHub URLhttps://github.com/openclaw/acpx

Install this Skill

npm install -g acpx@latest
GitHub

Registry

Typemcp_server
Quality score85/100
Verificationreadme_parsed
Last verified2026-05-31
Platforms
ClaudeMCPOpenClawCodexCursor
Capabilities
browserpdfmemoryterminalworkflowagentclientprotocol
Detected files
README.mddocsexamplespackage.jsontest
Config keys
URLMETHOD_IDACPX_AUTH_OPENAI_API_KEYOPENAI_API_KEYPACKAGE_JSON
Install methods
  • npm install -g acpx@latest
  • npx acpx@latest
  • npx acpx@latest --skill install acpx --agent codex --scope user
  • npx acpx@latest codex "fix the failing tests"
  • npx acpx@latest claude "refactor the auth module"

Summary

acpx is a headless CLI client designed for managing stateful Agent Client Protocol (ACP) sessions, providing a command-line interface to interact with agent-based systems.

Chinese description

无头命令行界面客户端，用于支持有状态的代理客户端协议（ACP）会话

Key features

  • Headless CLI client for ACP sessions
  • Manages stateful protocol sessions
  • TypeScript implementation
  • Command-line interface for agent interaction

Use cases

  • Interacting with agent-based systems via CLI
  • Managing persistent ACP sessions
  • Automating agent client protocol workflows
  • Integrating ACP into headless environments

README excerpt

<p align="center"> <img src="acpx_banner.svg" alt="acpx banner" width="100%" /> </p> # acpx [![npm version](https://img.shields.io/npm/v/acpx.svg)](https://www.npmjs.com/package/acpx) [![npm downloads](https://img.shields.io/npm/dm/acpx.svg)](https://www.npmjs.com/package/acpx) [![CI](https://github.com/openclaw/acpx/actions/workflows/ci.yml/badge.svg)](https://github.com/openclaw/acpx/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Node.js](https://img.shields.io/node/v/acpx.svg)](https://nodejs.org) > ⚠️ `acpx` is in alpha and the CLI/runtime interfaces are likely to change. Anything you build downstream of this might break until it stabilizes. > ACP coverage status: see [ACP Spec Coverage Roadmap](docs/2026-02-19-acp-coverage-roadmap.md). Your agents love acpx! 🤖❤️ They hate having to scrape characters from a PTY session 😤 `acpx` is a headless CLI client for the [Agent Client Protocol (ACP)](https://agentclientprotocol.com), so AI agents and orchestrators can talk to coding agents over a structured protocol instead of PTY scraping. One command surface for Pi, OpenClaw ACP, Codex, Claude, and other ACP-compatible agents. Built for agent-to-agent communication over the command line. - **Persistent sessions**: multi-turn conversations that survive across invocations, scoped per repo - **Named sessions**: run parallel workstreams in the same repo (`-s backend`, `-s frontend`) - **Prompt queueing**: submit prompts while one is already running, they execute in order - **Cooperative cancel command**: `cancel` sends ACP `session/cancel` via queue IPC without tearing down session state - **Soft-close lifecycle**: close sessions without deleting history from disk - **Queue owner

Topics

agentclientprotocol

Explore more

Owner: openclawLanguage: TypeScript

Data from GitHub. Synced on 2026-07-03