f5792c40be
Pulled ALL skills from 15 source repositories: - anthropics/skills: 16 (docs, design, MCP, testing) - obra/superpowers: 14 (TDD, debugging, agents, planning) - coreyhaines31/marketingskills: 25 (marketing, CRO, SEO, growth) - better-auth/skills: 5 (auth patterns) - vercel-labs/agent-skills: 5 (React, design, Vercel) - antfu/skills: 16 (Vue, Vite, Vitest, pnpm, Turborepo) - Plus 13 individual skills from various repos Mosaic Stack is not limited to coding — the Orchestrator and subagents serve coding, business, design, marketing, writing, logistics, analysis, and more. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
100 lines
1.9 KiB
Markdown
100 lines
1.9 KiB
Markdown
# turbo watch
|
|
|
|
Full docs: https://turborepo.dev/docs/reference/watch
|
|
|
|
Re-run tasks automatically when code changes. Dependency-aware.
|
|
|
|
```bash
|
|
turbo watch [tasks]
|
|
```
|
|
|
|
## Basic Usage
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```json
|
|
{
|
|
"tasks": {
|
|
"dev": {
|
|
"persistent": true,
|
|
"cache": false
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Non-Dependency-Aware Tools
|
|
|
|
For tools that don't detect dependency changes, use `interruptible`:
|
|
|
|
```json
|
|
{
|
|
"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:
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# Run dev servers and watch for build changes
|
|
turbo watch dev build
|
|
```
|
|
|
|
### Type Checking During Development
|
|
|
|
```bash
|
|
# Watch and re-run type checks
|
|
turbo watch check-types
|
|
```
|