Task agent

Where it appears

Open a task in the Tasks workspace. The right sidebar switches to Task Agent. If a task project or no task is selected, the sidebar prompts you to open a task first.

Scope

The task agent sees the current task snapshot: title, task project, status, priority, labels, due date, and the current draft content. It is designed for task-document work: rewriting, tightening, expanding, critiquing, or clarifying the task.

Its single write capability is replacing the current task content. It does not edit project files, create arbitrary notes, or manage unrelated tasks from this sidebar.

Chat controls

The sidebar includes:

• The task title at the top.
• A clear-chat button that removes task-agent history for the current task.
• The same model selector used by project chat.
• Enter to send and Shift + Enter for a newline.
• A stop button while the response is streaming.

Updating the task

When the assistant decides the task document should change, it calls replace_current_task_content with the complete replacement text. After the change, it briefly explains what changed. The editor shows the updated task content because task changes are saved to the same local task record.

Difference from dispatch

Task Agent improves the task document in place. Dispatch Agent creates a separate worktree-backed project session to implement the task in code. Use Task Agent to sharpen the work item; use Dispatch Agent when it is time to execute against a connected project.