Setting the file. One moment.
Subchapter 9.13
references/cli/commands.mdMarkdown5 KBView on GitHub
Select specific packages to run tasks in.
turbo build --filter=web
turbo build -F=@repo/ui -F=@repo/utils
turbo test --filter=./apps/*See filtering/ for complete syntax (globs, dependencies, git ranges).
Run specific package tasks directly:
turbo run web#build # Build web package
turbo run web#build docs#lint # Multiple specific tasksRun only in packages changed since the base branch.
turbo build --affected
turbo test --affected --filter=./apps/* # combine with filterHow it works:
main...HEADGITHUB_BASE_REFTURBO_SCM_BASE=development turbo build --affectedTURBO_SCM_HEAD=your-branch turbo build --affectedRequires git history - shallow clones may fall back to running all tasks.
Preview what would run without executing.
turbo build --dry # human-readable
turbo build --dry=json # machine-readableIgnore all cached artifacts, re-run everything.
turbo build --forceLimit parallel task execution.
turbo build --concurrency=4 # max 4 tasks
turbo build --concurrency=50% # 50% of CPU coresKeep running other tasks when one fails.
turbo build test --continueRun only the specified task, skip its dependencies.
turbo build --only # skip running dependsOn tasksIgnores 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.
Fine-grained cache behavior control.
# Default: read/write both local and remote
turbo build --cache=local:rw,remote:rw
# Read-only local, no remote
turbo build --cache=local:r,remote:
# Disable local, read-only remote
turbo build --cache=local:,remote:r
# Disable all caching
turbo build --cache=local:,remote:Generate task graph visualization.
turbo build --graph # opens in browser
turbo build --graph=graph.svg # SVG file
turbo build --graph=graph.png # PNG file
turbo build --graph=graph.json # JSON data
turbo build --graph=graph.mermaid # Mermaid diagramGenerate JSON run summary for debugging.
turbo build --summarize
# creates .turbo/runs/<run-id>.jsonControl log output verbosity.
turbo build --output-logs=full # all logs (default)
turbo build --output-logs=new-only # only cache misses
turbo build --output-logs=errors-only # only failures
turbo build --output-logs=none # silentGenerate Chrome tracing profile for performance analysis.
turbo build --profile=profile.json
# open chrome://tracing and load the fileControl turbo’s own log level.
turbo build -v # verbose
turbo build -vv # more verbose
turbo build -vvv # maximum verbosityControl environment variable handling.
turbo build --env-mode=strict # only declared env vars (default)
turbo build --env-mode=loose # include all env vars in hashSelect output interface.
turbo build --ui=tui # interactive terminal UI (default in TTY)
turbo build --ui=stream # streaming logs (default in CI)Skip CI work when nothing relevant changed. Useful for skipping container setup.
# Check if build is needed for current package (uses Automatic Package Scoping)
npx turbo-ignore
# Check specific package
npx turbo-ignore web
# Check specific task
npx turbo-ignore --task=test0: No changes detected - skip CI work1: Changes detected - proceed with CI# GitHub Actions
- name: Check for changes
id: turbo-ignore
run: npx turbo-ignore web
continue-on-error: true
- name: Build
if: steps.turbo-ignore.outcome == 'failure' # changes detected
run: pnpm buildDefault: compares to parent commit (HEAD^1).
# Compare to specific commit
npx turbo-ignore --fallback=abc123
# Compare to branch
npx turbo-ignore --fallback=mainCheck workspace violations (experimental).
turbo boundariesSee references/boundaries/ for configuration.
Re-run tasks on file changes.
turbo watch build testSee references/watch/ for details.
Create sparse checkout for Docker.
turbo prune web --dockerConnect/disconnect Remote Cache.
turbo link # connect to Vercel Remote Cache
turbo unlink # disconnectAuthenticate with Remote Cache provider.
turbo login # authenticate
turbo logout # log outScaffold new packages.
turbo generate