## Documentation Index

Fetch the complete documentation index at: [/llms.txt](https://docs.poolside.ai/llms.txt)

Use this file to discover all available pages before exploring further.

---

Poolside Agent CLI is the command-line application for Poolside’s coding agent. Use the `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](https://github.com/poolsideai/pool/releases) for release history.

## Key features

- [Plan mode](https://docs.poolside.ai/cli/interactive-mode#use-plan-mode) to review an approach before the agent changes your code
- [Skills](https://docs.poolside.ai/cli/interactive-mode#use-a-skill) and [slash commands](https://docs.poolside.ai/cli/interactive-mode#slash-commands) to extend and speed up common workflows
- [Sessions](https://docs.poolside.ai/cli/interactive-mode#sessions) and [rewind](https://docs.poolside.ai/cli/interactive-mode#rewind-a-turn) to resume work and undo turns
- [Modes](https://docs.poolside.ai/cli/interactive-mode#modes) to control how much the agent can do without asking
- [AGENTS.md instructions](https://docs.poolside.ai/agent-instructions) to give the agent project-specific guidance
- [MCP servers](https://docs.poolside.ai/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](https://docs.poolside.ai/cli/install) to install `pool` and sign in. To compare access methods, such as Poolside Platform, a Poolside deployment, or OpenRouter, see [Log in to Poolside](https://docs.poolside.ai/get-started/log-in).

Looking for a Poolside API key? Run `pool login` and choose **Use Poolside Platform for free (recommended)** for the fastest way to get free developer access to models hosted by Poolside.

## Configure the agent

[Configure Poolside](https://docs.poolside.ai/configure) to customize agent behavior and the resources it can use across terminal, automated, and ACP sessions, including [permissions and sandboxes](https://docs.poolside.ai/permissions) that control what the agent can access and run.

## Related resources

- [CLI reference](https://docs.poolside.ai/cli/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](https://docs.poolside.ai/cli/troubleshooting) for authentication, connection, session, and ACP issues.
- [Uninstall Poolside Agent CLI](https://docs.poolside.ai/cli/install#uninstall-poolside-agent-cli) to remove `pool` and saved local data.

For `pool` CLI bugs and feature requests, open an issue on [GitHub](https://github.com/poolsideai/pool).