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. In TSX, object-literal or JSX-ambiguous patterns are auto-anchored when needed, so { ssr: false } can still match as an expression-shaped pattern.
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 daemon usually catches up indexed facts in the background, but live_text_search reads from the current filesystem immediately.
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.
reef_diff_impact read
Changed-file impact composer for the current working tree.
When to use it
After edits and before final diagnostics. It combines changed files, indexed import edges, related findings, and conventions so the agent can see which callers or rules may need another look.
Input
{ "filePaths": ["lib/users/queries.ts", "lib/users/index.ts"] }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.