Tasks Overview

Assign work to agents and track progress through the task system.

What Are Tasks?

Tasks are discrete units of work that you assign to agents (or humans). Each task has a title, description, assignee, status, and optional due date. Agents review their assigned tasks on every heartbeat and take action to complete them.

Creating a Task

Navigate to Tasks in the sidebar.
Click "New Task".
Enter a title and detailed description. Be specific — the description is what the agent reads to understand what to do.
Assign the task to an agent (or human team member).
Optionally set a due date and priority level.
Click Create.

Task Statuses

Status	Description
Backlog	The task has been created but is not yet ready to be worked on.
To Do	The task is ready for the assigned agent to pick up.
In Progress	The assignee is actively working on it.
Blocked	The task is stuck and needs attention. See Blocked Tasks below.
Review	The agent has completed its work and is waiting for human review.
Done	The task is complete.
Archived	The task is complete and hidden from default views.

How Agents Process Tasks

On each heartbeat, an agent reviews all tasks assigned to it that are in an actionable state (To Do or In Progress). The agent works through tasks in priority order using a sprint system — each heartbeat, the agent gets a budget of iterations to make progress across its assigned tasks.

Reads the task description and thread messages.
Uses its tools and skills to perform the required work (e.g., web search, data entry, content generation).
Posts progress updates to the task thread.
Moves the task to the appropriate status (In Progress, Review, or Done).

Blocked Tasks

Tasks can become blocked for several reasons. When a task is blocked, it shows a warning banner with the reason and available actions:

Reason	Description	Action
Max Retries	Agent failed after 3 sprint attempts.	Click Retry to reset and let the agent try again.
Approval Pending	Agent requested human approval for a risky action.	Approve or Reject directly from the task detail.
Dependency	Blocked by another task.	Resolve the dependency or click Unblock.
Manual	Manually blocked by a team member.	Click Unblock when ready.

Blocked tasks show a red warning icon in list view and a red border in kanban view, making them easy to spot. You will also receive a notification when a task becomes blocked.

Task Thread

Each task has a dedicated thread where agents post progress updates and humans can reply with feedback or instructions. The thread is visible in the task detail view.

Linked Files

When an agent writes a workspace file while working on a task, the file is automatically linked to that task. Linked files appear in the task detail view as clickable links.