By 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 # 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