# create

## Usage

```bash
bdy environment create|add [options] [name]
```

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `name` | Environment name (required) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `-i, --identifier <identifier>` | Human-readable ID of the environment. Alphanumeric characters, underscores, and hyphens (hyphens cannot appear at the start or end) |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `-p, --project <name>` | Project name. Can be set via variable: BUDDY_PROJECT |
| `--scope <scope>` | Force scope (WORKSPACE, PROJECT). By default calculated by provided options and environmental variables (--project, BUDDY_PROJECT, linked project) |
| `--tags <tags>` | Comma-separated list of tags |
| `--public-url <url>` | Public URL of the environment |
| `--icon <icon>` | Icon of the environment (an emoji, e.g. 🚀) |
| `--note <note>` | Resource note |
| `--agent-note <note>` | Note for AI agents operating on this resource |
| `-h, --help` | display help for command |

## Examples

### Create workspace environment

```bash
bdy env create staging
```

### Create project environment

```bash
bdy env create staging -p project
```

### Create environment with identifier and tags

```bash
bdy env create "Staging" -i staging --tags staging,test
```

### Create environment with a public url

```bash
bdy env create staging --public-url https://staging.example.com
```


---
Original source: https://buddy.works/docs/cli/environment/create