serve-acp

serve-acp¶

Run agents as an ACP (Agent Client Protocol) server.

This creates an ACP-compatible JSON-RPC 2.0 server that communicates over stdio streams, enabling your agents to work with desktop applications that support the Agent Client Protocol.

Configuration: Config file is optional. Without a config file, creates a general-purpose agent with default settings. This is useful for clients/installers that start agents directly without configuration support.

Agent Selection: Use --agent to specify which agent to use by name. Without this option, the first agent in your config is used as the default (or "agentpool" if no config provided).

Agent Mode Switching: If your config defines multiple agents, the IDE will show a mode selector allowing users to switch between agents mid-conversation. Each agent appears as a different "mode" with its own name and capabilities.

agentpool serve-acp [OPTIONS] [CONFIG]

config¶

--file-access¶

Default: True Flag Enable file system access for agents

--terminal-access¶

Default: True Flag Enable terminal access for agents

--show-messages¶

Flag Show message activity in logs

--debug-messages¶

Flag Save raw JSON-RPC messages to debug file

--debug-file¶

File to save JSON-RPC debug messages (default: acp-debug.jsonl)

--model-provider¶

Multiple values allowed. Providers to search for models (can be specified multiple times)

--debug-commands¶

Flag Enable debug slash commands for testing ACP notifications

--agent¶

Name of specific agent to use (defaults to first agent in config)

--skills¶

Default: True Flag Load client-side skills from .claude/skills directory

--help¶

Flag Show this message and exit.