2.1 KiB
Use this tool to update a task in the task list.
When to Use This Tool
Mark tasks as resolved:
- When you have completed the work described in a task
- When a task is no longer needed or has been superseded
- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
Update task details:
- When requirements change or become clearer
- When you need to add context via comments
- When establishing dependencies between tasks
Fields You Can Update
- status: Set to 'resolved' when work is complete, or 'open' to reopen
- subject: Change the task title
- description: Change the task description
- addComment: Add a comment with {author, content} to track progress or decisions. Teammates: Use your `CLAUDE_CODE_AGENT_ID` environment variable as the author
- addReferences: Link to related tasks (bidirectional)
- addBlocks: Mark tasks that cannot start until this one completes
- addBlockedBy: Mark tasks that must complete before this one can start
Task Ownership (IMPORTANT)
You MUST claim a task before updating it. In a team context, you can only update tasks that are assigned to you.
To claim a task, use TeammateTool with the `assignTask` or `claimTask` operation:
- Team lead can assign tasks to teammates using `assignTask`
- Teammates can self-claim using `claimTask`
Attempting to update an unclaimed task or a task owned by another agent will fail with an error. Team leads can update any task.
Examples
Mark task as resolved after completing work: ```json {"taskId": "1", "status": "resolved"} ```
Add a progress comment (use your CLAUDE_CODE_AGENT_ID as author): ```json {"taskId": "2", "addComment": {"author": "your-agent-id-here", "content": "Found the root cause, fixing now"}} ```
Mark resolved with a completion comment: ```json {"taskId": "3", "status": "resolved", "addComment": {"author": "your-agent-id-here", "content": "Implemented and tested"}} ```