Loading source
Pulling the file list, source metadata, and syntax-aware rendering for this listing.
Source from repo
Configure and optimize Turborepo monorepo build pipelines with correct task structure, caching, and CI setup.
Files
Skill
Size
Entrypoint
Format
Open file
Syntax-highlighted preview of this file as included in the skill package.
references/cli/commands.md
1# turbo run Flags Reference2Full docs: https://turborepo.dev/docs/reference/run4## Package Selection6### `--filter` / `-F`8Select specific packages to run tasks in.10```bash12turbo build --filter=web13turbo build -F=@repo/ui -F=@repo/utils14turbo test --filter=./apps/*15```16See `filtering/` for complete syntax (globs, dependencies, git ranges).18### Task Identifier Syntax (v2.2.4+)20Run specific package tasks directly:22```bash24turbo run web#build # Build web package25turbo run web#build docs#lint # Multiple specific tasks26```27### `--affected`29Run only in packages changed since the base branch.31```bash33turbo build --affected34turbo test --affected --filter=./apps/* # combine with filter35```36**How it works:**38- Default: compares `main...HEAD`40- In GitHub Actions: auto-detects `GITHUB_BASE_REF`41- Override base: `TURBO_SCM_BASE=development turbo build --affected`42- Override head: `TURBO_SCM_HEAD=your-branch turbo build --affected`43**Requires git history** - shallow clones may fall back to running all tasks.45## Execution Control47### `--dry` / `--dry=json`49Preview what would run without executing.51```bash53turbo build --dry # human-readable54turbo build --dry=json # machine-readable55```56### `--force`58Ignore all cached artifacts, re-run everything.60```bash62turbo build --force63```64### `--concurrency`66Limit parallel task execution.68```bash70turbo build --concurrency=4 # max 4 tasks71turbo build --concurrency=50% # 50% of CPU cores72```73### `--continue`75Keep running other tasks when one fails.77```bash79turbo build test --continue80```81### `--only`83Run only the specified task, skip its dependencies.85```bash87turbo build --only # skip running dependsOn tasks88```89### `--parallel` (Discouraged)91Ignores task graph dependencies, runs all tasks simultaneously. **Avoid using this flag**—if tasks need to run in parallel, configure `dependsOn` correctly instead. Using `--parallel` bypasses Turborepo's dependency graph, which can cause race conditions and incorrect builds.93## Cache Control95### `--cache`97Fine-grained cache behavior control.99```bash101# Default: read/write both local and remote102turbo build --cache=local:rw,remote:rw103# Read-only local, no remote105turbo build --cache=local:r,remote:106# Disable local, read-only remote108turbo build --cache=local:,remote:r109# Disable all caching111turbo build --cache=local:,remote:112```113## Output & Debugging115### `--graph`117Generate task graph visualization.119```bash121turbo build --graph # opens in browser122turbo build --graph=graph.svg # SVG file123turbo build --graph=graph.png # PNG file124turbo build --graph=graph.json # JSON data125turbo build --graph=graph.mermaid # Mermaid diagram126```127### `--summarize`129Generate JSON run summary for debugging.131```bash133turbo build --summarize134# creates .turbo/runs/<run-id>.json135```136### `--output-logs`138Control log output verbosity.140```bash142turbo build --output-logs=full # all logs (default)143turbo build --output-logs=new-only # only cache misses144turbo build --output-logs=errors-only # only failures145turbo build --output-logs=none # silent146```147### `--profile`149Generate Chrome tracing profile for performance analysis.151```bash153turbo build --profile=profile.json154# open chrome://tracing and load the file155```156### `--verbosity` / `-v`158Control turbo's own log level.160```bash162turbo build -v # verbose163turbo build -vv # more verbose164turbo build -vvv # maximum verbosity165```166## Environment168### `--env-mode`170Control environment variable handling.172```bash174turbo build --env-mode=strict # only declared env vars (default)175turbo build --env-mode=loose # include all env vars in hash176```177## UI179### `--ui`181Select output interface.183```bash185turbo build --ui=tui # interactive terminal UI (default in TTY)186turbo build --ui=stream # streaming logs (default in CI)187```188---190# turbo-ignore192Full docs: https://turborepo.dev/docs/reference/turbo-ignore194Skip CI work when nothing relevant changed. Useful for skipping container setup.196## Basic Usage198```bash200# Check if build is needed for current package (uses Automatic Package Scoping)201npx turbo-ignore202# Check specific package204npx turbo-ignore web205# Check specific task207npx turbo-ignore --task=test208```209## Exit Codes211- `0`: No changes detected - skip CI work213- `1`: Changes detected - proceed with CI214## CI Integration Example216```yaml218# GitHub Actions219- name: Check for changes220id: turbo-ignore221run: npx turbo-ignore web222continue-on-error: true223- name: Build225if: steps.turbo-ignore.outcome == 'failure' # changes detected226run: pnpm build227```228## Comparison Depth230Default: compares to parent commit (`HEAD^1`).232```bash234# Compare to specific commit235npx turbo-ignore --fallback=abc123236# Compare to branch238npx turbo-ignore --fallback=main239```240---242# Other Commands244## turbo boundaries246Check workspace violations (experimental).248```bash250turbo boundaries251```252See `references/boundaries/` for configuration.254## turbo watch256Re-run tasks on file changes.258```bash260turbo watch build test261```262See `references/watch/` for details.264## turbo prune266Create sparse checkout for Docker.268```bash270turbo prune web --docker271```272## turbo link / unlink274Connect/disconnect Remote Cache.276```bash278turbo link # connect to Vercel Remote Cache279turbo unlink # disconnect280```281## turbo login / logout283Authenticate with Remote Cache provider.285```bash287turbo login # authenticate288turbo logout # log out289```290## turbo generate292Scaffold new packages.294```bash296turbo generate297```298