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

> File one or more existing agents under a dashboard folder, moving any that are already filed elsewhere.

Files [agents](/concepts/agents) under one of your folders. An agent already filed somewhere else moves; an agent already in the named folder stays and is not counted as changed.

Filing is personal — it changes only your own view of these agents — and the folder must already exist. Naming one that does not is an error listing the folders you do have, never a silent create.

## Synopsis

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

## Arguments

| Name   | Type   | Required | Description                                                                                                                                                                       |
| ------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NAME` | string | yes      | The folder to file the agents under, by name. Matching ignores case.                                                                                                              |
| `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. |

<Note>
  Folders hold top-level agents. A child agent renders under its root in the dashboard, so it cannot be filed on its own. All the agents named in one command must belong to the same workspace.
</Note>

## Examples

### File two agents

```bash theme={null}
murmur folder assign "Review queue" fix-auth bump-deps
```

```
filed 2 agents under "Review queue"
```

### Move an agent to another folder

```bash theme={null}
murmur folder assign Infra fix-auth
```

### File an agent owned by someone else

```bash theme={null}
murmur folder assign "Review queue" /w/backend/github_oauth/alice/fix-auth
```

## Errors

| Code                  | Meaning                                                                                                                  | What to do                                                                                              |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| `INVALID_ARGUMENT`    | No folder of yours has that name, an agent is not top-level, an agent is named twice, or the agents span two workspaces. | The error says which. Check names with [`murmur folder ls`](/cli/folder-ls) and [`murmur ls`](/cli/ls). |
| `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.                                                                                 | Filing 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 unfile`](/cli/folder-unfile) — remove agents from their folder
* [`murmur folder create`](/cli/folder-create) — create the folder first
* [`murmur spawn --folder`](/cli/spawn) — file a new agent at spawn time