agent-skills/skills/turborepo/references/watch/RULE.md

turbo watch

Full docs: https://turborepo.dev/docs/reference/watch

Re-run tasks automatically when code changes. Dependency-aware.

turbo watch [tasks]

Basic Usage

# Watch and re-run build task when code changes
turbo watch build

# Watch multiple tasks
turbo watch build test lint

Tasks re-run in order configured in turbo.json when source files change.

With Persistent Tasks

Persistent tasks ("persistent": true) won't exit, so they can't be depended on. They work the same in turbo watch as turbo run.

Dependency-Aware Persistent Tasks

If your tool has built-in watching (like next dev), use its watcher:

{
  "tasks": {
    "dev": {
      "persistent": true,
      "cache": false
    }
  }
}

Non-Dependency-Aware Tools

For tools that don't detect dependency changes, use interruptible:

{
  "tasks": {
    "dev": {
      "persistent": true,
      "interruptible": true,
      "cache": false
    }
  }
}

turbo watch will restart interruptible tasks when dependencies change.

Limitations

Caching

Caching is experimental with watch mode:

turbo watch your-tasks --experimental-write-cache

Task Outputs in Source Control

If tasks write files tracked by git, watch mode may loop infinitely. Watch mode uses file hashes to prevent this but it's not foolproof.

Recommendation: Remove task outputs from git.

vs turbo run

Feature	turbo run	turbo watch
Runs once	Yes	No
Re-runs on change	No	Yes
Caching	Full	Experimental
Use case	CI, one-off	Development

Common Patterns

Development Workflow

# Run dev servers and watch for build changes
turbo watch dev build

Type Checking During Development

# Watch and re-run type checks
turbo watch check-types