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

Loading code block...

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

Loading code block...

Example 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.

bootspring visualize - Visual overview
bootspring health - Health check
bootspring todo - Todo management

Overview#

Usage#

Options#

Watched Files#

Event Types#

Examples#

Example Output#

Use Cases#

Track Progress#

CI Integration#

Team Visibility#

Related Commands#