zeph-index

AST-based code indexing and semantic retrieval for Zeph.

Overview

Parses source files with tree-sitter to extract symbols, chunks them for embedding, and stores vectors in Qdrant for semantic code search. Generates concise repo maps that can be injected into the agent context. Feature-gated behind index.

Key Modules

• indexer — orchestrates file discovery, parsing, and embedding pipeline
• retriever — semantic search over indexed symbols and chunks
• store — persistence layer; vector operations go through the VectorStore trait from zeph-memory (backed by Qdrant)
• repo_map — generates tree-style repository summaries
• watcher — filesystem watcher for incremental re-indexing
• error — IndexError error types

Installation

cargo add zeph-index

Enabled via the index feature flag on the root zeph crate.

[!NOTE] zeph-index does not depend on qdrant-client directly. Vector storage is delegated to zeph-memory, which owns the Qdrant client lifecycle.

License

MIT