handoff_read
Provides a one-call overview of files or folders with real line numbers, returning matching lines, code outlines, log profiles, and JSON/CSV shapes to guide targeted reads.
Instructions
A one-call overview of files or folders, in a fixed format with real line numbers. For one specific question, your own search and partial reads are usually cheaper. Code does the work, with no model: a named identifier or quoted string gets the matching lines; source code gets an outline (definitions, docstrings, constants); logs get a profile (each kind of line with counts, odd values, first big jump, rare lines in full); JSON and CSV get their shape. Plain text goes to the local model only if the user turned that on. The first line says which tool ran. Every line number is real: Read the lines that matter before acting on them.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"paths": "<paths>"
},
"name": "handoff_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root | No | Optional folder to show paths relative to. | |
| tool | No | Optional: force one tool. | |
| paths | Yes | Absolute file or folder paths. | |
| include | No | Optional file name patterns for folders, e.g. ["*.py"]. | |
| question | No | Optional: what you want to know. Put exact names in backticks to get their lines. |