murmur task create

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

Name	Type	Required	Description
`slug`	string	on laptop	The agent’s slug. Optional on VMs (defaults to 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 — it 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`. Supports `path.Match` syntax plus `**` for recursive directory matching.
`--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"

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

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 auth` or check your `murmur.local.yaml` configuration.
`INVALID_ARGUMENT`	Unknown activation condition.	Use a valid `--activate-when` value. Currently only `files_modified` is supported.

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