Docs

Agent

Tasks

Track work on the task board, run the agent on tasks, break them into sub-tasks, and connect chat channels.

The task board is Velork's built-in work tracker. Write a task, run the agent on it, and watch it move across the board while you work on something else. Each task the agent runs gets its own chat session.

Open the board from the Tasks tab in the title bar, next to Canvas and Editor.

Board and list views

Switch views from the toolbar:

  • Board shows tasks as cards in columns.
  • List shows a table with ID, Title, Status, Priority, Due, Agent, Changes, Time, and Updated.

The columns are Backlog, Todo, In Progress, In Review, Done, Canceled, and Duplicate. With All statuses selected, the board shows Backlog and Done and lists the rest under Hidden columns. Choose Active in the status filter to see Todo, In Progress, and In Review as columns.

Filter the board

Use the toolbar filters to narrow the board:

  • Status: all statuses, active, backlog, or a single column
  • Space: the workspace a task belongs to
  • Agent: No agent, Agent queued, Agent running, Agent completed, or Agent failed

Click Clear filters to reset them.

Create a task

  1. Click Add task at the bottom of a column or the list.
  2. In New task, give it a title and Add description….
  3. Set the status, priority, workspace, and due date, then click Create task.

A hint under the status says what the agent will do. With Agent automation on, a task created in Todo or In Progress runs right away. In Backlog it waits until you move it to Todo or In Progress, and in In Review it waits for your review.

Write the description as an outcome the agent can check. You can mention files and canvas layers with @ and paste images, the same way as in chat.

Title: Add the pricing section from the canvas
Description: Build @Pricing as a React + Tailwind section on the home page. Run the typecheck when done.

You can also ask the agent in chat to create tasks or sub-tasks for you.

Edit task details

Open a task to see and change its properties:

PropertyWhat it sets
StatusThe task's column
PriorityHow urgent it is
Due dateWhen it's due
WorkspaceThe project folder the agent works in
ModelThe model the agent uses for this task
GitRepository state for the task's changes

Activity shows the task's history, agent status, progress updates, and a summary when the agent finishes. Click Open Task Chat to see the agent's session for the task.

Once the agent has edited files, File changes lists them. Click Review all or Review file changes to see the diffs.

Break a task into sub-tasks

Under Sub-tasks, click Add sub-task to split the work into steps. You can edit or delete each sub-task. The agent works through the sub-tasks that are waiting, and each one gets its own summary in Activity. With Agent automation on, adding a sub-task to a task that isn't finished queues the agent for it.

Run the agent on a task

From an open task:

  • Run with agent starts the task now. After a failure the button reads Retry with agent.
  • Stop agent cancels a run in progress.
  • Open chat jumps to the task's chat session.
  • Commit commits the task's changes. More git options has the other git actions.
  • Delete removes the task.

The agent moves the card as it works. If a run fails for a temporary reason, the card shows when it will retry. If you stop the agent, move the task to Todo or In Progress, or click Run with agent, to resume.

Run tasks automatically

Turn on Agent automation in the board toolbar to have the agent pick up tasks in the background. With automation on, a task runs when you create it in, or move it to, Todo or In Progress. Tasks in Backlog wait. With automation off, tasks run only when you click Run with agent, and the task activity reads Automation paused - turn on Agent automation on the board to run.

What automated runs may do without asking follows Settings → Permissions → Autonomous runs. See Permissions.

Connect channels

Click Channels in the board toolbar to connect Telegram, Slack, Discord, Microsoft Teams, or a Webhook. Connected channels can create tasks and get notified as they progress. Click Back to board to return. See Task channels.

Plan limits

If a run stops because you reached your plan's limit, the task's activity shows Upgrade plan. See Plans and usage.

Next steps

Task channels

Set up Telegram, Slack, Discord, Teams, and webhooks

Permissions

Rules for agents that run without you

Sessions

Follow several agents at once

Still stuck?

Ask us anything, or see what changed in the latest release.

Changelog