Crate acp_agent 

acp-agent is a CLI for discovering, installing, launching, and proxying ACP agents from the public registry.

Command-Line Usage

List every published agent:

acp-agent list

Search for agents by ID, name, or description:

acp-agent search claude

Install an agent from the registry:

acp-agent install example-agent

Install local runtime prerequisites such as Bun or uv when they are missing:

acp-agent install-env

Run an agent over stdio and pass through extra arguments after --:

acp-agent run example-agent -- --model gpt-5

Expose an agent over a network transport:

acp-agent serve example-agent --transport http --host 127.0.0.1 --port 8010
acp-agent serve example-agent --transport tcp --port 9000
acp-agent serve example-agent --transport ws --port 7000

Transport Modes

• http exposes one HTTP/2 byte stream over POST / with Content-Type: application/octet-stream.
• tcp exposes raw stdin/stdout bytes over a single TCP connection.
• ws exposes stdin/stdout through a JSON-RPC API over WebSocket.

Library Surface

This package primarily exists as a CLI, but the implementation is also exposed as a library for embedding:

• commands embeds the CLI parser and dispatch logic.
• registry loads and queries the public ACP registry.
• runtime prepares agent commands and serves them over stdio or network transports.

Modules

commands

CLI parsing and command-dispatch helpers used by the acp-agent executable.

registry

Types and helpers for loading ACP agent metadata from the public registry. Facilities for decoding the shared agent registry that acp-agent consumes.

runtime

Runtime primitives for preparing agent commands and exposing them over transports. Runtime helpers that the CLI and transports share when launching ACP agents.