dguiducci
7769b6689d
Nightly Build / build (push) Has been cancelled
- list_files: new with_metadata parameter returns {path, line_count?, size}
per entry (both disk and memory-docs) so the agent can spot large files
worth outlining before reading
- ast_outline: replaced flat tree-sitter JSON walker with a recursive one
that shows nested keys at every depth, with inline scalar values and
container summaries
- message_builder: format active MCP connectors as a table with description
instead of a bare bullet list
- read_file description now hints to use get_ast_outline first
- tools.md: agent guidance to outline before reading
823 B
823 B
Tools
Scratchpad notes (update_scratchpad) are shared across all agents in the session and injected into every agent's context. Not persisted across sessions. Keep values concise. For a private task list that sub-agents should not see, use write_todos instead.
Understanding code before you read it
When you need to understand source code you don't already know, reach for get_ast_outline before read_file — especially on a large file. It returns the file's structure and the line range of every definition at a fraction of the tokens. Then read_file only the ranges you actually need. Reading a whole unfamiliar file wastes context; outline first, read narrow. (list_files with with_metadata=true reports each file's size and line count, so you can spot which files are worth outlining.)