From 1d0fde6009b3d1021143efe25ba5ffb28f44f9b7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mar=C3=ADa=20Craig?= Date: Wed, 13 May 2026 10:59:37 -0300 Subject: [PATCH] docs: Clarify how to open new threads from the empty state (#56640) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Clarifies that in the empty state, the "New Thread…" menu is exposed as the agent selector button on the left, rather than the `+` button in the top-right toolbar. Adds this note to the Getting Started sections for Gemini CLI, Claude Agent, and Codex in `external-agents.md`, and reorders the description in `agent-panel.md` to mention the empty state first. Release Notes: - N/A --- docs/src/ai/agent-panel.md | 2 +- docs/src/ai/external-agents.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md index 76e055666c..0187d3a0b2 100644 --- a/docs/src/ai/agent-panel.md +++ b/docs/src/ai/agent-panel.md @@ -34,7 +34,7 @@ The sections below cover what you can do from here. By default, the Agent Panel uses Zed's first-party agent. -Start a new thread with {#kb agent::NewThread}, or open the "New Thread…" menu via the `+` icon in the top-right of the panel toolbar (in the empty state, this menu is exposed as the agent selector button on the left). You can also open that menu with {#kb agent::ToggleNewThreadMenu}. +Start a new thread with {#kb agent::NewThread}, or open the "New Thread…" menu using the agent selector button on the left (in the empty state) or the `+` icon in the top-right of the panel toolbar. You can also open that menu with {#kb agent::ToggleNewThreadMenu}. From the "New Thread…" menu you can: diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md index 86df81e0a6..dd3f68d5b3 100644 --- a/docs/src/ai/external-agents.md +++ b/docs/src/ai/external-agents.md @@ -21,7 +21,7 @@ Under the hood we run Gemini CLI in the background, and talk to it over ACP. ### Getting Started -First open the agent panel with {#kb agent::ToggleFocus}, and then use the `+` button in the top right to start a new Gemini CLI thread. +First open the agent panel with {#kb agent::ToggleFocus}, and then start a new Gemini CLI thread using the agent selector button on the left (in the empty state) or the `+` button in the top right. If you'd like to bind this to a keyboard shortcut, you can do so by editing your `keymap.json` file via the {#action zed::OpenKeymapFile} command to include: @@ -64,7 +64,7 @@ Under the hood, Zed runs the Claude Agent SDK, which runs Claude Code under the ### Getting Started -Open the agent panel with {#kb agent::ToggleFocus}, and then use the `+` button in the top right to start a new Claude Agent thread. +Open the agent panel with {#kb agent::ToggleFocus}, and then start a new Claude Agent thread using the agent selector button on the left (in the empty state) or the `+` button in the top right. If you'd like to bind this to a keyboard shortcut, you can do so by editing your `keymap.json` file via the {#action zed::OpenKeymapFile} command to include: @@ -136,7 +136,7 @@ Under the hood, Zed runs Codex CLI and communicates to it over ACP, through [a d ### Getting Started As of version `0.208`, you should be able to use Codex directly from Zed. -Open the agent panel with {#kb agent::ToggleFocus}, and then use the `+` button in the top right to start a new Codex thread. +Open the agent panel with {#kb agent::ToggleFocus}, and then start a new Codex thread using the agent selector button on the left (in the empty state) or the `+` button in the top right. If you'd like to bind this to a keyboard shortcut, you can do so by editing your `keymap.json` file via the {#action zed::OpenKeymapFile} command to include: