Tools

The coding agent does not invent file changes in chat - it calls a registered tool. Below is the full registry used by the agent loop.

Filesystem

read_file

Read a file (optional start_line / end_line).

read_file · path, start_line?, end_line?

read_files

Batch-read multiple paths (first ~200 lines each).

read_files · paths[]

list_directory

List entries in a workspace directory.

list_directory · path?

file_info

Metadata for a path.

file_info · path

ensure_dir

Create a directory (and parents) if missing.

ensure_dir · path

write_file

Create or overwrite a file. Goes through approval when required.

write_file · path, content
  • Preview / diff before apply
  • Tracks files_changed

write_files

Batch write multiple files in one tool call.

write_files · files[{{path, content}}]

replace_in_file

Exact-match find/replace in a file.

replace_in_file · path, old, new

apply_edits

Apply a structured set of edits.

apply_edits · edits[]

delete_file

Delete a file (approval).

delete_file · path

search_text

Ripgrep-style text search in the workspace.

search_text · query, path?, glob?

glob_files

Find files by glob pattern.

glob_files · pattern

code_search

Higher-level code-oriented search.

code_search · query

Shell

run_command

Run a shell command inside the workspace.

run_command · command, cwd?, timeout_seconds?
  • Approval + dangerous-pattern classification
  • Default timeout 120s
  • Captures stdout/stderr + exit code

Treat every approved shell command as if you typed it. Prefer ask mode until you trust the workspace.

Verify

verify_project

Run project verification (compile/tests style checks) before finishing.

verify_project · …
  • Used to prove work (e.g. py_compile, pytest)
  • Can require approval for shell underneath

Git

git_status

Working tree status.

git_status

git_diff

Show diffs.

git_diff · path?

git_log

Recent commits.

git_log · n?

git_add

Stage paths (approval).

git_add · paths[]

git_commit

Create a commit (approval).

git_commit · message

Project

inspect_project

Inspect project structure / stack hints.

inspect_project

list_dependencies

Surface dependency manifests.

list_dependencies

project_health

Health-oriented project snapshot.

project_health

Analysis & finish

analyze_code

Analyze a code path for the agent’s planning.

analyze_code · path

finish_task

End the agent loop with a human-readable summary.

finish_task · summary
  • Required for a clean Done state

Todos

todo_write

Update in-session todos for multi-step work.

todo_write · items[]

Slash commands like /review are separate from these tools - they are REPL utilities. The agent uses the registry above during plain-text tasks.