tools.md

 1# Tools
 2
 3Zed's Agent has access to a variety of tools that allow it to interact with your codebase and perform tasks:
 4
 5- **`copy_path`**: Copies a file or directory recursively in the project, more efficient than manually reading and writing files when duplicating content.
 6- **`create_directory`**: Creates a new directory at the specified path within the project, creating all necessary parent directories (similar to `mkdir -p`).
 7- **`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.
 8- **`delete_path`**: Deletes a file or directory (including contents recursively) at the specified path and confirms the deletion.
 9- **`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.
10- **`edit_file`**: Edits files by replacing specific text with new content.
11- **`fetch`**: Fetches a URL and returns the content as Markdown. Useful for providing docs as context.
12- **`list_directory`**: Lists files and directories in a given path, providing an overview of filesystem contents.
13- **`move_path`**: Moves or renames a file or directory in the project, performing a rename if only the filename differs.
14- **`now`**: Returns the current date and time.
15- **`find_path`**: Quickly finds files by matching glob patterns (like "\*_/_.js"), returning matching file paths alphabetically.
16- **`read_file`**: Reads the content of a specified file in the project, allowing access to file contents.
17- **`grep`**: Searches file contents across the project using regular expressions, preferred for finding symbols in code without knowing exact file paths.
18- **`terminal`**: Executes shell commands and returns the combined output, creating a new shell process for each invocation.
19- **`thinking`**: Allows the Agent to work through problems, brainstorm ideas, or plan without executing actions, useful for complex problem-solving.
20- **`web_search`**: Searches the web for information, providing results with snippets and links from relevant web pages, useful for accessing real-time information.