Built-in Tools

​

Overview

​

read

• Returns file contents with line numbers
• Automatically truncates large files
• Detects and labels binary files
• Resolves relative paths against the working directory

Agent: I'll read the main entry point.
→ read { path: "src/main.rs" }

​

write

• Creates parent directories if they don’t exist
• Overwrites existing files
• Subject to tool approval policy (default: ask)

Agent: I'll create a new configuration file.
→ write { path: "config.toml", content: "..." }

​

edit

• Requires exact match of old_string in the file
• Shows a unified diff of the change
• Supports diff review in external editor (VS Code / Cursor)
• Subject to tool approval and file edit review policies

Agent: I'll fix the bug in the parser.
→ edit { path: "src/parser.rs", old_string: "x + 1", new_string: "x + 2" }

​

bash

• Default 120-second timeout
• Subject to command safety blocklist
• Returns stdout, stderr, and exit code
• Can run in container sandbox when configured

Agent: I'll run the tests.
→ bash { command: "cargo test", timeout: 300 }

​

Command Safety

​

Tool Execution Modes

​

Hooks

{
  "hooks": [
    {
      "event": "Settled",
      "command": "echo 'Agent turn complete'"
    }
  ]
}