From 94aa643484e294b20afff67b662e4e7dd01f6c3c Mon Sep 17 00:00:00 2001
From: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Date: Sat, 8 Nov 2025 12:54:42 -0300
Subject: [PATCH] docs: Update agent tools page (#42271)

Release Notes:

- N/A
---
 docs/src/ai/tools.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/docs/src/ai/tools.md b/docs/src/ai/tools.md
index 06e80a863dfd7141500d48db4ad3b4ff0552305c..e40cfcec840402ec881ecd29e9e3358a433c8d6f 100644
--- a/docs/src/ai/tools.md
+++ b/docs/src/ai/tools.md
@@ -1,12 +1,14 @@
 # Tools
 
-Zed's Agent has access to a variety of tools that allow it to interact with your codebase and perform tasks.
+Zed's built-in agent has access to a variety of tools that allow it to interact with your codebase and perform tasks.
 
 ## Read & Search Tools
 
 ### `diagnostics`
 
 Gets errors and warnings for either a specific file or the entire project, useful after making edits to determine if further changes are needed.
+When a path is provided, shows all diagnostics for that specific file.
+When no path is provided, shows a summary of error and warning counts for all files in the project.
 
 ### `fetch`
 
@@ -54,10 +56,6 @@ Copies a file or directory recursively in the project, more efficient than manua
 
 Creates a new directory at the specified path within the project, creating all necessary parent directories (similar to `mkdir -p`).
 
-### `create_file`
-
-Creates a new file at a specified path with given text content, the most efficient way to create new files or completely replace existing ones.
-
 ### `delete_path`
 
 Deletes a file or directory (including contents recursively) at the specified path and confirms the deletion.