Tasks

The task board tracks agent work through a defined lifecycle.

Statuses

Creating Tasks

Manually

Navigate to Tasks and click New Task:

• Title — Brief description of the work
• Description — Detailed instructions for the agent
• Agent — Which agent handles this task
• Working Directory — Optional cwd for file operations

From Schedules

When a cron schedule triggers, it creates a task in queued status automatically. See Scheduling.

Via API

curl -X POST http://localhost:3456/api/tasks \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: your_key" \
  -d '{
    "title": "Generate weekly report",
    "description": "Compile metrics from the past 7 days",
    "agentId": "your-agent-id"
  }'

Task Lifecycle

Backlog → Queued → Running → Completed
                      ↓
                    Failed

1. Tasks start in backlog (manual) or queued (scheduled)
2. Move to queued when ready
3. The assigned agent picks up the task → running
4. Agent completes → completed with result, or failed with error

Task Data

Each task stores:

• comments — Agent and user comments during execution
• result — Final output from the agent
• error — Error message if failed
• images — Any generated images
• timestamps — created, queued, started, completed

Tasks are persisted in data/tasks.json.