> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobster.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# mobster env

> Keep a project's test credentials in your Keychain, for its checks.

Keep a project's test credentials and other secrets in your Keychain, named in .mobster/env.example (names only, committed). A check writes \$\{NAME} in its launch settings and steps; the run fills it in and masks it everywhere. A name with no value stops the run before it starts. Values are never printed or written to the project.

## Usage

```text theme={"theme":"css-variables"}
mobster env <command>
```

```text theme={"theme":"css-variables"}
examples:
  mobster env set TEST_PASSWORD
  printf '%s' "$PW" | mobster env set TEST_PASSWORD --stdin
  mobster env list
  mobster env unset TEST_PASSWORD
```

## Commands

| Command | What it does |
| - | - |
| [`mobster env set`](#mobster-env-set) | save a value for a name, in your Keychain |
| [`mobster env list`](#mobster-env-list) | show the names and which have a value |
| [`mobster env unset`](#mobster-env-unset) | remove a name's saved value |

## `mobster env set`

Save a value for a name, in your Keychain.

### Arguments and options

| Name | Default | Description |
| - | - | - |
| `NAME` | required | the variable's name, such as TEST\_PASSWORD |
| `--project DIR` | the folder with .mobster/ above this one | the project folder |
| `--json` | off | print the result as JSON |
| `--stdin` | off | read the value from standard input instead of asking for it |

## `mobster env list`

Show the names and which have a value.

### Options

| Name | Default | Description |
| - | - | - |
| `--project DIR` | the folder with .mobster/ above this one | the project folder |
| `--json` | off | print the result as JSON |

## `mobster env unset`

Remove a name's saved value.

### Arguments and options

| Name | Default | Description |
| - | - | - |
| `NAME` | required | the variable's name, such as TEST\_PASSWORD |
| `--project DIR` | the folder with .mobster/ above this one | the project folder |
| `--json` | off | print the result as JSON |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.