murmur task create

Adds a new task to an agent’s checklist. Prints the ID of the created task. Task IDs are sequential integers per agent (1, 2, …). 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, omit the slug: the command always targets the current agent’s own checklist, and a slug is rejected as an extra positional argument. Quote a multi-word subject: it must be a single argument.

Arguments

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug. Omit on VMs (always self).
`subject`	string	yes	Short summary of the task.
`-d`	string	no	Detailed task description.
`--activate-when`	string	no	Activation condition name. When set, the task stays dormant and doesn’t block the agent until the condition is met. Valid: `files_modified`, met once the agent pushes a commit in the current run touching a file matching `--pattern`.
`--pattern`	string	no	Glob pattern for file matching. Used with `--activate-when files_modified` and ignored without it. Supports `path.Match` syntax plus `**` for recursive directory matching. With no pattern, any push in the current run meets the condition.
`--workspace`	string	no	Workspace name. Overrides the value from `murmur.yaml`.

Examples

Create a basic task

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

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"

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"

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"

Errors

Code	Meaning	What to do
`NOT_FOUND`	No agent with that slug exists.	Check the slug spelling. Use `murmur ls` to see running agents.
`UNAUTHENTICATED`	Identity token is missing or expired.	Run `murmur login` or check your `murmur.local.yaml` configuration.
none	`unknown activation condition "<value>"`: the `--activate-when` value is not recognized.	Use `files_modified`, the only supported condition.

Agents: concept overview
murmur task update: change a task’s status, subject, or dependencies
murmur task ls: list all tasks on an agent’s checklist
murmur task get: retrieve details for a single task
murmur status: query agent status
murmur spawn: start an agent

Getting Started

Core Concepts

Guides

murmur task create

Synopsis

Arguments

Examples

Create a basic task

Create a task with a description

Create a conditionally activated task

Self-create on a VM

Errors

​Synopsis

​Arguments

​Examples

​Create a basic task

​Create a task with a description

​Create a conditionally activated task

​Self-create on a VM

​Errors

​Related

Synopsis

Arguments

Examples

Create a basic task

Create a task with a description

Create a conditionally activated task

Self-create on a VM

Errors

Related