# Project and environment commands

URL: https://helmr.dev/docs/reference/cli/project
Description: Manage Projects and their Environments.

# Project and environment commands

```text
helmr project list [--json]
helmr project get PROJECT [--json]
helmr project create NAME [--slug SLUG] [--json]
helmr project update PROJECT [--name NAME] [--slug SLUG] [--json]
```

`update` requires at least one changed field.
`project list` traverses all available pages before writing output, so a failed
later page does not produce a partial text or JSON result.

`env` is a top-level command:

```text
helmr env list --project PROJECT [--json]
helmr env get ENVIRONMENT --project PROJECT [--json]
helmr env create NAME --project PROJECT [--slug SLUG] [--color '#RRGGBB'] [--json]
helmr env update ENVIRONMENT --project PROJECT [--name NAME] [--slug SLUG] [--color '#RRGGBB'] [--json]
```

Project and Environment arguments accept a slug or ID. Generated slugs are
used when `--slug` is omitted; Environment color also defaults from the slug.
Project slugs cannot use UUID syntax because UUID-shaped references are project
IDs.