48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
---
|
|
title: 'watch - CLI command'
|
|
description: 'Watch for changes within projects, and execute commands.'
|
|
---
|
|
|
|
# watch
|
|
|
|
Watch for changes within projects, and execute commands.
|
|
|
|
## Usage
|
|
|
|
```shell
|
|
nx watch
|
|
```
|
|
|
|
Install `nx` globally to invoke the command directly using `nx`, or use `npx nx`, `yarn nx`, or `pnpm nx`.
|
|
|
|
### Examples
|
|
|
|
Watch the "app" project and echo the project name and the files that changed:
|
|
|
|
```shell
|
|
nx watch --projects=app -- echo \$NX_PROJECT_NAME \$NX_FILE_CHANGES
|
|
```
|
|
|
|
Watch "app1" and "app2" and echo the project name whenever a specified project or its dependencies change:
|
|
|
|
```shell
|
|
nx watch --projects=app1,app2 --includeDependentProjects -- echo \$NX_PROJECT_NAME
|
|
```
|
|
|
|
Watch all projects (including newly created projects) in the workspace:
|
|
|
|
```shell
|
|
nx watch --all -- echo \$NX_PROJECT_NAME
|
|
```
|
|
|
|
## Options
|
|
|
|
| Option | Type | Description |
|
|
| ----------------------------------- | ------- | --------------------------------------------------------------------------- |
|
|
| `--all` | boolean | Watch all projects. |
|
|
| `--help` | boolean | Show help. |
|
|
| `--includeDependentProjects`, `--d` | boolean | When watching selected projects, include dependent projects as well. |
|
|
| `--projects`, `--p` | string | Projects to watch (comma/space delimited). |
|
|
| `--verbose` | boolean | Run watch mode in verbose mode, where commands are logged before execution. |
|
|
| `--version` | boolean | Show version number. |
|