Skip to content

Command reindex

Rafael Fragoso edited this page Jun 8, 2026 · 1 revision

Command: reindex

Re-chunk and re-embed changes since the last index.

Synopsis

columbus reindex [flags]

Description

Diffs the working tree against the last indexed state and updates only what changed: re-parses symbols and files with embedded tree-sitter (recording metadata + git anchors only, never code bodies) and refreshes their embedding vectors. Incremental by default. See Keeping the Index Fresh for guidance on modes.

Flags

Flag Description
--changed Fast path: only files dirty in the working tree
--full Reindex (and re-embed) everything from scratch (memories preserved)
--clean Drop all index data (preserves config and memories)
--status Report index state without writing
--no-embed Skip embeddings (metadata-only)

Plus global flags (--json, --llm, --no-color).

Examples

$ columbus reindex
  embedded:  2  skipped (unchanged): 5
  index now: 4 files
  working tree: clean

$ columbus reindex --status
  index now: 4 files (unchanged: 4)

Exit codes

0 success · 3 not initialized (run columbus install) · 4 transient (index writer locked — retry). See Exit Codes.

See also

Keeping the Index Fresh · Configuration · Supported Languages

Clone this wiki locally