# Mars167 Git AI CLI Git AI Code Search

> git-ai Code Search

- Skill: `tomevault-io/mars167-git-ai-cli-git-ai-code-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/mars167-git-ai-cli-git-ai-code-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mars167-git-ai-cli-git-ai-code-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/mars167-git-ai-cli-git-ai-code-search

---


# 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:
```bash
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

1. **Always pass `path`** - Every tool requires explicit repository path
2. **Check index first** - Run `check_index` before search tools
3. **Read before modify** - Use `read_file` to understand code before changes

## References

- [Tool Documentation](references/tools.md)
- [Behavioral Constraints](references/constraints.md)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/mars167) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->