Agent Tools
Agent uses tools to interact with your codebase and the outside world. Every tool call is visible in the session log — nothing happens behind the scenes.
You can see every tool call in real-time in the agent panel. Click any tool call to expand it and see the exact input and output.
File tools
read_file
Read the full contents of a file. Agent uses this constantly when exploring unfamiliar code.
write_file
Create a new file or completely replace an existing file's content.
edit_file
Make a targeted replacement within a file — change specific lines without rewriting the whole thing.
list_dir
List all files and directories within a given path to understand project structure.
Search tools
grep_search
Exact keyword search across files. Equivalent to ripgrep — fast, case-insensitive, with glob filtering.
semantic_search
Semantic (embedding-based) search that finds conceptually related code even when keywords don't match exactly.
view_file
Read a specific line range from a file. Used when Agent knows exactly which lines to look at.
Terminal tools
run_command
Run a shell command and read its stdout/stderr. Agent uses this to run tests, builds, linters, and installers.
run_background
Run a long-running command (like a dev server) in the background so Agent can continue working while it runs.
Web tools
read_url
Fetch a public URL and read its content as markdown. Used to read documentation, GitHub issues, and changelogs.
search_web
Search the web for a query and read the top results. Agent uses this when it needs to look up APIs, errors, or patterns.
MCP tools
MCP (Model Context Protocol) lets you extend Agent with custom tools. Once you connect an MCP server in Settings, all tools from that server become available to Agent automatically.
How Agent chooses tools
Agent doesn't call all tools at once. It selects the right tool for the moment based on the task. For example:
- To understand an error, Agent calls
read_fileto look at the code, thenrun_commandto reproduce it. - To implement a feature, Agent calls
semantic_searchto find patterns, thenedit_fileto make changes.
Disabling specific tools
In Settings → Agent → Tools, you can toggle off specific tools. For example, disable search_web in air-gapped environments, or disable run_command if you want Agent to propose commands without executing them.