# hm run (/cli/run)



## Synopsis [#synopsis]

```bash
hm run [PIPELINE] [OPTIONS]
```

`hm run` packs your current working tree, boots a local Docker sandbox, and
runs the pipeline against it as it stands, including changes you haven't
committed. If your repo declares exactly one pipeline, the `PIPELINE` slug is
optional.

## Options [#options]

| Flag                      | Default      | Meaning                                    |
| ------------------------- | ------------ | ------------------------------------------ |
| `-b, --branch <BRANCH>`   | *(detected)* | Branch to record on the build.             |
| `-m, --message <MESSAGE>` | *(none)*     | Build message.                             |
| `-e, --env <KEY=VALUE>`   | *(none)*     | Set an environment variable (repeatable).  |
| `-d, --dir <PATH>`        | `.`          | Source root to pack.                       |
| `--parallelism <N>`       | *(cores)*    | Max concurrent chains.                     |
| `--format <NAME>`         | `human`      | Output format: `human` or `json`.          |
| `--logs`                  | off          | Stream full logs instead of progress bars. |
| `--no-watch`              | off          | Don't watch the build after creating it.   |

## Example [#example]

```bash
hm run ci --env CI=true --logs
```