Task Management

tasks

Unified task management for plans, task tracking, session state, and graph linking.

Absorbs: create_plan, get_plans, get_pending_tasks, get_my_tasks, update_task, save_session_state, get_session_state, link_task_nodes.

Parameters

Parameter	Type	Required	Description
`action`	string	Yes	`create_plan`, `list_plans`, `pending`, `update`, `save_state`, `get_state`, `link_nodes`.
`title`	string	action=create_plan	Plan title.
`description`	string	No	Plan description. action=create_plan.
`tasks`	string	action=create_plan	JSON array of task objects.
`plan_id`	string	No	Filter by plan ID. action=pending.
`agent_id`	string	No	Agent identifier. Filters tasks (pending), attribution (create_plan/update/save_state).
`suggest_next`	boolean	No	Highlight top unblocked task. action=pending.
`id`	string	action=update	Task ID.
`status`	string	action=update	New status: `pending`, `in_progress`, `done`, `cancelled`.
`notes`	string	No	Timestamped notes to append. action=update.
`intent`	string	No	Free-text intent visible to peers. action=update.
`task_id`	string	Conditional	Task ID. Required for save_state, get_state, link_nodes.
`approach`	string	No	Current approach. action=save_state.
`files_modified`	string	No	JSON array of modified files. action=save_state.
`completed_steps`	string	No	JSON array of completed steps. action=save_state.
`remaining_steps`	string	No	JSON array of remaining steps. action=save_state.
`blockers`	string	No	JSON array of blockers. action=save_state.
`decisions`	string	No	JSON array of decisions. action=save_state.
`context_snapshot`	string	No	Free-form context snapshot. action=save_state.
`node_ids`	string	action=link_nodes	JSON array of node ID strings.

Action: create_plan

Create a plan with tasks that persist across sessions.

{
  "tool": "tasks",
  "arguments": {
    "action": "create_plan",
    "title": "Implement auth flow",
    "tasks": "[{\"title\": \"Add JWT middleware\", \"priority\": 1}, {\"title\": \"Write tests\", \"priority\": 2}]"
  }
}

Action: list_plans

Get an overview of all plans.

{
  "tool": "tasks",
  "arguments": { "action": "list_plans" }
}

Action: pending

List pending and in-progress tasks.

{
  "tool": "tasks",
  "arguments": {
    "action": "pending",
    "suggest_next": true
  }
}

Action: update

Change task status or append notes.

{
  "tool": "tasks",
  "arguments": {
    "action": "update",
    "id": "task-abc",
    "status": "done",
    "notes": "Completed JWT middleware"
  }
}

Action: save_state

Save session state for a task so it can be resumed later.

{
  "tool": "tasks",
  "arguments": {
    "action": "save_state",
    "task_id": "task-abc",
    "approach": "Using middleware pattern",
    "files_modified": "[\"internal/auth/jwt.go\"]",
    "remaining_steps": "[\"Write integration tests\"]"
  }
}

Action: get_state

Retrieve saved state for a task.

{
  "tool": "tasks",
  "arguments": {
    "action": "get_state",
    "task_id": "task-abc"
  }
}

Action: link_nodes

Link a task to graph nodes for traceability.

{
  "tool": "tasks",
  "arguments": {
    "action": "link_nodes",
    "task_id": "task-abc",
    "node_ids": "[\"node-1\", \"node-2\"]"
  }
}