Skip to main content
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. If your IDE already has a native Poolside Assistant integration, use that instead of ACP.

​
Set up the Zed editor

pool acp setup --editor zed
This writes Poolside agent configuration to ~/.config/zed/settings.json. For more information, see Zed documentation.

​
Set up the JetBrains IDE

pool acp setup --editor jetbrains
This writes configuration to ~/.jetbrains/acp.json. For more information, see JetBrains documentation. After running setup for either editor:
  1. Restart the editor.
  2. Open the agent or assistant picker.
  3. Select Poolside.

​
Set up other editors

For editors without automated setup, point the editor’s ACP configuration at pool acp: 
{
  "command": "pool",
  "args": ["acp"]
}
To pass flags to the ACP server, add them to the args array: 
{
  "command": "pool",
  "args": ["acp", "--reasoning", "high"]
}
For MCP server input variables, pool acp reads matching environment variables from its own process environment. If an MCP server expects KEY, make sure the editor launches pool acp with KEY set. Neovim with CodeCompanion 
{
    "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

ModeIDWhat it does
Always AskdefaultPrompts for approval on first use of each tool
Accept Editsaccept-editsAuto-approves workspace file reads and writes, then prompts for everything else
Always Allowalways-allowApproves tool actions automatically
PlanplanPlans changes without modifying your codebase
Mode switching depends on your editor client. Use /mode <id> if the editor doesn’t expose a mode picker.

​
Slash commands

Poolside advertises available slash commands to the client when a session starts. They may appear in a command picker or autocomplete menu, or you can type them directly into the prompt.
CommandWhat it does
/modeList available modes or switch modes
/planSwitch to plan mode
/clearClear conversation history and free up context
/shareGet the trajectory viewer URL for the current session
/usageShow token usage for the current session
/skillsRefresh and list available skills
/debug:clear-local-sessionsDelete locally persisted session history

​
Feature parity

The core agent capabilities are close to interactive mode, but exact support depends on the editor client:
  • Mode selection: Poolside ACP exposes session modes, including accept-edits and plan when available. Your editor must expose those controls for you to switch modes in the UI.
  • Model selection: Poolside ACP exposes model configuration separately from --reasoning. With standalone setup, selection is limited to the standalone model. When connected to a Poolside deployment, editors can expose deployment-specific agent or model choices if they support ACP session config options.
  • Rewind: Poolside ACP supports session rewind, but your editor has to expose that capability.
  • Session history: Poolside ACP supports persisted session history through ACP session listing and loading, but some editors do not expose history browsing in the UI.

​
Troubleshooting

Check ACP logs: 
pool acp logs -f
pool acp logs --pretty
Common issues:
  • pool not found: Add pool to your PATH or use the full path to the binary.
  • Auth errors in standalone mode: Run pool setup, then reconnect.
  • Auth errors when connected to a Poolside deployment: Run pool login, then reconnect.
  • Missing mode, history, rewind, or slash command: ACP capabilities depend on both your editor client and your Poolside account access.