acp_agent/
lib.rs

1#![doc = r#"
2`acp-agent` is a CLI for discovering, installing, launching, and proxying ACP agents
3from the public registry.
4
5## Command-Line Usage
6
7List every published agent:
8
9```bash
10acp-agent list
11```
12
13Search for agents by ID, name, or description:
14
15```bash
16acp-agent search claude
17```
18
19Install an agent from the registry:
20
21```bash
22acp-agent install example-agent
23```
24
25Install local runtime prerequisites such as Bun or uv when they are missing:
26
27```bash
28acp-agent install-env
29```
30
31Run an agent over stdio and pass through extra arguments after `--`:
32
33```bash
34acp-agent run example-agent -- --model gpt-5
35```
36
37Expose an agent over a network transport:
38
39```bash
40acp-agent serve example-agent --transport http --host 127.0.0.1 --port 8010
41acp-agent serve example-agent --transport tcp --port 9000
42acp-agent serve example-agent --transport ws --port 7000
43```
44
45## Transport Modes
46
47- `http` exposes one HTTP/2 byte stream over `POST /` with `Content-Type: application/octet-stream`.
48- `tcp` exposes raw stdin/stdout bytes over a single TCP connection.
49- `ws` exposes stdin/stdout through a JSON-RPC API over WebSocket.
50
51## Library Surface
52
53This package primarily exists as a CLI, but the implementation is also exposed as a
54library for embedding:
55
56- [`commands`] embeds the CLI parser and dispatch logic.
57- [`registry`] loads and queries the public ACP registry.
58- [`runtime`] prepares agent commands and serves them over stdio or network transports.
59"#]
60#![warn(missing_docs)]
61
62/// CLI parsing and command-dispatch helpers used by the `acp-agent` executable.
63pub mod commands;
64/// Types and helpers for loading ACP agent metadata from the public registry.
65pub mod registry;
66/// Runtime primitives for preparing agent commands and exposing them over transports.
67pub mod runtime;
acp_agent/lib.rs

acp_agent/
lib.rs
