Skip to main content

​
Tasks

The Tasks view is a kanban board for managing work items that agents can pick up and execute.

​
Board columns

ColumnStatusMeaning
InboxinboxNew tasks, unassigned
AssignedassignedAgent assigned, not started
In Progressin_progressAgent actively working
ReviewreviewCompleted, needs human review
BlockedblockedWaiting on something
DonedoneFinished
Drag and drop tasks between columns to change status.

​
Creating a task

  1. Click New Task
  2. Fill in:
    • Title — what needs to be done
    • Description — details and context
    • Priority — low / medium / high / urgent
    • Assigned agent — which agent handles it
    • Model override — use a specific model for this task

​
Priority levels

PriorityWhen to use
lowNice to have, no deadline
mediumStandard priority
highImportant, do soon
urgentDo immediately

​
Multi-agent assignment

Tasks can have multiple agents:
  • Lead — primary agent responsible for the task
  • Collaborator — assists the lead agent

​
Scheduling with cron

Tasks can run on a schedule:
  1. Open a task
  2. Set a cron schedule (standard cron syntax)
  3. Enable cron
The engine checks for due tasks every 60 seconds.

​
Cron examples

0 9 * * *       Every day at 9 AM
0 */2 * * *     Every 2 hours
0 9 * * 1-5     Weekdays at 9 AM
*/30 * * * *    Every 30 minutes

​
Activity feed

Each task has a live activity feed showing:
EventDescription
createdTask was created
assignedAgent was assigned
status_changeTask moved to a new column
commentHuman added a note
agent_startedAgent began working
agent_completedAgent finished
agent_errorAgent encountered an error
cron_triggeredScheduled run fired
Filter the feed by: All, Tasks only, or Status changes.

​
Task statuses

Each task has a board status (which column it sits in) and an underlying execution status that tracks the agent’s progress:
Board columnExecution statusDescription
InboxpendingNot yet picked up by any agent
AssignedpendingAgent assigned but hasn’t started
In Progressin_progressAgent is actively executing
ReviewcompletedAgent finished — awaiting human review
Blockedfailed / cancelledSomething went wrong or was stopped
DonecompletedFully finished and approved
:::info When an agent encounters an error, the task moves to Blocked with a failed execution status. You can reassign it or move it back to Inbox to retry. :::

​
Cancelling a task

To cancel a running task:
  1. Open the task
  2. Drag it to Blocked or click Delete
  3. The agent’s session is aborted and the execution status becomes cancelled

​
Task templates

Create reusable task templates by combining cron scheduling with pre-filled fields:
  1. Create a task with a descriptive title and description
  2. Assign an agent and set the priority
  3. Set a cron schedule (e.g. 0 9 * * 1-5 for weekday mornings)
  4. Enable cron — the task will recreate itself on schedule

​
Common template patterns

TemplateCronDescription
Daily standup0 9 * * 1-5Summarize yesterday’s activity
Hourly monitoring0 * * * *Check services and report issues
Weekly report0 17 * * 5Generate end-of-week summary
PR review*/30 * * * *Check for new pull requests
News digest0 8 * * *Research and summarize news
:::tip Combine templates with model overrides to use cheaper models for routine checks and powerful models for complex analysis tasks. :::

​
Automation

See the Automations guide for setting up recurring agent tasks.