git-ai Code Search
Semantic code search with AST analysis and change tracking.
Quick Start
For Agents - 3-step pattern:
1. check_index({ path }) → verify index exists
2. semantic_search({ path, query }) → find relevant code
3. read_file({ path, file }) → read the actual code
For Users - build index first:
cd your-repo
git-ai ai index # build index
git-ai ai semantic "authentication logic" # search
Core Tools
| Need | Tool | Example |
|---|---|---|
| Search by meaning | semantic_search | { path, query: "error handling", topk: 10 } |
| Search by name | search_symbols | { path, query: "handleAuth", mode: "substring" } |
| Who calls X | ast_graph_callers | { path, name: "processOrder" } |
| What X calls | ast_graph_callees | { path, name: "processOrder" } |
| Call chain | ast_graph_chain | { path, name: "main", direction: "downstream" } |
| Project overview | repo_map | { path, max_files: 20 } |
Rules
- Always pass
path- Every tool requires explicit repository path - Check index first - Run
check_indexbefore search tools - Read before modify - Use
read_fileto understand code before changes