linear-canal watch

Keep your index live as you code.

Basic Usage

linear-canal watch

Watches all tracked files. On change, it re-runs the Scout → Graph → Vectors → Context pipeline for the modified files only (incremental update).

Options

linear-canal watch --recompile   # force full ctx recompile on start
linear-canal watch --no-vectors  # skip vector re-embedding (faster)

How it Works

1. A file-system watcher detects saves in your project directory.
2. Changed files are re-scanned by the Scout Engine.
3. The Knowledge Graph is updated for affected nodes only.
4. Embeddings are regenerated for changed chunks.
5. The Context Compiler rewrites the affected .ctx files.

A sentinel file (.lc_sentinel) prevents external writes from overwriting managed ctx files.