discover

Discover

Explore unfamiliar codebases, understand architecture, and learn how features work.

Tool Reference

Tool	Purpose
search	Unified search: symbol lookup or hybrid semantic+fulltext search
trace_dependencies	Find what depends on a symbol or what it depends on
diff_analysis	Map git changes to affected symbols
rename	Plan coordinated renames across the codebase
list_repos	List all indexed repositories
explore_structure	Get clusters and folder hierarchy in one call
health_check	Index staleness and coverage metrics

Resource URIs

URI	Description
code-index://overview	All indexed repositories
code-index://repo/{name}	Repository context and stats
code-index://repo/{name}/modules	Community modules
code-index://repo/{name}/flows	Execution flows
code-index://repo/{name}/flows/{name}	Flow detail
code-index://repo/{name}/symbol/{name}	Symbol detail
code-index://repo/{name}/metrics	Index health metrics

Exploration Workflow

1. Orient -- list_repos() then read code-index://repo/{name} for overview
2. Search -- search("how does auth work") with natural language
3. Dive -- search("SessionManager") for symbol context (auto-detected)
4. Trace -- Read code-index://repo/{name}/flows to follow execution paths
5. Map -- explore_structure() to see module boundaries and folder hierarchy

Graph Schema

Nodes: File, Folder, Module, Function, Class, Method, Interface, Variable, Community, Process

Edges: CONTAINS, CALLS, IMPORTS, EXTENDS, IMPLEMENTS, DEFINES, OVERRIDES, REFERENCES, MEMBER_OF, PARTICIPATES_IN