Tasks¶

A task is one piece of work: a title, what done looks like, and everything learned along the way. It is what you hand an agent, and where the agent reports back.

Add a task¶

On Tasks, press New task or t then n.
In the composer, describe the work and send it. SBT files a task from your words.
From a terminal: sbt create "Fix the login timeout".

Each task gets an ID from its workspace's prefix, such as WEB-12. The ID never changes, even if the task moves.

Your order¶

All your tasks, across every workspace, sit in one order that only you set. Status, priority and due dates never reorder it, and agents leave it alone unless you ask. The top of the list is what comes next.

Move a task from a terminal, or ask an agent to:

sbt rank task WEB-12 --top
sbt rank task WEB-12 --after WEB-7

What a task holds¶

Open a task to see its detail. Click any field to edit it in place.

Field	Use it for
Status	Where the task is, from the workspace's stages
Definition of Done	The checks that must pass before it is done
Waiting on	Who or what it is blocked by
Depends on	Tasks that must finish first
Project and milestone	The larger piece of work it belongs to
Priority, due date, labels	Your own signals; none of them change the order
Notes and final summary	What the agent did and found

A checked Definition of Done, a merged pull request and a finished agent are separate facts. None of them moves a task to Done on its own. If you want tasks in Testing or In Review to become Done after a delay, set it in Settings › General › Automatic completion.

Projects¶

A project groups the tasks that make up a larger goal. Its tasks are its scope: work without a task is out of it. A project is done when its tasks are done. Milestones split a project into ordered steps. Initiatives group projects.

To move a task into a project, drag its row onto the project's heading.

Views¶

A view is a saved way of looking at tasks: its filters, sort, columns and highlights. Click the view name at the top of Tasks to switch views; the + beside Tasks in the sidebar makes a new one. Filter with the search field, sort or filter by a column from its header, and colour rows that match a rule with highlights. Unsaved changes stay until you save or discard them.

Several at once¶

Shift-click selects a range, and ⌘-click adds or removes one row. Right-click the selection to act on all of it.

Set aside or drop¶

Snooze hides a task until a date you choose.
Archive drops a task you won't do. Done tasks are completed instead.