pool command to work directly from your terminal, automate one-shot tasks, or connect Poolside to an ACP-compatible editor. You can also use pool as an ACP client for another compatible agent server.
The agent can read your code, answer questions about a project, propose changes, edit files, run commands, and use configured resources such as MCP servers and skills. You control what it can do with approval prompts, permissions, and sandboxes.
This documentation describes Poolside Agent CLI v1.0.13. Check your version with
pool --version. To update, exit any active session and run pool update from your terminal. See Poolside Agent CLI releases on GitHub for release history.Key features
- Plan mode to review an approach before the agent changes your code
- Skills and slash commands to extend and speed up common workflows
- Sessions and rewind to resume work and undo turns
- Modes to control how much the agent can do without asking
- AGENTS.md instructions to give the agent project-specific guidance
- MCP servers to connect external tools and resources
Choose a workflow
Work in the terminal
Use
pool for interactive, multi-turn sessions in your project directory.Automate a task
Use
pool exec for one-shot prompts in scripts and CI jobs.Use Poolside in an editor
Connect Poolside to an ACP-compatible editor with
pool acp.Connect another agent server
Use
pool as an ACP client for another compatible agent server.Install and authenticate
Install Poolside Agent CLI to installpool and sign in. To compare access methods, such as Poolside Platform, a Poolside deployment, or OpenRouter, see Log in to Poolside.
Configure the agent
Configure Poolside to customize agent behavior and the resources it can use across terminal, automated, and ACP sessions, including permissions and sandboxes that control what the agent can access and run.Related resources
- CLI reference for commands, flags, slash commands, and exit codes. To see commands and flags for your installed version, run
pool --help. - Troubleshoot Poolside Agent CLI for authentication, connection, session, and ACP issues.
- Uninstall Poolside Agent CLI to remove
pooland saved local data.
For
pool CLI bugs and feature requests, open an issue on GitHub.