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

Copy the code to the clipboard

npx intlayer projects list --json

Example output:

Formatted output:

bash

Copy code

Copy the code to the clipboard

$ npx intlayer projects list --git-rootFound 3 Intlayer project(s):  - /Users/user/workspace/packages/app  - /Users/user/workspace/packages/admin  - /Users/user/workspace/packages/shared

JSON output:

bash

Copy code

Copy the code to the clipboard

$ 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.

Why Intlayer ?

Creation:2025-12-30Last update:2025-12-30

Reference this doc to your favorite AI assistant

ChatGPT

Claude

DeepSeek

Google AI mode Gemini

Perplexity Mistral

Grok

Ask your question and get a summary of the document by referencing this page and the AI provider of your choice

Version History

"Add absolute output option to list projects command"
v7.5.121/6/2026

Edit this doc

If you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.

GitHub link to the documentation

Copy

Copy doc Markdown to clipboard

List Intlayer Projects

bash

Copy code

Copy the code to the clipboard

npx intlayer projects list

npx intlayer projects list

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:

bash

Copy code

Copy the code to the clipboard

npx intlayer projects list

npx intlayer projects list

List projects in a specific directory:

bash

Copy code

Copy the code to the clipboard

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

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

List all projects in the git repository:

bash

Copy code

Copy the code to the clipboard

npx intlayer projects list --git-root

npx intlayer projects list --git-root

Using the shortcut alias:

bash

Copy code

Copy the code to the clipboard

npx intlayer pl --git-root

npx intlayer pl --git-root

Output as JSON:

bash

Copy code

Copy the code to the clipboard

npx intlayer projects list --json

npx intlayer projects list --json

Example output:

Formatted output:

bash

Copy code

Copy the code to the clipboard

$ npx intlayer projects list --git-rootFound 3 Intlayer project(s):  - /Users/user/workspace/packages/app  - /Users/user/workspace/packages/admin  - /Users/user/workspace/packages/shared

$ npx intlayer projects list --git-rootFound 3 Intlayer project(s):  - /Users/user/workspace/packages/app  - /Users/user/workspace/packages/admin  - /Users/user/workspace/packages/shared

JSON output:

bash

Copy code

Copy the code to the clipboard

$ npx intlayer projects list --json["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]

$ 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.

Why Intlayer ?