swarmvault watch

Watch the inbox directory and trigger import and compile cycles when files change.

Usage

swarmvault watch [--lint] [--debounce <ms>]

Options

  • --lint - Run lint after each compile cycle
  • --debounce <ms> - Debounce file changes before running a cycle. Default: 900

What It Does

Each watch cycle:

  1. Imports new or changed inbox files
  2. Runs swarmvault compile
  3. Optionally runs swarmvault lint
  4. Appends a structured run record to state/jobs.ndjson

Notes

  • Watch mode is a foreground local worker in the current release
  • It watches the configured inbox only
  • Rapid bursts of file changes are coalesced into a single cycle