murmur each

Reads lines from stdin and spawns one agent per line. Each line is substituted into a slug template and a description template, producing a batch of agents with a single command.

Synopsis

murmur each [flags] <slug-template> <description-template>

Both <slug-template> and <description-template> use {} as the substitution marker. Every occurrence of {} in the slug template is replaced with a sanitized version of the input line (lowercased, each run of non-alphanumeric characters replaced with one dash and a leading run dropped, truncated to 60 characters; a line with no letters or digits becomes item). Every occurrence of {} in the description template is replaced with the raw input line. Empty lines are skipped.

Arguments

Name	Type	Required	Description
`slug-template`	string	yes	Template for the agent slug. `{}` is replaced with the sanitized input line.
`description-template`	string	yes	Template for the agent description. `{}` is replaced with the raw input line.
`--workspace`	string	yes	Workspace name. Can also be set in `murmur.yaml`.
`--dry-run`	bool	no	Print slug/description pairs without spawning. Default: `false`.
`--agent`	string	no	Agent persona for all spawned agents.
`--model`	string	no	Model name (e.g. `claude-opus-4-8`, `gpt-5-4`). Overrides `murmur.yaml`, implies backend.
`--backend`	string	no	Override the inferred backend. Usually unnecessary.
`-d`	string	no	Input delimiter. Default: newline (`\n`). The only other recognized value is `\0`, for null-delimited input.
`--repo`	string	no	A repo to clone beyond the workspace’s, or a workspace repo whose base branch these spawns pin: `URL`, `URL=base`, or `URL=base:working`. Repeatable, at most once per repository.

Examples

Spawn an agent for each changed file

git diff --name-only main | murmur each --workspace backend "fix-{}" "Fix the lint errors in {}"

Spawned: fix-src-auth-middleware-ts

  To get the status of the task:                murmur status fix-src-auth-middleware-ts
  To kill the task:                             murmur kill fix-src-auth-middleware-ts
  To send a follow-up:                          murmur queue add fix-src-auth-middleware-ts "additional context"

Spawned: fix-src-api-handler-go

  To get the status of the task:                murmur status fix-src-api-handler-go
  To kill the task:                             murmur kill fix-src-api-handler-go
  To send a follow-up:                          murmur queue add fix-src-api-handler-go "additional context"

Spawned 2 agents

The per-agent summaries go to stdout. The final Spawned N agents count goes to stderr. When a spawn fails, the count reads Spawned N/M agents (K failed).

Preview without spawning

echo -e "auth\npayments\nbilling" | murmur each --dry-run --workspace backend "review-{}" "Review the {} module for error handling"

review-auth	Review the auth module for error handling
review-payments	Review the payments module for error handling
review-billing	Review the billing module for error handling
(3 agents)

The (3 agents) count goes to stderr.

Null-delimited input

find . -name '*.go' -print0 | murmur each -d '\0' --workspace backend "lint-{}" "Run lint on {}"

Specify a model and persona

cat issues.txt | murmur each --workspace backend --model claude-opus-4-8 --agent architect "fix-{}" "Investigate and fix: {}"

Errors

Code	Meaning	What to do
`murmur each: no items on stdin`	stdin was empty or contained only blank lines. The command exits `0` without spawning.	Pipe at least one non-empty line into the command.
`--workspace is required`	No workspace was provided and none is set in `murmur.yaml`.	Pass `--workspace` or set `workspace` in your `murmur.yaml`.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login` or check your `murmur.local.yaml` configuration.
`murmur each: spawn <slug>: ...`	One agent failed to spawn. The command prints each failure to stderr, continues with the remaining items, and exits non-zero with `<K> spawn(s) failed`.	Check the error message for the specific slug.

Agents: what agents are and how they work
Workspaces: the workspace that resolves repos and environment
Agent personas: persona configuration
murmur spawn: spawn a single agent
murmur status: check agent status
murmur ls: list running agents
murmur kill: cancel an agent

Getting Started

Core Concepts

Guides

Synopsis

Arguments

Examples

Spawn an agent for each changed file

Preview without spawning

Null-delimited input

Specify a model and persona

Errors

​Synopsis

​Arguments

​Examples

​Spawn an agent for each changed file

​Preview without spawning

​Null-delimited input

​Specify a model and persona

​Errors

​Related

Synopsis

Arguments

Examples

Spawn an agent for each changed file

Preview without spawning

Null-delimited input

Specify a model and persona

Errors

Related