---
title: 'show - CLI command'
description: 'Show information about the workspace (e.g., list of projects).'
---

# show

Show information about the workspace (e.g., list of projects).

## Usage

```shell
nx show
```

Install `nx` globally to invoke the command directly using `nx`, or use `npx nx`, `yarn nx`, or `pnpm nx`.

### Examples

Show all projects in the workspace:

```shell
 nx show projects
```

Show all projects with names starting with "api-". The "projects" option is useful to see which projects would be selected by run-many:

```shell
 nx show projects --projects api-*
```

Show all projects with a tag starting with "ui-". The "projects" option is useful to see which projects would be selected by run-many:

```shell
 nx show projects --projects tag:ui-*
```

Show all projects with a serve target:

```shell
 nx show projects --with-target serve
```

Show affected projects in the workspace:

```shell
 nx show projects --affected
```

Show affected apps in the workspace:

```shell
 nx show projects --affected --type app
```

Show affected projects in the workspace, excluding end-to-end projects:

```shell
 nx show projects --affected --exclude=*-e2e
```

If in an interactive terminal, opens the project detail view. If not in an interactive terminal, defaults to JSON:

```shell
 nx show project my-app
```

Show detailed information about "my-app" in a json format:

```shell
 nx show project my-app --json
```

Show information about "my-app" in a human readable format:

```shell
 nx show project my-app --json false
```

Opens a web browser to explore the configuration of "my-app":

```shell
 nx show project my-app --web
```

## Options

| Shared Option | Type    | Description          |
| ------------- | ------- | -------------------- |
| `--help`      | boolean | Show help.           |
| `--json`      | boolean | Output JSON.         |
| `--version`   | boolean | Show version number. |

## Subcommands

### projects

Show a list of projects in the workspace.

```shell
nx show projects
```

## Options

| Option                | Type                | Description                                                                                                                             |
| --------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `--affected`          | boolean             | Show only affected projects.                                                                                                            |
| `--base`              | string              | Base of the current branch (usually main).                                                                                              |
| `--exclude`           | string              | Exclude certain projects from being processed.                                                                                          |
| `--files`             | string              | Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas or spaces. |
| `--head`              | string              | Latest commit of the current branch (usually HEAD).                                                                                     |
| `--help`              | boolean             | Show help.                                                                                                                              |
| `--projects`, `--p`   | string              | Show only projects that match a given pattern.                                                                                          |
| `--sep`               | string              | Outputs projects with the specified seperator.                                                                                          |
| `--type`              | `app`, `lib`, `e2e` | Select only projects of the given type.                                                                                                 |
| `--uncommitted`       | boolean             | Uncommitted changes.                                                                                                                    |
| `--untracked`         | boolean             | Untracked changes.                                                                                                                      |
| `--verbose`           | boolean             | Prints additional information about the commands (e.g., stack traces).                                                                  |
| `--version`           | boolean             | Show version number.                                                                                                                    |
| `--withTarget`, `--t` | string              | Show only projects that have a specific target.                                                                                         |

### project

Shows resolved project configuration for a given project.

```shell
nx show project <projectName>
```

## Options

| Option                 | Type    | Description                                                            |
| ---------------------- | ------- | ---------------------------------------------------------------------- |
| `--help`               | boolean | Show help.                                                             |
| `--open`               | boolean | Set to false to prevent the browser from opening when using --web.     |
| `--projectName`, `--p` | string  | Which project should be viewed?.                                       |
| `--verbose`            | boolean | Prints additional information about the commands (e.g., stack traces). |
| `--version`            | boolean | Show version number.                                                   |
| `--web`                | boolean | Show project details in the browser. (default when interactive).       |