## projects env

Manage project environment variables, named environments, and environment resource membership. Running `stripe projects env` without flags or subcommands lists environment variable names with their values redacted.

Use `--pull` to sync credentials for the active environment to that environment's configured output file. Run `--pull` manually when:

- You're setting up the project on a new machine, or after cloning the repo.
- A teammate provisioned or rotated a resource and you need the updated credentials.
- Your environment output file was deleted or corrupted and you need to restore it.
- You switched environments or changed environment membership and need to refresh local credentials.

> `.projects/vault/vault.json` and environment output files, such as `.env`, are added to `.gitignore` by `stripe projects init`. Never commit either file.

**Command:** `stripe projects env`

### Subcommands

- `env list`
  List project environments and mark the active environment.

- `env show`
  Show the active environment, its output file, and resource membership.

- `env create <name> --output <path>`
  Create an environment and make it active.

- `env use <name>`
  Switch the active environment for this checkout.

- `env update --name <new-name>`
  Rename the active environment.

- `env update --output <path>`
  Change the active environment's output file.

- `env delete <name>`
  Delete an environment.

- `env add <resource_name>`
  Add an existing project resource to the active environment.

- `env remove <resource_name>`
  Remove a project resource from the active environment.

### Flags

- `--pull`
  Sync credentials for the active environment to that environment's configured output file.

- `--output <path>`
  Set the output file when creating an environment or changing the active environment's output file.

- `--name <new-name>`
  Rename the active environment.

### Examples

**List project environments**

```sh
stripe projects env list
```

**Create an environment and make it active**

```sh
stripe projects env create development --output .env.dev
```

**Add an existing resource to the active environment**

```sh
stripe projects env add dev-db
```