Skip to main content

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.

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

NameTypeRequiredDescription
slug-templatestringyesTemplate for the agent slug. {} is replaced with the sanitized input line.
description-templatestringyesTemplate for the agent description. {} is replaced with the raw input line.
--workspacestringyesWorkspace name. Can also be set in murmur.yaml.
--dry-runboolnoPrint slug/description pairs without spawning. Default: false.
--agentstringnoAgent persona for all spawned agents.
--modelstringnoModel name (e.g. claude-opus-4-6, gpt-5-4). Overrides murmur.yaml, implies backend.
--backendstringnoOverride the inferred backend. Usually unnecessary.
-dstringnoInput delimiter. Default: newline (\n). Use \0 for null-delimited input.
--repostringnoRepo 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-6 --agent architect "fix-{}" "Investigate and fix: {}"

​
Errors

CodeMeaningWhat to do
no items on stdinstdin was empty or contained only blank lines.Pipe at least one non-empty line into the command.
--workspace is requiredNo workspace was provided and none is set in murmur.yaml.Pass --workspace or set workspace in your murmur.yaml.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
spawn failureOne 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.