agent-skills/skills/turborepo/references/configuration/global-options.md

Global Options Reference

Options that affect all tasks. Full docs: https://turborepo.dev/docs/reference/configuration

globalEnv

Environment variables affecting all task hashes.

{
  "globalEnv": ["CI", "NODE_ENV", "VERCEL_*"]
}

Use for variables that should invalidate all caches when changed.

globalDependencies

Files that affect all task hashes.

{
  "globalDependencies": ["tsconfig.json", ".env", "pnpm-lock.yaml"]
}

Lockfile is included by default. Add shared configs here.

globalPassThroughEnv

Variables available to tasks but not included in hash.

{
  "globalPassThroughEnv": ["AWS_SECRET_KEY", "GITHUB_TOKEN"]
}

Use for credentials that shouldn't affect cache keys.

cacheDir

Custom cache location. Default: node_modules/.cache/turbo.

{
  "cacheDir": ".turbo/cache"
}

daemon

Background process for faster subsequent runs. Default: true.

{
  "daemon": false
}

Disable in CI or when debugging.

envMode

How unspecified env vars are handled. Default: "strict".

{
  "envMode": "strict"  // Only specified vars available
  // or
  "envMode": "loose"   // All vars pass through
}

Strict mode catches missing env declarations.

ui

Terminal UI mode. Default: "stream".

{
  "ui": "tui"     // Interactive terminal UI
  // or
  "ui": "stream"  // Traditional streaming logs
}

TUI provides better UX for parallel tasks.

remoteCache

Configure remote caching.

{
  "remoteCache": {
    "enabled": true,
    "signature": true,
    "timeout": 30,
    "uploadTimeout": 60
  }
}

Option	Default	Description
enabled	true	Enable/disable remote caching
signature	false	Sign artifacts with TURBO_REMOTE_CACHE_SIGNATURE_KEY
preflight	false	Send OPTIONS request before cache requests
timeout	30	Timeout in seconds for cache operations
uploadTimeout	60	Timeout in seconds for uploads
apiUrl	"https://vercel.com"	Remote cache API endpoint
loginUrl	"https://vercel.com"	Login endpoint
teamId	-	Team ID (must start with team_)
teamSlug	-	Team slug for querystring

See https://turborepo.dev/docs/core-concepts/remote-caching for setup.

concurrency

Default: "10"

Limit parallel task execution.

{
  "concurrency": "4"     // Max 4 tasks at once
  // or
  "concurrency": "50%"   // 50% of available CPUs
}

futureFlags

Enable experimental features that will become default in future versions.

{
  "futureFlags": {
    "errorsOnlyShowHash": true
  }
}

errorsOnlyShowHash

When using outputLogs: "errors-only", show task hashes on start/completion:

• Cache miss: cache miss, executing <hash> (only logging errors)
• Cache hit: cache hit, replaying logs (no errors) <hash>

noUpdateNotifier

Disable update notifications when new turbo versions are available.

{
  "noUpdateNotifier": true
}

dangerouslyDisablePackageManagerCheck

Bypass the packageManager field requirement. Use for incremental migration.

{
  "dangerouslyDisablePackageManagerCheck": true
}

Warning: Unstable lockfiles can cause unpredictable behavior.

Git Worktree Cache Sharing

When working in Git worktrees, Turborepo automatically shares local cache between the main worktree and linked worktrees.

How it works:

• Detects worktree configuration
• Redirects cache to main worktree's .turbo/cache
• Works alongside Remote Cache

Benefits:

• Cache hits across branches
• Reduced disk usage
• Faster branch switching

Disabled by: Setting explicit cacheDir in turbo.json.