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 "llmling-agent" 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.
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)
--log-file¶
File to save logs to (default: acp.log when serving over stdio)
--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)
--help¶
Flag Show this message and exit.