query

Run GraphQL queries against your monorepo.

turbo query [query] [flags]

When no arguments are passed, the command will open a GraphiQL playground to run queries.

turbo query

When passed a query string, the command will run the query and output the results.

turbo query "query { packages { items { name } } }"

When passed a file path, the command will read the file and run the query.

turbo query query.gql

Shorthands

Shorthands generate GraphQL queries for common operations so you don't need to write them by hand. The JSON output is identical to what you'd get from a raw query.

affected

Check which packages or tasks are affected by changes between two git refs.

turbo query affected [flags]

With no flags, returns all affected tasks:

turbo query affected

{
  "data": {
    "affectedTasks": {
      "items": [
        {
          "name": "build",
          "fullName": "web#build",
          "package": { "name": "web" },
          "reason": { "__typename": "TaskFileChanged" }
        }
      ],
      "length": 1
    }
  }
}

Task-level detection is more precise than package-level. A task is only reported as affected if its configured inputs match a changed file, or if an upstream task dependency is affected.

--tasks

Filter to specific task names. With no values, returns all affected tasks (same as bare turbo query affected).

turbo query affected --tasks
turbo query affected --tasks build
turbo query affected --tasks build test

--packages

Without --tasks, returns affected packages instead of tasks. With no values, returns all affected packages. With values, filters to the named packages.

When combined with --tasks, both filters apply (intersection) — only tasks matching the task name and belonging to the named packages are returned. This lets you check whether a specific task in a specific package changed:

turbo query affected --tasks build --packages web

turbo query affected --packages
turbo query affected --packages web
turbo query affected --packages web docs

{
  "data": {
    "affectedPackages": {
      "items": [
        { "name": "web", "path": "apps/web", "reason": { "__typename": "FileChanged" } }
      ],
      "length": 1
    }
  }
}

--base

Base git ref for comparison. Defaults to the auto-detected base (e.g. GITHUB_BASE_REF on GitHub Actions, or the merge-base with main).

Can also be set with the TURBO_SCM_BASE environment variable.

turbo query affected --base main

--head

Head git ref for comparison. Defaults to HEAD.

Can also be set with the TURBO_SCM_HEAD environment variable.

turbo query affected --head my-branch

Flags

--schema

Output the GraphQL introspection schema. Cannot be used with a query argument.

turbo query --schema

--variables (-V)

Path to a JSON file containing query variables. Requires a query argument.

turbo query query.gql --variables vars.json