Agent tools
The tools the agent can call, what each one does, and how it shows in the transcript.
#Files and code
| Tool | What it does |
|---|
query_code_graph | Returns the source of the symbols that a question is about, and the call path between them. Also answers schema questions. The agent's first stop. See Code graph. |
read_file | Reads a file from the workspace or from a directory that you added, 100 lines at a time by default. Also lists directories. |
write_file | Writes a file's whole text, creating or replacing it. |
edit_file | Replaces exact text in a file. Several edits to one file apply together or not at all. |
retrieve | Returns the full content of an older result that was shortened. |
#Commands
| Tool | What it does |
|---|
shell | Runs a command and returns its output, or a session id when it's still running after yield_time_ms. See Commands & the terminal. |
write_stdin | Polls a running command, types into it, or sends Ctrl-C. |
#Web
| Tool | What it does |
|---|
web_search | Searches the public web. Returns source URLs, highlights and dates. |
web_fetch | Fetches one public page by URL as Markdown. |
#Planning and asking
| Tool | What it does |
|---|
ask_user | Asks you one to three questions, each with two to four options. You can type your own answer. |
enter_plan_mode | Switches the session to plan mode. |
propose_plan | Hands you a plan and waits for your verdict. |
update_plan | Reports progress on an accepted plan's steps. |
update_goal | Says the goal this session runs has ended: complete, or blocked. |
goal_status | Reads the progress of this project's goals. |
#Agents and background work
| Tool | What it does |
|---|
task | Hands a task to an agent, isolated or with the conversation so far. |
close_agent | Closes a subagent and stops its running commands. |
check_task | Waits for a background task an MCP tool started. |
cancel_task | Stops a background task an MCP tool started. |
#Memory, sessions and skills
| Tool | What it does |
|---|
memory | Stores, recalls, links and searches memories. |
search_sessions | Searches or reads this project's earlier sessions. |
read_skill | Reads a skill's instructions or a file bundled with it. |
MCP servers add their own tools under their own names.
During a crew, the leader, the manager and the workers get their own tools:
| Tool | Used by | What it does |
|---|
task | Supervised leader | Sends one change to a worker as a checked task, with done_when, retry_of or steps. |
research | Supervised leader | Asks a read-only worker a question about the code. The answer gives file:line references. |
crew_status | Supervised leader | Lists, shows or stops the jobs of this conversation. |
crew_changes | Supervised leader | Discards a job that waits for a decision. Only you can apply one. |
crew_decide | Self-managed manager | Records the plan, edits the task list, and picks the next task or ends the run. |
reproduce | Supervised worker | Runs the test that reproduces the problem before the fix. |
finish | Workers | Reports the work as done. A Self-managed worker also gives the command that runs its test. |