← Back to Skills Marketplace
chaoyang78

Stone Acpx

by Kevin Stone · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ pending
35
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install stone-acpx
Description
Use the acpx CLI to run coding agents over the Agent Client Protocol (ACP) instead of PTY scraping. Use when routing work to Codex, Claude Code, Gemini CLI,...
README (SKILL.md)

acpx

Use acpx as the CLI transport for ACP coding clients.

Local policy for this machine

  • OpenClaw ACP runtime uses a fixed plugin-local acpx version, not npx acpx@latest.
  • Current pinned target: 0.3.0.
  • Prefer these configured ACP harness agents for coding work:
    • openai_codex_agent -> Codex
    • claude_code_agent -> Claude Code
    • google_gemini_agent -> Gemini CLI
  • Gemini CLI must use its own default model on this machine; do not force deprecated model ids in ACP overrides.
  • Use npx acpx@latest only for explicit manual experiments or upgrade checks, not as the default OpenClaw runtime backend.

Binary selection

For OpenClaw/runtime-integrated ACP work, prefer the plugin-local binary:

/opt/homebrew/lib/node_modules/openclaw/extensions/acpx/node_modules/.bin/acpx

Check the pinned version from the extension package:

node -e "console.log(require('/opt/homebrew/lib/node_modules/openclaw/extensions/acpx/package.json').dependencies.acpx)"

Common commands

acpx codex "fix the tests"
acpx claude "refactor auth"
acpx gemini exec "summarize this repo"
acpx codex sessions new --name backend
acpx codex sessions close backend

References

For the full upstream reference, read:

How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install stone-acpx
  3. After installation, invoke the skill by name or use /stone-acpx
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the "acpx" skill. - Introduces the acpx CLI for running coding agents via Agent Client Protocol (ACP) instead of PTY scraping. - Documents local runtime policy, including use of a fixed plugin-local acpx version (currently 0.3.0). - Details preferred routing of coding work to Codex, Claude Code, and Gemini CLI via configured ACP harness agents. - Provides binary selection guidance and common acpx commands. - Includes references for further documentation.
Metadata
Slug stone-acpx
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Stone Acpx?

Use the acpx CLI to run coding agents over the Agent Client Protocol (ACP) instead of PTY scraping. Use when routing work to Codex, Claude Code, Gemini CLI,... It is an AI Agent Skill for Claude Code / OpenClaw, with 35 downloads so far.

How do I install Stone Acpx?

Run "/install stone-acpx" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Stone Acpx free?

Yes, Stone Acpx is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Stone Acpx support?

Stone Acpx is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Stone Acpx?

It is built and maintained by Kevin Stone (@chaoyang78); the current version is v1.0.0.

💬 Comments