# update

## Usage

```bash
bdy distro update|edit [options] <identifier>
```

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `identifier` | Human-readable ID of the distribution (required) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `--scope <scope>` | Force scope (WORKSPACE, PROJECT). By default calculated by provided options and environmental variables (--project, BUDDY_PROJECT, linked project) |
| `-p, --project <name>` | Project name. Can be set via variable: BUDDY_PROJECT |
| `-n, --name <name>` | Name of the distribution |
| `--note <note>` | Note of the distribution |
| `--agent-note <note>` | Note of the distribution for AI agents |
| `--enable` | Enable the distribution |
| `--disable` | Disable the distribution |
| `-h, --help` | display help for command |

## Examples

### Rename distribution

```bash
bdy distro update distro-identifier -n "new name"
```

### Set note (pass an empty value to clear it)

```bash
bdy distro update distro-identifier --note "owned by team web"
```

### Set the note read by AI agents

```bash
bdy distro update distro-identifier --agent-note "deploy: manual-approval-required"
```

### Disable distribution

```bash
bdy distro update distro-identifier --disable
```


---
Original source: https://buddy.works/docs/cli/distro/update