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.

Adds a new task to an agent’s checklist. Returns the ID of the created task. Tasks are checklist items that track what an agent needs to do. Each task has a subject line, an optional description, and an optional activation condition that keeps the task dormant until a trigger fires.

​
Synopsis

murmur task create [flags] [slug] <subject>
On a VM, the slug is optional — omitting it creates a task on the current agent’s own checklist.

​
Arguments

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
subjectstringyesShort summary of the task.
-dstringnoDetailed task description.
--activate-whenstringnoActivation condition name. When set, the task stays dormant until the condition is met. Valid: files_modified.
--patternstringnoGlob pattern for file matching. Used with --activate-when files_modified. Supports path.Match syntax plus ** for recursive directory matching.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Examples

​
Create a basic task

murmur task create fix-auth "Add rate limiting to the login endpoint"

t_8f3a1b2c

​
Create a task with a description

murmur task create fix-auth -d "Limit to 5 attempts per minute per IP" "Add rate limiting to the login endpoint"

t_8f3a1b2c

​
Create a conditionally activated task

This task stays dormant until the agent pushes a commit that modifies a Go test file: 
murmur task create fix-auth --activate-when files_modified --pattern "**/*_test.go" "Run the full test suite"

t_9d4e2f1a
The task only appears in murmur task ls --active after the agent pushes a matching file.

​
Self-create on a VM

When running on an agent VM, omit the slug: 
murmur task create "Update the migration script"

t_7c5b3a0e

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug spelling. Use murmur ls to see running agents.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
INVALID_ARGUMENTUnknown activation condition.Use a valid --activate-when value. Currently only files_modified is supported.