Pi Watcher
Extension
`AI!` and `AI?` trigger focused Pi follow-up turns from editor comments; `AI.` supplies context without triggering a turn.
What it does
AI! and AI? trigger focused Pi follow-up turns from editor comments; AI. supplies context without triggering a turn.
Only actionable markers trigger a turn; context markers supply surrounding information.
When to reach for it
Invocation: Start or inspect the watcher with /watcher, then write supported markers in a configured text file.
- A code review note should become a focused implementation turn
- Place an intent marker beside the relevant code.
- A question belongs next to the source that prompted it
- Place a question marker and let the watcher carry file context into Pi.
- Nearby comments should guide but not trigger work
- Use context markers alongside one actionable marker.
What it adds
- Debounced file watching across configured roots without following symlinks.
- Marker parsing, focused turn dispatch, and guarded cleanup after settlement.
How it fits
- Pi Ralph Loop: Watcher handles small editor-driven follow-ups; Ralph handles durable plan-driven iterations.
- Explanatory output style: Explanatory guidance can add code-specific learning notes to watcher-triggered implementation turns.
Common questions
- What can change in the source file?
- Live watching is an interactive editor workflow, only actionable markers trigger a turn, and handled comments may be removed after completion.
It’s working if
- Saving a supported actionable marker creates one focused follow-up turn.
- After settlement, handled marker comments are removed only within the guarded source path.
Source and setup
Provenance
- Project
- Pi Watcher
- Origin
- Vedang Manerikar
- Current maintainer
- Vedang Manerikar
- Relationship
- original
- Installed source
git:github.com/vedang/pi-watcher- Source path
- View source (
src/index.ts) - Compatibility
- Interactive Pi
- Configured roots
- Supported text files
- License
- WTFPL
- License publication scope
- Source link, independently written summary, and reviewed behavior claims.
- Reviewed revision
501fa8054ede04afdbe5284c310118d6c871f0f6- Catalog revision
e0c035a297462c519315abfa1af31a1ed3bd9eef
Setup notes
- Created and maintained by Vedang under the WTFPL.
- The package needs interactive Pi, configured roots, and supported text files.
- Behavior claims were reviewed against the installed Git revision.
Commands
/watcher