annotate_task
Add notes to tasks for tracking updates and context in task management systems, enabling organized collaboration and clear documentation.
Instructions
Add an annotation (note) to a task (auto-claims, renews lease)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Task ID or UUID | |
| agent_id | Yes | Globally unique agent identifier (e.g. "claude-opus-<uuid>"). Each agent instance MUST use a distinct ID to prevent collisions between parallel agents. | |
| annotation | Yes | The annotation text to add |
Implementation Reference
- src/taskwarrior.ts:174-181 (handler)The `annotateTask` function implementation in `src/taskwarrior.ts`. It ensures the task is claimed by the agent and then runs the `task annotate` command.
export async function annotateTask(id: string, annotation: string, agentId: string): Promise<void> { const uuid = await ensureClaim(id, agentId); try { await runCommand('task', [uuid, 'annotate', annotation]); } catch (err) { throw new Error(`Failed to annotate task ${id}: ${(err as Error).message}`); } }