| name | git-ai-code-search |
| description | Semantic code search and codebase understanding using git-ai MCP tools. Use when: (1) Searching for symbols, functions, or semantic concepts, (2) Understanding project architecture, (3) Analyzing call graphs and code relationships. Triggers: "find X", "search for X", "who calls X", "where is X", "understand this codebase".
|
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
git-ai ai semantic "authentication logic"
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_index before search tools
- Read before modify - Use
read_file to understand code before changes
References
