This collects all documentation for git-ai.
git-ai is a global CLI:
- Default behavior acts like
git:git-ai status/commit/push/...proxies to systemgit. - AI capabilities are under
git-ai ai ...: Indexing, Retrieval, Packing, Hooks, MCP Server.
- Store structured code repository indexes under
.git-ai/, shareable via archive.git-ai/lancedb.tar.gz. - Enable Agents to hit symbols/snippets via MCP tools at low cost, then read files as needed.
- Persist per-commit semantic change as DSR (immutable, deterministic), and rebuild caches from it.
.git-ai/meta.json: Index metadata (locally generated, usually not committed)..git-ai/lancedb/: Local vector index directory (usually not committed)..git-ai/lancedb.tar.gz: Archived index (can be committed/tracked via git-lfs)..git-ai/ast-graph.sqlite: AST graph database (CozoDB)..git-ai/ast-graph.export.json: AST graph export snapshot (for non-SQLite backend cross-process reuse)..git-ai/dsr/<commit_hash>.json: Per-commit DSR (canonical artifact, immutable)..git-ai/dsr/dsr-index.sqlite: DSR query accelerator (rebuildable cache from DSR + Git).
- Installation & Quick Start (Chinese)
- Windows Setup Guide
- CLI Usage (Chinese)
- Hooks Workflow (Chinese)
- MCP Server Integration (Chinese)
- Manifest Workspace Support (Chinese)
- Troubleshooting (Chinese)
- DSR (Deterministic Semantic Record) (Chinese)
- Advanced: Index Archiving & LFS (Chinese)
- Architecture Design (Chinese)
- Development Rules (Chinese)
- Cross-Encoder Reranking (English)
- MCP Skill & Rule Templates (Chinese)