acpx — это клиент командной строки без головы для протокола Agent Client Protocol (ACP). Он предоставляет агентам, оркестраторам и разработчикам один структурированный интерфейс для постоянных сессий, одноразовых запусков, разрешений и машиночитаемого вывода между совместимыми с ACP кодировочными агентами.

[! ПРИМЕЧАНИЕ] acpx — это до версии 1.0. Считайте, что его интерфейсы CLI и времени выполнения эволюционируют.

Установка

Установите опубликованный пакет npm глобально:

acpx требует Node.js версии 22.13 или новее. Чтобы попробовать без глобальной установки, добавьте команду с npx acpx@latest. Смотрите руководство по установке для обязательных требований к адаптеру, обновлений и сборок исходного кода.

Быстрый старт

Установите и аутентифицируйте нужный программный агент, затем создайте сессию в проекте и отправьте ему запрос:

Сессия ограничена текущим репозиторием и сохраняется в разных вызовах. Создание сессий явно предотвращает автоматизацию от неожиданного запуска разговора. Быстрый старт продолжается с именованных сессий, one-shot запусков, истории и JSON-вывода.

Выберите агента

Распространённые примеры запуска используют одну и ту же командную форму:

acpx 🤝 — Agents talking to agents, minus the terminal séance

acpx is a headless command-line client for the Agent Client Protocol (ACP). It gives agents, orchestrators, and developers one structured interface for persistent sessions, one-shot runs, permissions, and machine-readable output across ACP-compatible coding agents.

$ acpx codex sessions new

$ acpx codex "summarize this repository"
[tool] Read README.md (completed)
This repository contains ...
[done] end_turn

[!NOTE] acpx is pre-1.0. Treat its CLI and runtime interfaces as evolving.

Install

Install the published npm package globally:

npm install -g acpx@latest

acpx requires Node.js 22.13 or newer. To try it without a global install, prefix a command with npx acpx@latest instead. See the install guide for adapter prerequisites, updates, and source builds.

Quick start

Install and authenticate the coding agent you want to use, then create a session in your project and send it a prompt:

acpx codex sessions new
acpx codex "find the slowest test and explain why"

The session is scoped to the current repository and persists across invocations. Creating sessions explicitly prevents automation from starting an unexpected conversation. The quickstart continues with named sessions, one-shot runs, history, and JSON output.

Choose an agent

Common launch examples use the same command shape:

The upstream agent must be installed and authenticated when its adapter does not provide that itself. See built-in agents for every supported profile and custom agents for registry configuration.

Sessions and one-shot runs