Task Management

Task management enables multiple Claude sessions to coordinate work by creating, claiming, and completing tasks.

Creating Tasks

agent_create_task({
  title: "Implement user authentication",
  description: "Add JWT-based auth to the API endpoints",
  priority: "high",
  estimated_effort: "medium",
  tags: ["backend", "security"],
  required_skills: ["typescript", "jwt"]
})

Task Fields

Task Lifecycle

┌─────────┐    ┌─────────┐    ┌────────────┐    ┌───────────┐
│  Open   │───▶│ Claimed │───▶│ In Progress │───▶│ Completed │
└─────────┘    └─────────┘    └────────────┘    └───────────┘
                                    │
                                    ▼
                              ┌───────────┐
                              │ Cancelled │
                              └───────────┘

Claiming Tasks

agent_claim_task({
  task_id: "task-abc123"
})

Claiming:

• Assigns the task to your session
• Prevents other agents from claiming it
• Sets status to claimed

Updating Tasks

agent_update_task({
  task_id: "task-abc123",
  status: "in_progress"
})

agent_update_task({
  task_id: "task-abc123",
  status: "completed",
  result: { "files_changed": ["src/auth.ts", "src/middleware.ts"] }
})

Listing Tasks

// All open tasks
agent_list_tasks({ status: "open" })

// Tasks assigned to me
agent_list_tasks({ assigned_to_me: true })

// In-progress tasks
agent_list_tasks({ status: "in_progress" })

Finding Matching Tasks

agent_find_matching_tasks({
  capabilities: ["typescript", "testing"],
  max_effort: "small",
  exclude_blocked: true
})

Returns tasks that match your declared capabilities.

Priority Guidelines

Effort Estimates

Best Practices

1. Clear titles - Make tasks easy to understand at a glance
2. Detailed descriptions - Include enough context to start work
3. Appropriate priority - Reserve urgent for true emergencies
4. Realistic effort - Help with workload planning
5. Update status - Keep task status current
6. Complete tasks - Mark done when finished