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.

Retrieves the full details of a single task from an agent’s checklist — ID, subject, status, description, and dependency edges.

​
Synopsis

murmur task get [flags] [slug] <task-id>
On a VM, the slug is optional — omitting it queries 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 retrieve.
--workspacestringnoWorkspace name. Overrides the value from murmur.yaml.

​
Output

The output is a set of key-value lines. Fields appear only when they have a value.
FieldDescription
IDThe task identifier.
SubjectShort summary of the task.
StatusThe task’s current status enum (e.g. TASK_STATUS_PENDING).
DescriptionDetailed description. Only shown if set.
BlocksComma-separated IDs of tasks this one blocks. Only shown if set.
Blocked ByComma-separated IDs of tasks that block this one. Only shown if set.

​
Examples

​
Get a task with no dependencies

murmur task get fix-auth t_8f3a1b2c

ID:          t_8f3a1b2c
Subject:     Add rate limiting to the login endpoint
Status:      TASK_STATUS_PENDING
Description: Limit to 5 attempts per minute per IP

​
Get a task with dependency edges

murmur task get fix-auth t_9d4e2f1a

ID:          t_9d4e2f1a
Subject:     Run the full test suite
Status:      TASK_STATUS_PENDING
Blocked By:  t_8f3a1b2c

​
Self-query on a VM

When running on an agent VM, omit the slug: 
murmur task get 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.