repo_map read
Token-budgeted aider-style outline of ranked files and key symbols.
When to use it
Onboarding the agent to an unfamiliar repo. Returns a high-signal map at a fixed token budget instead of a directory listing.
Input
{ "budgetTokens": 4000 }cross_search read
Search one term across code chunks, schema objects, RPC/trigger bodies, routes, and memories.
When to use it
Broad indexed search when you want to know everywhere a name appears — not just in app code, but in DB and Reef memories too. Use verbosity: "compact" on noisy hits.
Input
{ "term": "admin_audit_log", "limit": 20 }ast_find_pattern read
Run ast-grep structural search over fresh indexed JS/TS/JSX/TSX files.
When to use it
When you need real call sites, not text matches. Catches defaulted exports, dynamic imports, and patterns grep can't see.
Input
{
"pattern": "supabase.from($TABLE)",
"languages": ["ts", "tsx"],
"pathGlob": "app/**/*.tsx",
"maxMatches": 200
}live_text_search read
Live ripgrep over the working tree for exact disk text. Defaults to fixed-string search.
When to use it
After edits. The index may be stale; live_text_search reads from the current filesystem.
Input
{
"query": "verifySession(",
"pathGlob": "lib/**/*.ts",
"fixedStrings": true,
"maxMatches": 100
}symbols_of read
List indexed symbols declared in a file.
When to use it
Quick way to learn what a file exposes without re-reading the file.
imports_impact read
Trace indexed files that depend on a file.
When to use it
Before any rename or breaking change. Returns the import graph of dependents — including barrel re-exports.
Input
{ "filePath": "lib/users/queries.ts", "limit": 200 }See How to refactor safely for the full workflow.
imports_hotspots read
Most widely-imported files in the project.
When to use it
"Where does the most damage start?" — refactoring centrality.
imports_cycles read
Detect circular imports across the indexed module graph.
exports_of read
List exports surfaced by a file. Useful as a preflight before editing the file's public surface.
imports_deps read
What this file imports, and from where. Inverse of imports_impact.