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

> List your personal dashboard folders, including the ones holding no agents, with the number of agents filed under each.

Lists your dashboard folders and how many [agents](/concepts/agents) each one holds. Folders are personal: you see only your own, and nobody else can see or change them.

The count includes every agent filed in the folder, including any the dashboard is currently filtering out of view. It is exactly what [`murmur folder rm`](/cli/folder-rm) would unfile.

## Synopsis

```bash theme={null}
murmur folder ls [--json]
```

## Flags

| Name     | Type | Default | Description                                           |
| -------- | ---- | ------- | ----------------------------------------------------- |
| `--json` | bool | `false` | Print the folders as a JSON array instead of a table. |

## Output

```
NAME           AGENTS
Infra          4
Release 4.2    0
Review queue   11
```

With `--json`, one array — each element carries the folder's stable `folderId`, its `name`, and its `agentCount`:

```json theme={null}
[
  {
    "folderId": "fld-9f2c41ab77de",
    "name": "Infra",
    "agentCount": 4
  }
]
```

Every other `murmur folder` command names a folder by its `name`, never by its `folderId`. The id is there for a caller that wants to follow a folder across a rename.

## Examples

### List your folders

```bash theme={null}
murmur folder ls
```

### Find the folders holding no agents

```bash theme={null}
murmur folder ls --json | jq '.[] | select(.agentCount == 0) | .name'
```

## Errors

| Code                  | Meaning                                              | What to do                                                                                             |
| --------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `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. |
| `UNAUTHENTICATED`     | Identity token is missing or expired.                | Run `murmur login`.                                                                                    |

## Related

* [`murmur folder create`](/cli/folder-create) — create a folder
* [`murmur folder assign`](/cli/folder-assign) — file agents under a folder
* [`murmur spawn --folder`](/cli/spawn) — spawn an agent straight into a folder