Skip to main content

:::tip Looking for the recipe? See Workflows → Your daily dev loop for the task-driven guide. This page is the reference. :::

zuit watch

zuit watch [PATH]

Use zuit watch to get instant feedback as you code. It monitors <PATH> for saved changes and re-runs analysis automatically, printing any findings to the terminal. Only the files you changed are re-scanned, so results appear quickly. Press Ctrl-C to stop.

When to use this​

  • Get immediate quality feedback while editing, without switching context.
  • Catch new findings the moment they are introduced rather than at commit time.
  • Use alongside your editor as a lightweight alternative to the LSP server.

Arguments​

ArgumentDescription
[PATH]Root path to watch. Defaults to ..

Behaviour​

  • Picks up changes across all supported file types under <PATH> on all major operating systems.
  • Rapid saves (such as editor auto-save) are grouped together so only one re-scan fires per burst.
  • Only files that have actually changed are re-scanned; unmodified files are skipped automatically.
  • Findings are printed to the terminal after each triggered run.

Flags​

FlagDefaultDescription
--config <FILE>autoPath to a zuit.toml. Overrides the default upward search.
--no-coloroffDisable ANSI colour in terminal output.
--no-cacheoffDisable the incremental file-hash cache for each triggered run.
-h, --helpPrint help.

Example​

zuit watch ./src

See also​