openclaw/acpx

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

What it solves

acpx provides a unified, headless command-line interface for interacting with various AI coding agents. It eliminates the need to use different terminal interfaces for different agents by implementing the Agent Client Protocol (ACP), allowing developers to manage persistent sessions, permissions, and machine-readable output across multiple ACP-compatible agents.

How it works

The tool acts as a client for the Agent Client Protocol (ACP). It provides built-in launch profiles for agents like Codex, Claude Code, Gemini CLI, and OpenClaw, as well as support for custom ACP servers. It manages session state (stored in ~/.acpx/) to maintain context between prompts and supports both persistent sessions and stateless "one-shot" runs via the exec command.

Who it’s for

Developers and orchestrators who want a standardized way to interact with AI coding agents via the CLI, automate agentic workflows, and maintain consistent session management across different agent providers.

Highlights

  • Unified Interface: Use the same command structure across different AI agents (e.g., Codex, Claude, Gemini).
  • Persistent Sessions: Maintain context across multiple prompts and support parallel named workstreams.
  • One-Shot Runs: Execute stateless runs without saving session history.
  • Automation Friendly: Supports NDJSON output for machine-readable events, including tool calls and diffs, instead of terminal escape sequences.
  • Automation Flows: Execute TypeScript workflows that combine AI turns with deterministic actions and checkpoints.
  • Granular Permissions: Control filesystem boundaries and approval policies for agent actions.

Related

  • Project
    milisp/codexia

    A lightweight agent workstation that provides a unified command center for Codex CLI, Claude Code, and ACP-compatible agents with a task scheduler and remote control.

  • Project
    asheshgoplani/agent-deck

    A command center for AI coding agents that allows users to manage, monitor, and orchestrate multiple agent sessions across different projects from a single terminal.

  • Project
    maddada/Ghostex

    A cross-platform desktop workspace that integrates persistent terminals, a built-in IDE, and browser panes to manage and orchestrate multiple AI agent CLIs.

  • Project
    YoanWai/agent-manager

    A terminal-based manager for AI coding agents that allows you to run multiple CLI agents side-by-side with integrated diff review and live status tracking.

  • Project
    carlos-algms/agentic.nvim

    A Neovim chat interface for AI agents that implements the Agent Client Protocol (ACP), allowing seamless integration with various AI providers and terminal-based sessions.