---
title: turbo-ignore
description: Learn how to use turbo-ignore to skip tasks in CI.
product: turborepo
type: reference
summary: Reference for the `turbo-ignore` package that determines whether to skip CI tasks based on package changes.
related:
  - /docs/crafting-your-repository/constructing-ci
  - /docs/guides/skipping-tasks
  - /docs/reference/query
---

# turbo-ignore



<Callout type="warn" title="Deprecated">
  `turbo-ignore` is deprecated and will no longer receive updates. Use [`turbo
    query affected`](/docs/reference/query#affected) instead, which provides more
  precise task-level change detection. See the [migration
  guide](/docs/reference/query#migrating-from-turbo-ignore).
</Callout>

Use `turbo` to determine if a package or its dependencies have changes. This can be useful for quickly skipping tasks in CI.

```bash title="Terminal"
npx turbo-ignore [workspace] [flags...]
```

To learn more, visit:

* [The introductory guide to skipping tasks](/docs/crafting-your-repository/constructing-ci#skipping-tasks-and-other-unnecessary-work)
* [The advanced guide for skipping tasks](/docs/guides/skipping-tasks)
* [Documentation for `turbo-ignore` on npm](https://www.npmjs.com/package/turbo-ignore)

## turbo-ignore versioning

Because `turbo-ignore` is most often used before installing dependencies into the repository, there won't be a `turbo` binary available when you run `turbo-ignore`. Instead `turbo-ignore` will search for the correct version to use with your repository with the following strategy:

* First, check for a `turbo` entry in root `package.json#devDependencies` or `package.json#dependencies`. If a version is found there, it will be used.
* If no `entry` is found in `package.json`, `turbo.json` will be read for its schema. If [the `tasks` key](/docs/reference/configuration#tasks) is found, use `turbo@^2`. If the `pipeline` from Turborepo v1 is found, use `turbo@^1`.


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)