Repository navigation
zg 0.3.1
zg 0.3.1 adds cross-file caller and callee lookup to the CLI and MCP. New indexes can choose a local embedding model based on workspace content, and full search previews now show the entire matching function or Markdown section. Existing 0.3.0 indexes remain searchable and can be updated without a rebuild.
Trace calls across files
Use --callers to find where a function is called and --callees to see what it calls. Each resolved call site includes its file and line. Agents can use the same lookups through the zvec_grep_callers and zvec_grep_callees MCP tools.
Enable graph indexing with zg --index --graph for a new workspace. For an existing index, run zg --index --rebuild --graph once. Then look up a symbol by name. For example, in zg’s own repository you can run
zg --callers resolve_embedding_reference
zg --callees resolve_embedding_referenceLocal embeddings that fit the workspace
If you haven’t chosen a model or configured a default, zg selects Potion Code (local/potion-code-16m-v2) for code-heavy workspaces and Bekko (local/bekko-256-int8) for text-heavy ones. Bekko is a new 256-dimensional model that runs locally on CPU. Existing indexes keep their model when you upgrade or rebuild.
Search and indexing improvements
--preview fullshows the complete indexed function or Markdown section even when only one fragment matched. Short previews prioritize the matching lines.- PHP search recognizes classes, traits, enums, functions, methods, and properties, including their signatures and docblocks. Templates and top-level statements stay searchable.
- zg recognizes Python scripts with
uv run --scriptshebangs and indexes plain text in files with unfamiliar extensions. - After an interrupted index update, zg can replay pending writes before serving a search. The file watcher also skips directory reads that previously triggered unnecessary work.
- The MCP installer accepts editor configuration files that use JSON with comments.
- Linux x64 and ARM64 binaries now target glibc 2.28.