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.
Creates a new task in an agent’s checklist. Returns the task ID. Tasks appear in the agent’s status and guide the agent through multi-step work.
Equivalent to murmur task create in the CLI.
Parameters
| Name | Type | Required | Description |
|---|
subject | string | yes | Short summary of the task. |
description | string | no | Detailed task description. |
activate_when | string | no | Activation condition name. When set, the task is dormant until the condition is met. Valid: files_modified. |
pattern | string | no | Glob pattern for file matching (e.g. *.go, **/*_test.go). Only used with activate_when: files_modified. |
slug | string | no | Agent slug. Empty means self. Use an absolute path like /w/workspace/u/account/slug to target an agent outside your own path. |
workspace | string | no | Workspace name. Overrides the session default. |
Conditional activation
When activate_when is set, the task starts in a dormant state and is automatically activated when the condition is met. Currently the only supported condition is files_modified — the task activates when a file matching pattern is modified by the agent.
This is useful for attaching review or testing tasks that only make sense after specific files change. For example, a task to “run integration tests” that activates when **/*_test.go files are modified.
Response
Returns a JSON object with the created task’s ID.
| Field | Type | Description |
|---|
task_id | string | The ID of the created task. |
Examples
Create a simple task
{
"subject": "Add pagination to the users API"
}
{
"task_id": "t_abc123"
}
Create a task on another agent
{
"slug": "fix-auth",
"subject": "Update the API docs after fixing auth",
"description": "The OpenAPI spec needs to reflect the new auth flow."
}
Create a conditionally activated task
{
"subject": "Run integration tests",
"description": "Verify the test suite passes after modifying test files.",
"activate_when": "files_modified",
"pattern": "**/*_test.go"
}
Errors
| Code | Meaning | What to do |
|---|
INVALID_ARGUMENT | Missing subject or unknown activate_when value. | Check the error message and fix the input. |
NOT_FOUND | No agent with that slug exists. | Check the slug. Use ls to see running agents. |
UNAUTHENTICATED | Identity token is missing or expired. | Check credentials. |
