openclaw

openclaw / acpx

Public

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

172
25
100% credibility
Found Feb 24, 2026 at 65 stars 3x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

acpx is a command-line tool for running AI coding agents with persistent, queued sessions tied to your project folders.

How It Works

1
🔍 Discover acpx

You hear about acpx from your AI helper, a simple way to let smart coding assistants work reliably on your projects without messy screen scraping.

2
📦 Set it up quickly

Run one easy command to add acpx to your computer, and it saves your work in a private folder.

3
🗂️ Start a workspace

In your project folder, create a named space for your AI assistant to remember conversations across uses.

4
💬 Ask it to help

Tell your assistant something like 'fix the flaky tests' and watch it spring into action.

5
⚙️ See it work magic

Your assistant thinks step-by-step, checks files, runs tests, and suggests changes, all in clear updates.

6
🔄 Keep going smoothly

Add more requests to the queue, pause if needed, or switch modes while it handles everything in order.

Enjoy perfect results

Your code is fixed, tests pass reliably, and you have a reusable helper for future coding adventures.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 65 to 172 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is acpx?

acpx is a TypeScript CLI serving as a headless client for stateful Agent Client Protocol (ACP) sessions, enabling AI agents to interact with coding agents like Codex, Claude, Gemini, or OpenCode over structured channels instead of scraping PTY output. Developers get persistent multi-turn conversations per repo, named sessions for parallel tasks (e.g., `acpx codex -s backend "fix API"`), prompt queueing, and crash reconnects. Run via `npx acpx codex "find flaky tests"`, with JSON streaming for automation.

Why is it gaining traction?

It ditches unreliable PTY parsing for typed ACP messages—thinking steps, tool calls, diffs—making agent output parseable without regex hacks. Queueing lets you fire prompts while others run (`--no-wait`), with cooperative cancels and session controls like `set-mode plan`. Built-in registry covers top agents, plus `--agent` for customs, positioning it as a github headless chrome equivalent for agent CLI workflows.

Who should use this?

AI orchestrator builders integrating coding agents into scripts or CI/CD, like backend teams delegating test fixes or refactors via Claude Code. Frontend devs running parallel sessions for UI/backend splits in monorepos. Anyone tired of headless client minecraft-style terminal hacks for acpc-like protocols.

Verdict

Promising for ACP early adopters, with clean CLI, config files, and skill refs, but low maturity (14 stars, 1.0% credibility) means expect rough edges—test in non-prod first. Solid foundation if you're building agent pipelines.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.