> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging.poolside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Poolside Agent CLI

> Work with Poolside agents from your terminal, scripts, or editor.

## Overview

Use the Poolside Agent CLI to work with agents from the terminal, run one-shot tasks in scripts and automation, or connect Poolside to Agent Client Protocol (ACP)-compatible editors.

The CLI has three main interfaces:

| Interface                                     | Command     | What it does                                |
| --------------------------------------------- | ----------- | ------------------------------------------- |
| [Interactive mode](/cli/interactive-mode)     | `pool`      | Interactive terminal sessions               |
| [Automated mode](/cli/automated-mode)         | `pool exec` | One-shot tasks and automation               |
| [Editor integration](/cli/editor-integration) | `pool acp`  | Connect ACP-compatible editors to the agent |

If you have not installed or authenticated the CLI yet, start with [Install Poolside Agent CLI](/cli/install).

<Info>
  This documentation describes Poolside Agent CLI v1.0.6. Check your version with `pool --version`. To update, exit any active session and run `pool update` from your terminal. See [pool CLI releases on GitHub](https://github.com/poolsideai/pool/releases) for release history.
</Info>

To see available commands and flags in your installed CLI version, run:

```bash theme={null}
pool --help
```

## Interactive mode

Run `pool` to open a terminal session with the agent:

```bash theme={null}
pool
```

The agent can read your code, run commands, and write files. It asks for approval before taking action. Use this when you expect to go back and forth by refining the task, reviewing changes, or switching modes as you go.

Start in a specific directory:

```bash theme={null}
pool -C <project-path>
```

Resume a previous session:

```bash theme={null}
pool -r
```

Choose a configured ACP-compatible agent server:

```bash theme={null}
pool -s
```

See [Interactive mode](/cli/interactive-mode) for the full list of options and session controls.

## Automated mode

Run `pool exec` to send a single prompt and exit:

```bash theme={null}
pool exec -p "What does this codebase do?"
```

Use this for scripts, CI pipelines, and one-off tasks. See [Automated mode](/cli/automated-mode) for the full list of options and flags.

<Tip>
  If you previously used non-interactive flags on `pool`, such as `pool -p`, use `pool exec` instead.
</Tip>

## Editor integration

To use Poolside in an editor or client without a native Poolside extension, configure the editor to use `pool acp`, the Agent Client Protocol (ACP) server. Supported editors include Zed, JetBrains, Neovim, and others that implement ACP.

For example:

```bash theme={null}
pool acp setup --editor zed
```

See [Editor integration (ACP)](/cli/editor-integration) for setup instructions and other editors.

## Related resources

* [Install](/cli/install)
* [Interactive mode](/cli/interactive-mode)
* [Automated mode](/cli/automated-mode)
* [Editor integration (ACP)](/cli/editor-integration)
* [CLI reference](/cli/cli-reference)

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