CodeGraph Voyage

codegraph-voyage is a symbol-level semantic retrieval sidecar for CodeGraph. It builds embeddings from .codegraph/codegraph.db, stores them separately in .codegraph/codegraph-voyage.db, and combines lexical and vector candidates for search and codegraph explore.

Use it when the user asks for semantic code search, hybrid lexical/vector retrieval, or a CodeGraph exploration seeded by semantically relevant symbols. Run commands from a project root containing .codegraph/codegraph.db and the tools/codegraph_voyage/ sidecar package.

CLI

python3 -m tools.codegraph_voyage index [--provider fake|voyage] [--dimensions N]
python3 -m tools.codegraph_voyage search "query" [--provider fake|voyage] [--top-k N] [--json]
python3 -m tools.codegraph_voyage status
python3 -m tools.codegraph_voyage explore "query" [--provider fake|voyage] [--dry-run]

search is also available as semantic_candidates. Index before searching when .codegraph/codegraph-voyage.db is absent or stale. Use status to inspect the CodeGraph and embedding indexes.

The fake provider is deterministic, offline, and suitable for development and CI. The voyage provider sends locally sanitized source-derived text to Voyage AI. Use it only when remote processing is acceptable.