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

> Remove agents from whatever dashboard folder they are in, returning them to the Unfiled group.

Removes [agents](/concepts/agents) from whatever folder they are filed under, returning them to the dashboard's Unfiled group. The agents themselves are untouched, and no folder is deleted.

Unfiling is its own command rather than an empty name passed to [`murmur folder assign`](/cli/folder-assign), so a shell variable that expands to nothing can never unfile an agent by accident.

## Synopsis

```bash theme={null}
murmur folder unfile [--workspace <NAME>] <SLUG>...
```

## Arguments

| Name   | Type   | Required | Description                                                                                                                                                                       |
| ------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `SLUG` | string | yes      | One or more agents. Each must be a top-level agent you can read. Use an absolute path like `/w/{workspace}/{owner_provider}/{account}/{slug}` for an agent outside your own path. |

## Flags

| Name          | Type   | Default            | Description                     |
| ------------- | ------ | ------------------ | ------------------------------- |
| `--workspace` | string | from `murmur.yaml` | Workspace the agents belong to. |

## Examples

### Unfile an agent

```bash theme={null}
murmur folder unfile bump-deps
```

```
unfiled 1 agent
```

### Unfile several at once

```bash theme={null}
murmur folder unfile fix-auth bump-deps flaky-test
```

## Errors

| Code                  | Meaning                                                                       | What to do                                                                                             |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `INVALID_ARGUMENT`    | An agent is not top-level, is named twice, or the agents span two workspaces. | All the agents in one command must be top-level and share a workspace.                                 |
| `NOT_FOUND`           | No agent with that slug exists.                                               | Check the slug with [`murmur ls`](/cli/ls).                                                            |
| `PERMISSION_DENIED`   | You cannot read one of the named agents.                                      | Unfiling requires `agent.read` on every agent named.                                                   |
| `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 assign`](/cli/folder-assign) — file agents under a folder
* [`murmur folder rm`](/cli/folder-rm) — delete a folder, unfiling everything in it