Skip to main content
reticle watch is the buddy loop. It watches the current directory and, on every save of a source file, reports which saved flows the change puts at risk. It runs in the environment, so it costs your agent nothing per turn.
Long-running. Stop it with Ctrl+C.

Arguments

What it watches

The working directory, recursively, filtered to .ts, .tsx, .js, .jsx, .mjs, .cjs, .vue and .svelte. Changes are batched with a 200ms debounce.

What it prints

Real capture, the first two lines of a run in this repository:
A save then produces a reticle_watch_affected line naming the changed files and the flows they put at risk, followed by a refreshed buddy line. Real capture, with both lists trimmed:
The buddy line is deliberately best-effort and silent on failure. A status line that throws is worse than no status line, and it must never interfere with the watch loop it rides on.

Exit codes

Runs until interrupted.

Worked example

Last modified on September 18, 2026