---
title: check
---

import VersionLabel from '@site/src/components/Docs/VersionLabel';

The `moon check [...projects]` (or `moon c`) command will run _all_
[build and test tasks](../concepts/task#types) for one or many projects. This is a convenience
command for verifying the current state of a project, instead of running multiple
[`moon run`](./run) commands.

```shell
# Check project by name
$ moon check app

# Check multiple projects by name
$ moon check client server

# Check closest project from current working directory
$ moon check --closest

# Check ALL projects (may be costly)
$ moon check --all
```

### Arguments

- `[...id]` - List of project IDs or aliases to explicitly check, as defined in
  [`projects`](../config/workspace#projects).

### Options

Inherits all options from [`moon exec`](./exec), and pre-fills with: `--on-failure=bail`,
`--upstream=deep`.

- `--all` - Run check for all projects in the workspace.
- `--closest` - Run check for the closest project starting from the current working directory.

### Configuration

- [`projects`](../config/workspace#projects) in `.moon/workspace.*`
- [`tasks`](../config/tasks#tasks) in `.moon/tasks/*`
- [`tasks`](../config/project#tasks) in `moon.*`
