windsurf_tools.md

All Available Tools with Arguments

File Operations

read_file

Parameter	Type	Required	Description
file_path	string	Yes	Absolute path to the file to read
offset	integer	No	1-indexed line number to start reading from (for files >1000 lines)
limit	integer	No	Number of lines to read (use with offset)

write_to_file

Parameter	Type	Required	Description
TargetFile	string	Yes	Absolute path to the file to create
CodeContent	string	No	The code contents to write
EmptyFile	boolean	No	Set true to create an empty file

edit

Parameter	Type	Required	Description
file_path	string	Yes	Absolute path to the file to modify
old_string	string	Yes	Text to replace (must be unique unless replace_all)
new_string	string	Yes	Replacement text (must differ from old_string)
replace_all	boolean	No	Replace all occurrences (default false)
explanation	string	No	Description of the change

multi_edit

Parameter	Type	Required	Description
file_path	string	Yes	Absolute path to the file
edits	array	Yes	Array of edit objects with old_string, new_string, replace_all
explanation	string	No	Description of the changes

list_dir

Parameter	Type	Required	Description
DirectoryPath	string	Yes	Absolute path to the directory to list

find_by_name

Parameter	Type	Required	Description
SearchDirectory	string	Yes	Directory to search within
Pattern	string	No	Glob pattern to search for
Extensions	array	No	File extensions to include (without leading .)
Excludes	array	No	Glob patterns to exclude
Type	string	No	Filter: file, directory, or any
MaxDepth	integer	No	Maximum search depth
FullPath	boolean	No	Match full absolute path vs filename only

grep_search

Parameter	Type	Required	Description
Query	string	Yes	Search term or regex pattern
SearchPath	string	Yes	Path to search (file or directory)
Includes	array	No	Glob patterns to filter files (e.g., *.go)
CaseSensitive	boolean	No	Case-sensitive search (default false)
FixedStrings	boolean	No	Treat query as literal string, not regex
MatchPerLine	boolean	No	Show surrounding context with matches

---

Code Navigation

code_search

Parameter	Type	Required	Description
search_term	string	Yes	Natural language query describing what to find
search_folder_absolute_uri	string	Yes	Absolute path to search folder

---

Jupyter Notebooks

read_notebook

Parameter	Type	Required	Description
AbsolutePath	string	Yes	Absolute path to the .ipynb file

edit_notebook

Parameter	Type	Required	Description
absolute_path	string	Yes	Absolute path to the .ipynb file
cell_number	integer	No	0-indexed cell number (default 0)
cell_id	string	No	Alternative to cell_number
new_source	string	No	New content for the cell
cell_type	string	No	code or markdown (required for insert)
edit_mode	string	No	replace, insert, or delete (default replace)

---

Terminal Commands

run_command

Parameter	Type	Required	Description
CommandLine	string	Yes	Exact command to execute
Cwd	string	Yes	Current working directory
Blocking	boolean	Yes	Wait for completion (true) or run async (false)
SafeToAutoRun	boolean	No	If true, run without user approval
WaitMsBeforeAsync	integer	No	Ms to wait before going async (for non-blocking)

command_status

Parameter	Type	Required	Description
CommandId	string	Yes	ID of the background command
OutputCharacterCount	integer	No	Number of characters to view
WaitDurationSeconds	integer	No	Seconds to wait for completion (max 60)

read_terminal

Parameter	Type	Required	Description
ProcessID	string	Yes	Process ID of the terminal
Name	string	No	Name of the terminal

---

Task Management

update_plan

Parameter	Type	Required	Description
plan	array	Yes	Array of `{step: string, status: "pending"
explanation	string	No	Explanation of plan update

---

Web & URLs

read_url_content

Parameter	Type	Required	Description
Url	string	Yes	HTTP/HTTPS URL to fetch

view_content_chunk

Parameter	Type	Required	Description
document_id	string	Yes	ID of previously fetched document
position	integer	Yes	Chunk position to view

search_web

Parameter	Type	Required	Description
query	string	Yes	Search query
domain	string	No	Domain to prioritize

browser_preview

Parameter	Type	Required	Description
Url	string	Yes	URL with scheme, domain, and port (e.g., http://localhost:8080)
Name	string	Yes	Short 3-5 word title for the preview

---

Deployment

read_deployment_config

Parameter	Type	Required	Description
ProjectPath	string	Yes	Full absolute project path

deploy_web_app

Parameter	Type	Required	Description
ProjectPath	string	Yes	Full absolute project path
Framework	string	Yes	Framework enum (nextjs, react, svelte, etc.)
Subdomain	string	No	Subdomain for new sites
ProjectId	string	No	Project ID for existing sites

check_deploy_status

Parameter	Type	Required	Description
WindsurfDeploymentId	string	Yes	Deployment ID to check

---

Memory System

create_memory

Parameter	Type	Required	Description
Action	string	Yes	create, update, or delete
Content	string	No	Memory content (for create/update)
Title	string	No	Descriptive title (for create/update)
Id	string	No	Memory ID (for update/delete)
Tags	array	No	Tags for filtering (snake_case)
CorpusNames	array	No	Associated workspace corpus names
UserTriggered	boolean	No	True if user explicitly requested

---

Trajectories

trajectory_search

Parameter	Type	Required	Description
ID	string	Yes	Cascade ID or trajectory ID
Query	string	Yes	Search query (empty returns all steps)
SearchType	string	Yes	cascade for conversations

---

MCP (Model Context Protocol)

list_resources

Parameter	Type	Required	Description
ServerName	string	Yes	Name of the MCP server

read_resource

Parameter	Type	Required	Description
ServerName	string	Yes	Name of the MCP server
Uri	string	Yes	Resource URI