Back to Turborepo

ls

apps/docs/content/docs/reference/ls.mdx

2.9.141.3 KB
Original Source

import { ExperimentalBadge } from "@/components/geistdocs/experimental-badge";

List packages in your monorepo.

bash
turbo ls [package(s)] [flags]

When scoped to the entire repository, output includes package manager, package count, and all package names and directories.

bash
# List all packages in the repository
turbo ls

When scoped to one or more packages, output includes package name, directory, internal dependencies, and all tasks.

bash
# List only two packages
turbo ls web @repo/ui [package(s)]

Flags

--affected

Automatically filter to only packages that are affected by changes on the current branch.

When combined with --filter, returns the intersection: only packages that are both affected and match the filter.

bash
turbo ls --affected
turbo ls --affected --filter=web

By default the changes considered are those between main and HEAD.

  • You can override main as the default base by setting TURBO_SCM_BASE.
  • You can override HEAD as the default head by setting TURBO_SCM_HEAD.
bash
TURBO_SCM_BASE=development turbo ls --affected

--output <format> <ExperimentalBadge />

Format to output the results. json or pretty (default)

bash
turbo ls --output=json