List Intlayer Projects

npx intlayer projects list

This command searches for and lists all Intlayer projects by finding directories that contain Intlayer configuration files. It's useful for discovering all Intlayer projects in a monorepo, workspace, or git repository.

Aliases:

• npx intlayer projects-list
• npx intlayer pl

Arguments:

• --base-dir [path]: Specify the base directory to search from. Defaults to the current working directory.

  Example: npx intlayer projects list --base-dir /path/to/workspace

• --git-root: Search from the git root directory instead of the base directory. This is useful for finding all Intlayer projects in a monorepo or git repository.

  Example: npx intlayer projects list --git-root

• --json: Output the results as JSON instead of formatted text. Useful for scripting and programmatic access.

  Example: npx intlayer projects list --json

• --absolute: Output the results as absolute paths instead of relative paths.

  Example: npx intlayer projects list --absolute

How it works:

The command searches for Intlayer configuration files in the specified directory (or git root if --git-root is used). It looks for the following configuration file patterns:

• intlayer.config.ts
• intlayer.config.js
• intlayer.config.json
• intlayer.config.cjs
• intlayer.config.mjs
• .intlayerrc

Each directory containing one of these files is considered an Intlayer project and will be listed in the output.

Examples:

List projects in current directory:

npx intlayer projects list

List projects in a specific directory:

npx intlayer projects list --base-dir ./packages

List all projects in the git repository:

npx intlayer projects list --git-root

Using the shortcut alias:

npx intlayer pl --git-root

Output as JSON:

npx intlayer projects list --json

Example output:

Formatted output:

$ npx intlayer projects list --git-root

Found 3 Intlayer project(s):

  - /Users/user/workspace/packages/app
  - /Users/user/workspace/packages/admin
  - /Users/user/workspace/packages/shared

JSON output:

$ npx intlayer projects list --json

["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]

Use cases:

• Monorepo management: Discover all Intlayer projects in a monorepo structure
• Project discovery: Find all Intlayer-enabled projects in a workspace
• CI/CD: Verify Intlayer projects in automated workflows
• Documentation: Generate documentation listing all projects using Intlayer

The output provides absolute paths to each project directory, making it easy to navigate to or script operations on multiple Intlayer projects.