bootspring watch
Real-time file watching and sync.
Overview#
The watch command monitors project files for changes and reports events in real-time. Useful for tracking todo completion, workflow progress, and PRD updates.
Usage#
bootspring watch [options]Options#
| Option | Description |
|---|---|
--todos | Watch only todo.md |
--workflows | Watch only workflow states |
--prd | Watch only PRD file |
--verbose | Show all change events |
--debounce <ms> | Debounce interval (default: 300) |
Watched Files#
| File | Description |
|---|---|
todo.md | Task changes |
.bootspring/*/workflow-state.json | Workflow phase changes |
tasks/prd.json | Story status changes |
Event Types#
| Icon | Event |
|---|---|
✓ | Todo completed |
+ | Todo added |
- | Todo removed |
◆ | Workflow phase change |
◇ | PRD story change |
Examples#
1# Watch all files
2bootspring watch
3
4# Watch only todos
5bootspring watch --todos
6
7# Watch only workflows
8bootspring watch --workflows
9
10# Watch only PRD
11bootspring watch --prd
12
13# Verbose output
14bootspring watch --verbose
15
16# Custom debounce
17bootspring watch --debounce 500Example Output#
⚡ Bootspring Watch
Todos: 5/23 │ Workflows: 2 │ PRD: Active
[10:30:15] ✓ Todo completed: Set up authentication
[10:30:45] + Todo added: Add password reset
[10:31:02] ◆ Workflow 'analyze' → Phase 3/5
[10:31:30] ◇ PRD story 'auth-flow' → in-progress
Use Cases#
Track Progress#
Keep watch running while working to see real-time progress.
CI Integration#
Use watch output to trigger CI actions on file changes.
Team Visibility#
Share watch output for team visibility into project status.
Related Commands#
bootspring visualize- Visual overviewbootspring health- Health checkbootspring todo- Todo management