de>scriptor
Reference

CLI Reference
One Binary, Every Command

Index and embed your codebase, search it, analyze it, manage language servers, and launch the MCP server — all from the single devscriptor binary.

Global options

-d, --database <FILE>-v, --verbose-V, --version-h, --help

Index & Embed

3

scan

scan [OPTIONS] <PATH>

Parse a codebase and build the knowledge graph (fast; never loads the ONNX model).

Options

-i, --include <EXTS>Comma-separated file extensions to include
-e, --exclude <PATTERNS>Comma-separated glob patterns to exclude
--incrementalSkip unchanged files (mtime+size+hash manifest)
--embedGenerate embeddings inline (requires ~4 GB free RAM)
--skip-embeddingsForce-skip embeddings (useful in CI)
--bulk-loadFaster FTS5 for fresh full scans

Examples

devscriptor scan ./my-project
devscriptor scan ./my-project -i py -e tests/,*_test.py
devscriptor scan ./my-project --incremental
devscriptor scan ./my-project --bulk-load

watch

watch [OPTIONS] <PATH>

Keep the graph current in real time — incremental re-scan on every source change until Ctrl-C.

Options

-i, --include <EXTS>Restrict to these extensions
-e, --exclude <GLOBS>Exclude paths matching these globs
--embedRe-embed changed entities inline after each re-scan
--debounce-ms <MS>Quiet period before a re-scan (default 400)

Examples

devscriptor watch .
devscriptor --database ./devscriptor.db watch ./my-project --debounce-ms 250

embed

embed [OPTIONS]

Generate 768-dim vectors for entities that lack them, then unload the model. Idempotent.

Options

--batch-size <N>Entities per ONNX call (default 64)
--forceRe-embed entities that already have vectors
-d, --database <FILE>Database to embed

Examples

devscriptor embed
devscriptor embed --batch-size 256
devscriptor embed --force

The two-phase workflow

  • •devscriptor scan is always fast and never loads the model — FTS5 keyword search and structural queries are ready in seconds.
  • •devscriptor embed backfills semantic vectors on demand (≥ 4 GB free RAM) and is idempotent — re-runs only embed what changed.
  • •Run devscriptor --help or devscriptor <command> --help for full details on any command.