BENZI TOOLS =========== Every tool Benzi's agent can call (36), with a one-line description. 20 of them are also served over MCP by benzi-mcp. [MCP] also available to other agents through benzi-mcp (read-only index tools) [agent] used by Benzi's own agent: VS Code extension and benzi-headless [VS Code] only in the VS Code extension, where there is a screen to talk to https://varianttech.net | https://github.com/oooscoos/Benzi FIND YOUR WAY AROUND -------------------- list_files [MCP] One directory level of the map: files, their top-level symbols, and where the code mass is. search_symbols [MCP] Turn a half-remembered name into a handle: functions, classes and bindings, fuzzy-matched. benzi_grep [MCP] Text search over the real files; every hit comes back with the function or class it sits in. list_dependencies [MCP] The libraries the repo leans on, ranked by how much it uses them. list_unlisted_files [MCP] Files the map does not index (configs, data, docs, assets), each with the reason. read_reference [MCP] Benzi's own reference notes: how the map fits together and what its IDs mean. UNDERSTAND ONE SYMBOL --------------------- get_definition [MCP] What a symbol is: signature, decorators, docstring, fields, and who calls or holds it. profile [MCP] The full 360 on one symbol in one call: what it is, does, affects, and what feeds its params. skim_source [MCP] A one-level outline: calls, branches, loops and returns in source order, indented to real nesting. read_source [agent] The exact source of one symbol, or just a window of lines from it. get_hierarchy [MCP] The resolved class tree: bases, full ancestry, subclasses and the methods each overrides. TRACE CALLS ----------- get_callers [MCP] Every function that calls this one, plus the callers that may reach it via dynamic dispatch. call_tree [MCP] The transitive closure: forward for what a route reaches, reverse for the full blast radius. trace_path [MCP] The chain between two functions, with the arguments carried along every hop, zipped to params. list_external_calls [MCP] Every stdlib / third-party call a file or symbol makes, with its arguments and line. list_unresolved_calls [MCP] Calls the compiler saw but could not settle, each with the reason, so nothing is silently guessed. TRACE DATA ---------- backflow [MCP] Where a value comes from: each parameter traced back to the literal or call it originates in. forwardflow [MCP] Where a return value ends up: every catcher walked forward to where it finally lands. UI CODE (HTML / CSS / DOM-JS) ----------------------------- markup_list_files [MCP] Which files carry UI (HTML, CSS, DOM-js) and how many anchors each holds. markup_find_anchor [MCP] Find a UI handle (an id, class or tag) by name. markup_get_definition [MCP] The anchor card: where a handle is declared, styled and grabbed, plus the winning cascade rule. RUN AND VERIFY -------------- shell [agent] Run a command in the project: tests, builds, linters, git, a repro. execute_from [agent] Run a file under the call tracer and record what actually happened, with real argument values. execute_generated_testcase [agent] The cheapest verify path: a short repro, run traced, handing back observed values or a traceback. check_last_execution [agent] Read what the last traced run observed: which target each ambiguous call really hit. EDIT ---- edit_lines [agent] Write into a file by line range or by a unique snippet; every write is syntax-checked. create_file [agent] Create a new file; it is indexed immediately and its symbols are queryable. delete_file [agent] Delete a file or folder; the map re-indexes so its symbols disappear. rollback_edit [agent] Undo the last N writes by snapshot reload: files and map together, no partial states. MEMORY (per repo, survives restarts) ------------------------------------ remember [agent] Save a durable, non-obvious fact: a convention, gotcha, decision or a bug's real origin. recall [agent] Read the full text behind a memory when it becomes relevant. forget [agent] Delete a memory that turned out wrong or stale. WORKING ON A TASK ----------------- update_plan [agent] A live checklist for a multi-step change, ticked off as the work happens. upgrade_to_pro [agent] Escalates itself to a larger reasoning budget mid-task, then drops back when done. TALKING TO YOU -------------- in_flight_message [VS Code] A short note while it keeps working, so you are not watching a blank pane. set_selection [VS Code] Highlights symbols on the on-screen graph to point your attention at them.