---
title: turbo-ignore
description: Learn how to use turbo-ignore to skip tasks in CI.
url: "https://turborepo.dev/docs/reference/turbo-ignore"
docs_index: /llms.txt
lastUpdated: 2026-10-27
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
---

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

> **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).

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)