Overview
vg build maps your source code into a deterministic graph artifact (.vibgrate/graph.json), enabling all downstream code graph queries. Incremental: only re-processes changed files.
Usage
vg build [paths...]
| Flag | Default | Description |
|---|---|---|
[paths...] | . | Folders or files to map |
--only <langs> | — | Restrict to languages (e.g. ts,py,go) |
--exclude <glob> | — | Extra ignore glob (repeatable) |
--jobs <n> | auto | Worker count (1 = single-threaded) |
--scip <file> | auto-detect | Ingest a SCIP index for precise resolution |
--no-scip | — | Ignore any SCIP index |
--no-tsc | — | Skip the TypeScript resolver (heuristic floor only) |
--no-html | — | Do not write graph.html |
--no-report | — | Do not write GRAPH_REPORT.md |
--no-warm | — | Do not warm the semantic index after building |
--grammars <dir> | — | Grammar .wasm directory for offline/air-gapped use |
-o, --export <file> | — | Also write the map to a file (format from extension) |
Examples
# Map current directory
vg build
# Map specific folders only
vg build src/ lib/
# TypeScript only, single-threaded
vg build --only ts --jobs 1
# Export map to JSON as well
vg build -o map.json
Global Options
All graph commands accept: --cwd <dir>, --graph <file>, --json, --quiet, --local, --deep, --no-cache.