Skip to main content
Modifies an existing task on an agent’s checklist. Changes the task’s status, subject, description, or dependency edges. On success, prints the task ID.

​
Synopsis

murmur task update [flags] [slug] <task-id>
On a VM, the slug is optional — omitting it updates a task on the current agent’s own checklist.

​
Arguments

NameTypeRequiredDescription
slugstringon laptopThe agent’s slug. Optional on VMs (defaults to self).
task-idstringyesID of the task to update.
-sstringnoNew status. One of: pending, in_progress, completed, deleted.
--subjectstringnoNew subject line.
-dstringnoNew description.
--blocksstringnoComma-separated task IDs that this task blocks. Appended to existing edges.
--blocked-bystringnoComma-separated task IDs that block this task. Appended to existing edges.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Task statuses

StatusMeaning
pendingNot yet started.
in_progressWork is underway.
completedFinished.
deletedRemoved from the checklist.

​
Examples

​
Mark a task as completed

murmur task update fix-auth -s completed t_8f3a1b2c

t_8f3a1b2c

​
Change a task’s subject

murmur task update fix-auth --subject "Add rate limiting to all auth endpoints" t_8f3a1b2c

t_8f3a1b2c

​
Add dependency edges

Mark that t_9d4e2f1a cannot start until t_8f3a1b2c finishes: 
murmur task update fix-auth --blocked-by t_8f3a1b2c t_9d4e2f1a

t_9d4e2f1a
You can also express this from the other direction — mark that t_8f3a1b2c blocks t_9d4e2f1a: 
murmur task update fix-auth --blocks t_9d4e2f1a t_8f3a1b2c

t_8f3a1b2c

​
Update multiple fields at once

murmur task update fix-auth -s in_progress -d "Started implementing IP-based throttle" t_8f3a1b2c

t_8f3a1b2c

​
Self-update on a VM

When running on an agent VM, omit the slug: 
murmur task update -s completed t_8f3a1b2c

t_8f3a1b2c

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists, or the task ID is invalid.Check the slug and task ID. Use murmur task ls to see existing tasks.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.
INVALID_ARGUMENTUnknown status value.Use one of: pending, in_progress, completed, deleted.