> ## 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.

# Editor integration (ACP)

> Use Poolside in Zed, JetBrains, Neovim, and other ACP-compatible editors with `pool acp`.

You can use Poolside in editors that do not have a native Poolside extension by running `pool acp`. This Agent Client Protocol (ACP) server works with Zed, JetBrains, Neovim, and other editors that support ACP.

<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>

## Capabilities

Poolside ACP supports the following capabilities when the editor client exposes them:

* To-do lists
* [Plan mode](/cli/interactive-mode#use-plan-mode)
* [Skills](/skills)
* [AGENTS.md](/agent-instructions)
* Resume and delete saved sessions when the editor supports session history
* Rewind to an earlier turn when the editor supports it
* Change modes and models when the editor supports ACP session configuration
* Configure thought level when the editor supports ACP session configuration
* Use slash commands, including available skills as slash commands, when the editor supports them

<Note>
  Editor support varies by ACP client. Poolside can expose modes, models, thought level, rewind, session history, session deletion, and slash commands over ACP, but your editor must support a capability before you can use it in the editor UI.
</Note>

## Set up the Zed editor

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

This writes Poolside agent configuration to `~/.config/zed/settings.json`. For more information, see [Zed documentation](https://zed.dev/docs/ai/external-agents#add-more-agents).

If you prefer to configure Zed manually, add the following configuration to `~/.config/zed/settings.json`:

```json theme={null}
{
  "agent_servers": {
    "Poolside": {
      "command": "pool",
      "args": ["acp"],
      "type": "custom"
    }
  }
}
```

After you configure Zed, restart it and select **Poolside** from the agent picker.

## Set up JetBrains

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

This writes configuration to `~/.jetbrains/acp.json`. For more information, see [JetBrains documentation](https://www.jetbrains.com/help/ai-assistant/acp.html).

If you prefer to configure JetBrains manually, add the following configuration to `~/.jetbrains/acp.json`:

```json theme={null}
{
  "agent_servers": {
    "Poolside": {
      "command": "pool",
      "args": ["acp"]
    }
  }
}
```

After you configure JetBrains, restart the editor and select **Poolside** from the agent picker.

## Set up other editors

For editors without automated setup, point the editor's ACP configuration at `pool acp`:

```json theme={null}
{
  "command": "pool",
  "args": ["acp"]
}
```

To require a configured sandbox for the ACP server, pass `--sandbox required`:

```json theme={null}
{
  "command": "pool",
  "args": ["acp", "--sandbox", "required"]
}
```

Use `--sandbox disabled` only when you want the ACP server to run without a configured sandbox.

Thought level is an ACP session config option, not a `pool acp` command-line flag. When your editor exposes ACP session config options, configure thought level from the editor's agent or session settings.

<Note>
  Use thought level control only with models behind OpenRouter or another provider that accepts the OpenRouter-style `reasoning` field. If the underlying model connects directly to the OpenAI Chat Completions API at `https://api.openai.com/v1/chat/completions`, requests that include the `reasoning` field fail because OpenAI rejects the field.

  For Claude 4.6 models through OpenRouter, effort settings other than `none` are ignored. OpenRouter uses adaptive thinking automatically for those requests.
</Note>

If an MCP server expects environment variables, make sure your editor starts `pool acp` with those variables set.

## Set up Neovim with CodeCompanion

If you use Neovim with the `codecompanion.nvim` plugin, configure Poolside as an ACP-backed adapter:

```lua theme={null}
{
    "olimorris/codecompanion.nvim",
    dependencies = {
        "nvim-lua/plenary.nvim",
        "nvim-treesitter/nvim-treesitter",
    },
    opts = {
        strategies = {
            chat = { adapter = "poolside" },
            inline = { adapter = "poolside" },
        },
        adapters = {
            poolside = function()
                return {
                    name = "poolside",
                    formatted_name = "Poolside",
                    type = "acp",
                    commands = {
                        default = { "pool", "acp" },
                    },
                }
            end,
        },
    },
}
```

## Modes

| Mode         | ID             | What it does                                                                    |
| ------------ | -------------- | ------------------------------------------------------------------------------- |
| Always ask   | `default`      | Prompts for approval on first use of each tool                                  |
| Accept edits | `accept-edits` | Auto-approves workspace file reads and writes, then prompts for everything else |
| Allow all    | `always-allow` | Approves tool actions automatically                                             |
| Plan         | `plan`         | Plans changes without modifying your codebase                                   |

Mode switching depends on your editor client. If the editor does not expose ACP session modes, you may not be able to change modes from the UI.

## Slash commands

`pool acp` handles these slash commands when your editor passes them to the server. Compatible clients may show commands that `pool acp` makes available in a command picker or autocomplete menu.

Poolside also exposes available skills as slash commands to compatible ACP clients. The available skill commands depend on the skills configured for the agent and workspace.

| Command                  | What it does                                                                                                                                   |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `/plan`                  | Switch to plan mode                                                                                                                            |
| `/clear`                 | Clear conversation history and free up context                                                                                                 |
| `/compact [<guidance>]`  | Compact conversation context. Add guidance after the command to tell the agent what to preserve, such as `/compact preserve tool call errors`. |
| `/share`                 | Get the trajectory viewer URL for the current session when trajectory sharing is available                                                     |
| `/rename`                | Rename the current session                                                                                                                     |
| `/mcp`                   | Show MCP servers, connection status, and tools for the current session                                                                         |
| `/sandbox`               | Show local sandbox configuration                                                                                                               |
| `/sandbox-apply-to-host` | Review pending sandbox filesystem changes and apply them to the host workspace when available                                                  |
| `/usage`                 | Show token usage, context window state, and session cost for the current session when available                                                |
| `/skills`                | Refresh and list available skills                                                                                                              |

## Related resources

* [Poolside Agent CLI](/cli/pool)
* [Interactive mode](/cli/interactive-mode)
* [Install](/cli/install)
* [Troubleshoot Poolside Agent CLI](/cli/troubleshooting#troubleshoot-editor-acp-connections)
* [CLI reference](/cli/cli-reference)