magus-watch

Emit changed file paths to stdout

Synopsis

magus watch [flags]

Description

Watch the workspace for file-system changes and emit batches of changed repo-relative paths to stdout. Each path is on its own line; a blank line separates batches. This output format is compatible with git diff --name-only so the two are interchangeable on either side of a pipe.

Use --null for binary-safe output: paths are NUL-separated and batches end with a double-NUL, matching the --null flag of magus affected --stdin.

On startup an --all sentinel batch is emitted (unless --initial=false) to trigger a full initial build in the downstream magus affected --stdin.

Options

--backend string (default: fsnotify)

Notification backend: fsnotify, poll, or auto (probes fsnotify, falls back to poll)

--debounce duration (default: 200ms)

Quiet window before emitting a batch

--ignore string

Ignore pattern; repeatable. Form: type=<glob|regex|literal>,pattern=<value>

--initial (default: true)

Emit an --all batch on startup before watching

--null

NUL-separate paths; double-NUL between batches

Examples

Continuous build pipeline

magus watch | magus affected --stdin build

Increase debounce for slow editors

magus watch --debounce 500ms | magus affected --stdin test

Polling backend (when inotify is unavailable)

magus watch --backend poll | magus affected --stdin build

See Also

magus(1), magus-ls(1), magus-describe(1), magus-run(1), magus-x(1), magus-where(1), magus-affected(1), magus-graph(1), magus-query(1), magus-explain(1), magus-path(1), magus-refs(1), magus-events(1), magus-status(1), magus-clean(1), magus-vcs(1), magus-doctor(1), magus-config(1), magus-session(1), magus-memory(1), magus-notes(1), magus-diff(1), magus-server(1), magus-mcp(1), magus-buzz(1), magus-completion(1), magus-man(1), magus-init(1), magus-agent(1), magus-self(1), magus-version(1)