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

# aether env

> Manage project environment variables

# aether env

Manage environment variables for the current project. Environment variables are per-project and encrypted at rest. They are injected into workspaces when they start.

## Usage

```bash theme={null}
aether env <subcommand> [flags]
```

## Subcommands

| Subcommand      | Description                         |
| --------------- | ----------------------------------- |
| `list`          | List all environment variables      |
| `get <key>`     | Get the value of a variable         |
| `set <key>`     | Set an environment variable         |
| `delete <key>`  | Delete an environment variable      |
| `import <file>` | Import variables from a `.env` file |

## aether env list

List all environment variables for the current project. Values are masked by default.

```bash theme={null}
aether env list
```

```
KEY                 VALUE
DATABASE_URL        ****
REDIS_URL           ****
API_SECRET          ****
```

## aether env get

Get the value of a specific environment variable.

```bash theme={null}
aether env get <key>
```

```bash theme={null}
aether env get DATABASE_URL
```

```
postgres://user:pass@host:5432/db
```

## aether env set

Set an environment variable. Creates the variable if it does not exist, or updates it if it does.

```bash theme={null}
aether env set <key> [flags]
```

| Flag      | Description                 |
| --------- | --------------------------- |
| `--value` | The value to set (required) |

```bash theme={null}
aether env set DATABASE_URL --value "postgres://user:pass@host:5432/db"
```

```
Set DATABASE_URL
```

<Note>
  Running workspaces need to be restarted to pick up environment variable changes.
</Note>

## aether env delete

Delete an environment variable.

```bash theme={null}
aether env delete <key> [flags]
```

| Flag      | Description              |
| --------- | ------------------------ |
| `--force` | Skip confirmation prompt |

```bash theme={null}
aether env delete API_SECRET
```

```
Are you sure you want to delete API_SECRET? [y/N]
```

## aether env import

Import environment variables from a `.env` file. Existing variables with the same key are overwritten.

```bash theme={null}
aether env import <file>
```

```bash theme={null}
aether env import .env.production
```

```
Imported 5 environment variables from .env.production
  Set DATABASE_URL
  Set REDIS_URL
  Set API_SECRET
  Set SMTP_HOST
  Set SMTP_PORT
```

The file format follows standard `.env` conventions:

```
# Database
DATABASE_URL=postgres://user:pass@host:5432/db
REDIS_URL=redis://localhost:6379

# API
API_SECRET=supersecret
```