Read a UTF-8 text file from the workspace with 1-based line numbers. Use this instead of another file-read tool when available: ToolAhead may return an exact prefetched result. Supports offset and limit for large files.

Search workspace file contents with a regular expression and return path:line:content matches. Use this instead of another grep/search tool when available: ToolAhead may return an exact prefetched result.

Find workspace files whose project-relative paths match a glob pattern. Use this instead of another glob/file-listing tool when available: ToolAhead may return an exact prefetched result.

Replace an exact string in a workspace text file. Use this ToolAhead edit after ToolAhead read_file; it follows the familiar file_path, old_string, new_string, and replace_all contract. Edits execute normally and are never prefetched, cached, or replayed.

Create or overwrite a UTF-8 workspace file using the familiar file_path and content contract. Writes execute normally and are never prefetched, cached, or replayed.

Run an exact deterministic test, build, or lint command that is listed in .prefetch-replay.json. ToolAhead may replay an identical prefetched result. Commands declared under [commands] in toolahead.toml also run here: their required services are started and health-checked first (never replayed). Use the agent's native shell for commands that are neither.