LangSync

langsync watch

Watch locale files and run incremental sync plus validation on change.

langsync watch monitors your input directory and, on every change, runs an incremental sync followed by validation. It prints a compact summary so you get instant feedback while editing translations.

Namespaces not yet supported

langsync watch does not support the namespaces layout yet. If your config defines a namespaces block, watch exits with an error. Use sync and validate directly for namespaced projects until watch support lands.

Usage

langsync watch [--dry-run] [--debounce <ms>]

Flags

FlagDefaultDescription
--dry-runfalseReport planned writes without modifying files.
--debounce <ms>200Debounce window for rapid, successive file changes.

Behavior

  • An initial pass runs immediately so you see the current state.
  • File changes are debounced to coalesce rapid saves.
  • Each pass syncs keys from the reference locale, then validates all locales.
  • Only changed locale files are written (incremental sync).
  • Press Ctrl+C to stop watching.

On this page