Home Explore Blog CI



zed

docs/src/ai/tools.md
1133a8bb6cbacad8ed9a1929a1263d20204ac7f6daa13a520000000300000917
# Tools

Zed's 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.

### `fetch`

Fetches a URL and returns the content as Markdown. Useful for providing docs as context.

### `find_path`

Quickly finds files by matching glob patterns (like "\*_/_.js"), returning matching file paths alphabetically.

### `grep`

Searches file contents across the project using regular expressions, preferred for finding symbols in code without knowing exact file paths.

### `list_directory`

Lists files and directories in a given path, providing an overview of filesystem contents.

### `now`

Returns the current date and time.

### `open`

Opens a file or URL with the default application associated with it on the user's operating system.

### `read_file`

Reads the content of a specified file in the project, allowing access to file contents.

### `thinking`

Allows the Agent to work through problems, brainstorm ideas, or plan without executing actions, useful for complex problem-solving.

### `web_search`

Searches the web for information, providing results with snippets and links from relevant web pages, useful for accessing real-time information.

## Edit Tools

### `copy_path`

Copies a file or directory recursively in the project, more efficient than manually reading and writing files when duplicating content.

### `create_directory`

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.

### `edit_file`

Edits files by replacing specific text with new content.

### `move_path`

Moves or renames a file or directory in the project, performing a rename if only the filename differs.

### `terminal`

Executes shell commands and returns the combined output, creating a new shell process for each invocation.

Chunks
9a9c4c62 (1st chunk of `docs/src/ai/tools.md`)
Title: Zed Agent Tools Overview
Summary
This section details the various tools available to Zed's Agent, categorized into Read & Search and Edit tools. Read & Search tools like `diagnostics`, `fetch`, `find_path`, `grep`, and `read_file` enable the agent to access and understand the codebase. Edit tools such as `copy_path`, `create_file`, `delete_path`, and `edit_file` allow the agent to modify the codebase.