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.
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>
Arguments
| Name | Type | Required | Description |
|---|
slug | string | on laptop | The agent’s slug. Optional on VMs (defaults to self). |
task-id | string | yes | ID of the task to update. |
-s | string | no | New status. One of: pending, in_progress, completed, deleted. |
--subject | string | no | New subject line. |
-d | string | no | New description. |
--blocks | string | no | Comma-separated task IDs that this task blocks. Appended to existing edges. |
--blocked-by | string | no | Comma-separated task IDs that block this task. Appended to existing edges. |
--workspace | string | no | Workspace name. Overrides the value from murmur.yaml. |
Task statuses
| Status | Meaning |
|---|
pending | Not yet started. |
in_progress | Work is underway. |
completed | Finished. |
deleted | Removed from the checklist. |
Examples
Mark a task as completed
murmur task update fix-auth -s completed t_8f3a1b2c
Change a task’s subject
murmur task update fix-auth --subject "Add rate limiting to all auth endpoints" 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_8f3a1b2c blocks t_9d4e2f1a:
murmur task update fix-auth --blocks t_9d4e2f1a t_8f3a1b2c
Update multiple fields at once
murmur task update fix-auth -s in_progress -d "Started implementing IP-based throttle" t_8f3a1b2c
Self-update on a VM
When running on an agent VM, omit the slug:
murmur task update -s completed t_8f3a1b2c
Errors
| Code | Meaning | What to do |
|---|
NOT_FOUND | No 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. |
UNAUTHENTICATED | Identity token is missing or expired. | Run murmur auth or check your murmur.local.yaml configuration. |
INVALID_ARGUMENT | Unknown status value. | Use one of: pending, in_progress, completed, deleted. |
