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

> Delete a dashboard folder; the agents filed under it become unfiled and are otherwise untouched.

Deletes a folder from your personal dashboard folder list. The [agents](/concepts/agents) filed under it become unfiled — they return to the dashboard's Unfiled group — and nothing else about them changes. No agent is stopped, deleted, or altered, and no other person's view is affected.

The command reports how many agents it unfiled.

## Synopsis

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

## Arguments

| Name   | Type   | Required | Description                                           |
| ------ | ------ | -------- | ----------------------------------------------------- |
| `NAME` | string | yes      | The folder to delete, by name. Matching ignores case. |

<Note>
  There is no confirmation prompt. Check what the folder holds with [`murmur folder ls`](/cli/folder-ls) first — the `AGENTS` column is exactly what the delete would unfile. To undo, create the folder again and re-file the agents with [`murmur folder assign`](/cli/folder-assign).
</Note>

## Examples

### Delete a folder

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

```
deleted "Release 4.2" (unfiled 3 agents)
```

## Errors

| Code                  | Meaning                                              | What to do                                                                                             |
| --------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `INVALID_ARGUMENT`    | No folder of yours has that name.                    | The error lists the folders you do have. Check the spelling with [`murmur folder ls`](/cli/folder-ls). |
| `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) — see what a folder holds before deleting it
* [`murmur folder unfile`](/cli/folder-unfile) — unfile agents without deleting the folder
* [`murmur folder create`](/cli/folder-create) — create a folder