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, non-alphanumeric characters replaced with dashes, truncated to 60 characters). 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`). Use `\0` for null-delimited input.
`--repo`	string	no	Repo to clone: `URL`, `URL=base`, or `URL=base:working`. Repeatable.

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

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)

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
no items on stdin	stdin was empty or contained only blank lines.	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 auth` or check your `murmur.local.yaml` configuration.
spawn failure	One or more agents failed to spawn. The command prints each failure to stderr and continues with the remaining items.	Check the error message for the specific slug. The exit message shows how many succeeded and how many failed.

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