diff --git a/docs/src/ai/by-company.md b/docs/src/ai/by-company.md
index e477bdf6b2..aaafe4668c 100644
--- a/docs/src/ai/by-company.md
+++ b/docs/src/ai/by-company.md
@@ -1,6 +1,6 @@
 ---
 title: AI by Company - Zed
-description: Find the right Zed setup path for OpenAI, ChatGPT, Codex, Claude, Gemini, Copilot, Cursor, OpenCode, Pi, OpenRouter, Bedrock, local models, and other AI tools.
+description: Find the right Zed setup path for OpenAI, ChatGPT, Codex, Claude, Gemini, Copilot, Cursor, OpenCode, Pi, Poolside, OpenRouter, Bedrock, local models, and other AI tools.
 ---
 
 # AI by Company
@@ -77,6 +77,15 @@ Cursor subscriptions do not configure Zed's LLM provider settings. If you want t
 
 Pi is an agent harness, not a Zed LLM subscription. Pi may support provider auth such as ChatGPT, Claude, or Copilot through its own setup flow.
 
+## Poolside {#poolside}
+
+| Path                    | Support level   | What you get                         | Account / billing               | Setup                                            |
+| ----------------------- | --------------- | ------------------------------------ | ------------------------------- | ------------------------------------------------ |
+| Poolside External Agent | Hosted in Zed   | Poolside in an External Agent thread | Poolside or configured provider | [External Agents](./external-agents.md#poolside) |
+| `pool` CLI              | Run in terminal | Native Poolside Agent CLI experience | Poolside or configured provider | [Terminal Threads](./terminal-threads.md)        |
+
+Install Poolside from the ACP Registry, configure Zed with the Poolside Agent CLI, or add Poolside as a Custom Agent. See [External Agents](./external-agents.md#poolside) for setup steps and platform-specific details.
+
 ## DeepSeek {#deepseek}
 
 | Path         | Support level     | What you get                        | Account / billing                               | Setup                                          |
diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md
index b8ed6aa5ad..e60dd32240 100644
--- a/docs/src/ai/external-agents.md
+++ b/docs/src/ai/external-agents.md
@@ -34,7 +34,7 @@ Common External Agents include:
 
 This list is curated, not exhaustive. Open the ACP Registry in Zed for the current list of available agents.
 
-For company-specific setup paths, including Claude, Codex, Gemini, OpenCode, Copilot, Cursor, and Pi, see [AI by Company](./by-company.md).
+For company-specific setup paths, including Claude, Codex, Gemini, OpenCode, Copilot, Cursor, Pi, and Poolside, see [AI by Company](./by-company.md).
 
 ## Claude Agent {#claude-agent}
 
@@ -84,6 +84,36 @@ Use Pi Coding Agent when you want Pi running as an ACP-integrated External Agent
 
 Pi is an agent harness, not a Zed LLM subscription. Configure any provider auth, subscriptions, tools, or model choices in Pi.
 
+## Poolside {#poolside}
+
+Use Poolside when you want Poolside running as an ACP-integrated External Agent in Zed.
+
+Install Poolside from the [ACP Registry](#registry), then start a Poolside thread from the Agent Panel or Threads Sidebar. If you haven't authenticated yet, the thread offers `Log in to Poolside`, which runs `pool login` in a terminal. Authentication and model selection are configured through Poolside, not Zed.
+
+To configure Poolside from the terminal instead, install the [Poolside Agent CLI](https://github.com/poolsideai/pool), then run:
+
+```sh
+pool acp setup --editor zed
+```
+
+This command always writes to `~/.config/zed/settings.json`, which is Zed's settings file on macOS and on Linux without a custom `XDG_CONFIG_HOME`. On Windows, or with a custom config directory, install from the registry or use the manual configuration below instead. You do not need to restart Zed. It detects the settings change automatically. Select `Poolside` from the new-thread menu.
+
+To configure it manually, install the [Poolside Agent CLI](https://github.com/poolsideai/pool), make sure `pool` is on your `PATH`, then add it as a [Custom Agent](#custom-agents):
+
+```json [settings]
+{
+  "agent_servers": {
+    "Poolside": {
+      "command": "pool",
+      "args": ["acp"],
+      "type": "custom"
+    }
+  }
+}
+```
+
+See [Poolside's Zed documentation](https://docs.poolside.ai/tools/zed) for more setup details.
+
 ## Start an External Agent Thread {#start-thread}
 
 Open the [Agent Panel](./agent-panel.md), then use the agent selector or the new-thread menu to start a thread with an installed External Agent.