Use other agent servers - Poolside

Prerequisites

• You have another ACP-compatible agent server installed and runnable on your machine, or the URL of a remote ACP server.
• You know the command or URL that starts that agent server.

Steps

1. Start pool with --agent-server and the command or URL for the agent you want to use:

   # Claude Agent
   pool --agent-server claude-agent-acp

# Codex
   pool --agent-server codex-acp

# Gemini
   pool --agent-server "gemini --acp"

# Remote ACP server
   pool --agent-server http://localhost:3284/acp

2. To choose from configured agent servers interactively instead of passing a command each time, run:

   pool -s

3. To reuse a server without retyping its command or URL, add an agent_servers entry to ~/.config/poolside/settings.yaml. Set pool.default_agent_server to use it automatically, or select it later with pool -s.

Agent server example for ~/.config/poolside/settings.yaml

pool:
     default_agent_server: claude
agent_servers:
     claude:
       command: claude-agent-acp
     remote:
       url: http://localhost:3284/acp

For remote ACP servers, you can also configure headers on the agent_servers entry. For full configuration details, see Agent servers.