> ## 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 create

> Create a personal dashboard folder holding no agents, ready to file agents into or spawn into.

Creates a folder in your personal dashboard folder list. The new folder holds no [agents](/concepts/agents) — file agents into it with [`murmur folder assign`](/cli/folder-assign), or spawn straight into it with [`murmur spawn --folder`](/cli/spawn).

Folders are personal: only you can see or change yours.

## Synopsis

```bash theme={null}
murmur folder create <NAME>
```

## Arguments

| Name   | Type   | Required | Description                                                                                                                             |
| ------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `NAME` | string | yes      | The folder's display label: 1–76 UTF-8 bytes, no leading or trailing whitespace, no control characters. Quote a name containing spaces. |

<Note>
  A folder name carries no hierarchy. `/` is an ordinary character in a label, not a separator — `murmur folder create "team/review"` makes one folder whose name contains a slash.
</Note>

## Examples

### Create a folder

```bash theme={null}
murmur folder create "Release 4.2"
```

```
created "Release 4.2"
```

### Create a folder and spawn into it

```bash theme={null}
murmur folder create "Review queue"
murmur spawn --folder "Review queue" fix-auth "Fix the auth bug"
```

## Errors

| Code                  | Meaning                                                                                      | What to do                                                                                                            |
| --------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `ALREADY_EXISTS`      | You already have a folder with that name.                                                    | Names are unique within your own list, ignoring case. Pick another, or [rename](/cli/folder-rename) the existing one. |
| `INVALID_ARGUMENT`    | The name is empty, longer than 76 UTF-8 bytes, or has edge whitespace or control characters. | Fix the name and retry.                                                                                               |
| `RESOURCE_EXHAUSTED`  | You already hold the maximum of 200 folders.                                                 | Delete a folder you no longer use with [`murmur folder rm`](/cli/folder-rm).                                          |
| `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 rename`](/cli/folder-rename) — change a folder's label
* [`murmur folder rm`](/cli/folder-rm) — delete a folder