@@ -47,6 +47,19 @@ Every time the model performs an edit, you should see a "Restore Checkpoint" but
The checkpoint button appears even if you interrupt the thread midway through an edit, as this is likely a moment when you've identified that the agent is not heading in the right direction and you want to revert back.
+### Context Menu {#context-menu}
+
+Right-click on any agent response in the thread view to access a context menu with the following actions:
+
+- **Copy Selection**: Copies the currently selected text as Markdown (available when text is selected).
+- **Copy This Agent Response**: Copies the full text of the agent response you right-clicked on.
+- **Scroll to Top / Scroll to Bottom**: Scrolls to the beginning or end of the thread, depending on your current position.
+- **Open Thread as Markdown**: Opens the entire thread as a Markdown file in a new tab.
+
+### Navigating the Thread {#navigating-the-thread}
+
+In long conversations, use the scroll button at the bottom of the panel to jump to your most recent prompt.
+
### Navigating History {#navigating-history}
To quickly navigate through recently updated threads, use the {#kb agent::ToggleNavigationMenu} binding when focused on the panel's editor, or click the menu icon button at the top right of the panel.
@@ -54,6 +67,8 @@ Doing that will open a dropdown that shows you your six most recently updated th
To view all historical conversations, reach for the `View All` option from within the same menu or via the {#kb agent::OpenHistory} binding.
+Thread titles are auto-generated based on the conversation content. To regenerate a title, open the ellipsis menu in the top right of the panel and select "Regenerate Thread Title".
+
### Following the Agent {#following-the-agent}
Follow the agent as it reads and edits files by clicking the crosshair icon at the bottom left of the panel. Your editor will jump to each file the agent touches.
@@ -138,6 +153,8 @@ You can explore the exact tools enabled in each profile by clicking on the profi
Alternatively, you can also use either the command palette, by running {#action agent::ManageProfiles}, or the keybinding directly, {#kb agent::ManageProfiles}, to have access to the profile management modal.
+Use {#kb agent::CycleModeSelector} to switch between profiles without opening the modal.
+
#### Custom Profiles {#custom-profiles}
You can also create a custom profile through the Agent Profile modal.
@@ -150,6 +167,8 @@ Zed will store this profile in your settings using the same profile name as the
All custom profiles can be edited via the UI or by hand under the `agent.profiles` key in your `settings.json` file.
+To delete a custom profile, open the Agent Profile modal, select the profile you want to remove, and click the delete button.
+
### Tool Approval
Zed's Agent Panel surfaces the `agent.always_allow_tool_actions` setting that, if turned to `false`, will require you to give permission to any editing attempt as well as tool calls coming from MCP servers.
@@ -59,7 +59,7 @@ Your IAM policy should look similar to:
}
```
-With that done, choose one of the two authentication methods:
+With that done, choose one of the three authentication methods:
#### Authentication via Named Profile (Recommended)
@@ -87,6 +87,27 @@ To do this:
3. Open the Agent Configuration with (`agent: open settings`) and go to the Amazon Bedrock section
4. Copy the credentials from Step 2 into the respective **Access Key ID**, **Secret Access Key**, and **Region** fields.
+#### Authentication via Bedrock API Key
+
+Amazon Bedrock also supports [API Keys](https://docs.aws.amazon.com/bedrock/latest/userguide/api-keys-use.html), which authenticate directly without requiring IAM users or named profiles.
+
+1. Create an API Key in the [Amazon Bedrock Console](https://console.aws.amazon.com/bedrock/)
+2. Open the Agent Configuration with (`agent: open settings`) and go to the Amazon Bedrock section
+3. Enter your Bedrock API key in the **API Key** field and select your **Region**
+
+```json [settings]
+{
+ "language_models": {
+ "bedrock": {
+ "authentication_method": "api_key",
+ "region": "your-aws-region"
+ }
+ }
+}
+```
+
+The API key itself is stored securely in your OS keychain, not in your settings file.
+
#### Cross-Region Inference
The Zed implementation of Amazon Bedrock uses [Cross-Region inference](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) to improve availability and throughput.
@@ -9,6 +9,8 @@ Zed uses the [Model Context Protocol](https://modelcontextprotocol.io/) to inter
Zed currently supports MCP's [Tools](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) and [Prompts](https://modelcontextprotocol.io/specification/2025-11-25/server/prompts) features.
We welcome contributions that help advance Zed's MCP feature coverage (Discovery, Sampling, Elicitation, etc).
+Zed also handles the `notifications/tools/list_changed` notification from MCP servers. When a server adds, removes, or modifies its available tools at runtime, Zed automatically reloads the tool list without requiring a server restart.
+
## Installing MCP Servers
### As Extensions
@@ -64,6 +64,14 @@ Deletes a file or directory (including contents recursively) at the specified pa
Edits files by replacing specific text with new content.
+### `restore_file_from_disk`
+
+Reloads a file from disk, discarding any unsaved changes in the buffer.
+
+### `save_file`
+
+Saves a buffer's current contents to disk, preserving unsaved changes before the agent modifies the file.
+
### `move_path`
Moves or renames a file or directory in the project, performing a rename if only the filename differs.