{"record":{"id":"040638c2b2555160","repo":"vercel/turborepo","slug":"33m-turbo-ignore-is-deprecated-use-turbo-quer","errorCode":null,"errorMessage":"\u001b[33m\"turbo-ignore\" is deprecated. Use \"turbo query affected\" instead.\u001b[39m","messagePattern":"\u001b\\[33m\"turbo-ignore\" is deprecated\\. Use \"turbo query affected\" instead\\.\u001b\\[39m","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/turbo-ignore/src/ignore.ts","lineNumber":53,"sourceCode":") {\n  opts.telemetry?.trackCommandStatus({ command: \"ignore\", status: \"start\" });\n  opts.telemetry?.trackArgumentWorkspace(workspaceArg !== undefined);\n  trackOptions(opts);\n\n  const inputs = {\n    workspace: workspaceArg,\n    ...opts\n  };\n\n  if (process.env.VERCEL === \"1\") {\n    warn(\n      `\\u001B[33m\"turbo-ignore\" is deprecated. Use Vercel's built-in project skipping instead.\\u001B[39m`\n    );\n    warn(\n      `\\u001B[33mLearn more: https://vercel.com/docs/monorepos#skipping-unaffected-projects\\u001B[39m\\n`\n    );\n  } else {\n    warn(\n      `\\u001B[33m\"turbo-ignore\" is deprecated. Use \"turbo query affected\" instead.\\u001B[39m`\n    );\n    warn(\n      `\\u001B[33mLearn more: https://turborepo.dev/docs/reference/query#migrating-from-turbo-ignore\\u001B[39m\\n`\n    );\n  }\n\n  info(\n    `Using Turborepo to determine if this project is affected by the commit...\\n`\n  );\n\n  // set default directory\n  if (opts.directory) {\n    const directory = path.resolve(opts.directory);\n    if (existsSync(directory)) {\n      inputs.directory = directory;\n    } else {\n      warn(","sourceCodeStart":35,"sourceCodeEnd":71,"githubUrl":"https://github.com/vercel/turborepo/blob/f9245100cf0d31d96628804ead485f6bf226e55a/packages/turbo-ignore/src/ignore.ts#L35-L71","documentation":"Outside Vercel (VERCEL !== '1'), turbo-ignore's deprecation warning instead points to `turbo query affected`, the supported way to determine affected workspaces. The command continues to run and return its normal exit code; only the guidance text differs based on the environment.","triggerScenarios":"CI scripts (GitHub Actions, GitLab, etc.) invoking `npx turbo-ignore` without VERCEL set, typically guarding per-package build jobs; the else-branch of the VERCEL check fires.","commonSituations":"Legacy CI pipelines built around turbo-ignore; teams planning the migration to `turbo query affected` (which supports --packages, --tasks, --base/--head, --exit-code).","solutions":["Replace turbo-ignore with `turbo query affected` (e.g. `turbo query affected --exit-code` to gate CI) and branch on its output","If immediate migration is not possible, keep turbo-ignore but track the migration — it still functions","Consult the linked guide (turborepo.dev/docs/reference/query#migrating-from-turbo-ignore)"],"exampleFix":"# before (CI step)\n- run: npx turbo-ignore --scope=web\n\n# after\n- run: turbo query affected --packages=web --exit-code","handlingStrategy":"fallback","validationCode":"# Replace the deprecated call in CI with the query command\n# before: npx turbo-ignore --scope=web\n# after:\nturbo query affected --packages=web --exit-code","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Migrate pipelines to `turbo query affected` and use --exit-code to gate steps","Keep turbo-ignore only as a stopgap and track its removal as tech debt","Note the message varies by environment: VERCEL=1 shows the Vercel-specific guidance instead"],"tags":["turbo-ignore","deprecation","migration","turborepo"],"backgroundTag":"deprecated-command-usage","analyzedSha":"f9245100cf0d31d96628804ead485f6bf226e55a","analyzedAt":"2026-08-17T10:46:15.696Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}