murmur folder ls

Lists your dashboard folders and how many 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 would unfile.

Synopsis

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 no folders, the command prints You have no folders. Create one with "murmur folder create <NAME>". With --json, one array: each element carries the folder’s stable folderId, its name, and its agentCount. Fields with zero values are omitted, so a folder holding no agents has no agentCount key:

[
  {
    "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

murmur folder ls

Find the folders holding no agents

murmur folder ls --json | jq '.[] | select((.agentCount // 0) == 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`.

murmur folder create: create a folder
murmur folder assign: file agents under a folder
murmur spawn --folder: spawn an agent straight into a folder

Getting started

Core concepts

Integrations

Guides

murmur folder ls

Synopsis

Flags

Output

Examples

List your folders

Find the folders holding no agents

Errors

​Synopsis

​Flags

​Output

​Examples

​List your folders

​Find the folders holding no agents

​Errors

​Related

Synopsis

Flags

Output

Examples

List your folders

Find the folders holding no agents

Errors

Related