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

# murmur folder rename

> Change a dashboard folder's display label, keeping every agent filed under it.

Changes a folder's display label. Everything filed under the folder stays filed: membership follows the folder itself, not its name.

## Synopsis

```bash theme={null}
murmur folder rename <NAME> <NEW-NAME>
```

## Arguments

| Name       | Type   | Required | Description                                                                                        |
| ---------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
| `NAME`     | string | yes      | The folder to rename, by its current name. Matching ignores case.                                  |
| `NEW-NAME` | string | yes      | The new display label: 1–76 UTF-8 bytes, no leading or trailing whitespace, no control characters. |

## Examples

### Rename a folder

```bash theme={null}
murmur folder rename Scratch "Scratch pad"
```

```
renamed "Scratch" to "Scratch pad"
```

## Errors

| Code                  | Meaning                                                         | What to do                                                                                             |
| --------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `INVALID_ARGUMENT`    | No folder of yours has that name, or the new name is malformed. | The error lists the folders you do have. Check the spelling with [`murmur folder ls`](/cli/folder-ls). |
| `ALREADY_EXISTS`      | You already use the new name for another folder.                | Names are unique within your own list, ignoring case.                                                  |
| `FAILED_PRECONDITION` | The caller has no personal identity to hold folders.            | Folders belong to a person. Run the command as yourself rather than from inside an agent's VM session. |

## Related

* [`murmur folder ls`](/cli/folder-ls) — list your folders
* [`murmur folder create`](/cli/folder-create) — create a folder
* [`murmur folder rm`](/cli/folder-rm) — delete a folder