Skip to main content

Watch Mode

Watch mode runs in the background and monitors your files for issues. When it spots something worth your attention, it surfaces a single actionable suggestion.

Start​

nimbus watch

Nimbus starts watching .py, .ts, .tsx, and .js files in the current repository.

How suggestions appear​

When you save a file that has a potential issue, Nimbus analyzes it using Claude Haiku and prints a one-line suggestion:

  nimbus  missing null check on user.profile before accessing user.profile.email
         suggested fix? [y/n/s to snooze]
  • y — Nimbus fixes it immediately (runs a full task)
  • n — dismiss the suggestion
  • s — snooze this file for the rest of the session

Snooze behavior​

Snoozed files are not analyzed again until you restart nimbus watch. Snooze is useful when you're mid-refactor and don't want suggestions on files you're actively changing.

Debounce​

Nimbus waits 30 seconds after a file change before analyzing it. This prevents suggestions from firing while you're actively typing. You can change this in ~/.nimbus/config.toml:

[local]
watch_debounce_seconds = 15  # shorter debounce

Stop​

Ctrl+C

or:

nimbus watch --stop

What watch mode uses​

Watch mode uses Claude Haiku (not Opus or Sonnet) to keep latency and API cost low. It identifies one issue per file per analysis — it won't overwhelm you with a list of problems.