stop_task
Stop working on a task to pause its active timer while maintaining your claim on it, preventing other agents from modifying it during your pause.
Instructions
Stop working on a task (pauses active timer, keeps claim)
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. |
Implementation Reference
- src/taskwarrior.ts:165-172 (handler)The actual implementation of stop_task that uses runCommand to stop the taskwarrior task.
export async function stopTask(id: string, agentId: string): Promise<void> { const uuid = await ensureClaim(id, agentId); try { await runCommand('task', [uuid, 'stop']); } catch (err) { throw new Error(`Failed to stop task ${id}: ${(err as Error).message}`); } }