Skip to content

Tool catalogue

Every action the agent takes is a typed function call. The list below is the full surface in v1 — there is no hidden eval-style escape hatch.

Filesystem

ToolDescriptionApproval
read_file(path, range?)Read part or all of a fileNone
list_dir(path)List a directoryNone
grep(pattern, glob?)Project-wide ripgrep searchNone
apply_patch(diff)Apply a unified diffPer-patch
write_file(path, content)Overwrite a filePer-file
delete_file(path)Move to OS trashPer-file, never bypassable

Terminal (L3 only)

ToolDescriptionApproval
run_command(cmd, cwd?)Execute a shell commandPer-command
kill_process(pid)Kill a process the agent startedNone

The terminal runs inside a sandboxed working directory pinned to the project root. cd .. outside the project root is blocked.

Git

ToolDescriptionApproval
git_statusgit status --porcelainNone
git_diff(staged?)Show staged or unstaged diffNone
git_commit(message)Stage and commit current changesPer-commit
git_branch(name)Create a branchPer-branch

Force-push and history rewrites are not exposed to the agent. You can still do them yourself in the terminal.

LSP

ToolDescription
find_symbol(name)Workspace-wide symbol search via LSP
goto_definition(file, position)Standard LSP go-to-definition
references(symbol)All references to a symbol

What is not a tool

  • HTTP requests to arbitrary URLs.
  • Reading environment variables (.env is excluded by default).
  • Writing outside the project root.
  • Running daemons that survive the agent session.