toolahead
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PREFETCH_MUTATION_DEBOUNCE_MS | No | The debounce window in milliseconds for grouping rapid file changes before starting predicted work. Set to '0' to disable grouping. Defaults to 50. | 50 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| read_fileA | 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. |
| searchA | 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. |
| list_filesA | 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. |
| edit_fileA | 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. |
| write_fileA | 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. |
| runA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a distinct file operation: reading, listing, searching, editing, writing, and running commands. There is no overlap or ambiguity among them.
Most tools follow verb_noun pattern (read_file, list_files, edit_file, write_file), but search and run are single verbs. The convention is mostly consistent and readable.
Six tools is a well-scoped set for a workspace file server with prefetching capabilities. Each tool serves a clear purpose without bloat.
The core file lifecycle (read, write, edit, list, search) is covered, plus command execution. A delete_file operation is missing, which agents may need, but it is a minor gap.