openclaw

    openclaw/acpx

    Headless CLI client for stateful Agent Client Protocol (ACP) sessions

    cli
    agentclientprotocol
    TypeScript
    MIT
    3.4K stars
    355 forks
    3.4K GitHub watchers
    Updated Nov 3, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    5 releases in the last 90 days, the latest 7 days ago, with 78 contributors on GitHub.

    Gained 40% fewer stars in the last 90 days than in the 90 days before.

    Use Cases & Benefits

    • Provides a headless CLI client for managing stateful Agent Client Protocol (ACP) sessions to enable structured agent-to-agent communication.
    • Offers persistent, named, and queue-aware sessions with cooperative cancellation and crash recovery, avoiding fragile PTY scraping.
    • Use for orchestrating multi-turn AI coding agent conversations scoped per repository with session history and parallel workstreams.
    • Use for running one-shot or queued prompts to coding agents like Codex, Claude, or Pi via a unified CLI interface with structured output.
    • Use for executing complex multi-step workflows using TypeScript flow modules that combine ACP prompts with deterministic shell or API actions.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    MIT

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present
    • Contributing guide: present

    Watch-outs

    No watch-outs from GStars' checks.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    ⚠️ 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.

    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), 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.

    Copy the block below and paste it into your Pi, OpenClaw, Claude Code, or similar agent harness. It will install acpx, read the skill reference, and know how to use ACP for all future coding agent tasks.

    Session state lives in ~/.acpx/ either way. Global install is a little faster, but npx acpx@latest works fine.

    Excerpt from the openclaw/acpx README on GitHub (MIT license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Forks

    355+37

    Open issues

    18+0

    Compared with peers in CLI

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 1, by 7-day star growth

    openclaw/acpx compared with CLI repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    vercel-labs/agent-desktop17.0K+13.3K33today
    mattpocock/skills315.4K+8.7K357 days ago
    stablyai/orca116.8K+6.6K40today
    obra/superpowers313.1K+4.5K532 days ago
    Panniantong/Agent-Reach109.3K+3.0K604 days ago
    openclaw/acpx3.4K—607 days ago
    Category median116.8K+6.6K40—

    Also by openclaw

    Other repositories from this maintainer that GStars tracks

    Discover Repositories

    Search across tracked repositories by name or description