Board & tasks
What it is
A task is one item on the board: what to do and how to tell it's done. Q or you create it; a session does it.
The task board lays out all tasks in four columns by progress. You can see all projects together, or just one. (At the top of the left sidebar: "Task board · all projects".)
| Column | Meaning |
|---|---|
| To do | Ideas, and work that's lined up; Q schedules from here and opens sessions |
| In progress | A session is working on it |
| Waiting on you | Every card says why it's waiting for you: needs your call, done and waiting for you to accept, or didn't pass when finishing (for example, tests failed) |
| Done | Done in the last 24 hours; older ones go to Archived |
When to use it
- You want to see at a glance what's in progress and what's waiting for you: look at the board.
- You have an idea to note down, with no rush to build it: create a task on the board and put it in "To do".
- You want to set the order yourself and move things around: drag them on the board.
It's fine never to look at it. Tell Q in one sentence and Q creates and orders the tasks.
How to use it
Creating tasks
- Tell Q what to do, and Q creates and orders it.
- Or click "New task" on the board, write a title and description, and it's noted as an idea in "To do".
- If you type a quick sentence, the system gives the task a tidy name. Your own words are kept as they were, and one click changes the name back.
- You can paste pictures and videos into a task. When you paste a screen recording, the app pulls out a few key frames for the agent to look at.
When ideas pile up in "To do", they fold into one line, "N more ideas", and Q sorts them for you once a week.
Task numbers
Every task has a number, written as "prefix-number", like QS-13. Each project sets its own prefix (change it in the project's "⋯" menu).
Task numbers mentioned in replies show up as small chips; click one to open that task. Mention a task number when talking to Q, and Q knows which one you mean.
Handing it out
Open a task and click "Let Q plan it", or "I'll do it" (opens a session you look after yourself). You can also drag the card from "To do" to "In progress".
Before handing it out, you can tick "Show me the plan first": the session hands in a plan first, and only starts changing things once you click "Approve". Good for big changes you want to check first.
What you can see in a task
- On the card: what the agent is doing right now, its place in the queue, whether the computer is asleep, and how many days it has been waiting for your acceptance. It turns grey after ten minutes without activity.
- Acceptance criteria: listed one by one. When the agent ticks one as "met", it has to write how it checked. Its ticks show as hollow grey checks, separate from the ones you tick yourself, and you can untick them.
- Test results: for example, "Last 10:06 · Tests 12 / 12 passed"; if the code changed after that, it says so.
- PR and CI: when the project uses GitHub, QU uses the
ghyou signed in to yourself to check pull requests (PRs) and automatic checks (CI). Failures, conflicts and requests for changes are sent back to the session in charge automatically. - Spend: how much each session used and how long it ran; click a row to go to that session.
- Estimate: based on the tasks this project has finished before, for example "usually 40 minutes to 2 hours".
What comes first
- Big jobs are split into subtasks, ordered as step 1, step 2. In the plan view, one drag sets the order; anything that would make a loop is stopped.
- For each task you can choose what happens when the task it waits for is done: hand it out automatically, or ask you first.
- If the task it waits for gets dropped, you're asked whether it should still wait.
Take back, start over, undo
- Take back: drag a task in progress back to "To do". The code stays on its branch; hand it out again and it picks up where it stopped.
- Start over: if you're not happy with the result, write what's wrong, and a new session starts from scratch. It only brings the revised requirements and the prototype; the old commits are kept.
- Undo: for a few seconds after handing out, accepting or sending back, you can undo it. An acceptance clicked by mistake can be undone too; if it's already merged into main, you're told how to undo it.
Dragging, multi-select, filters
- Cards can be dragged to other columns, and moved up and down within a column.
- Hold ⌘ or Shift to select several and change them together.
- Cards can be dragged into Q's chat to talk about them.
- You can show only the ones waiting on you, group by project, and filter by version; search also covers task descriptions.
How many run at once
Set a limit for each computer on the "Computers" page. When it's full, newly handed-out tasks queue, and they start automatically when a slot frees up. There's no limit by default.
FAQ
How do tasks and sessions relate? A task is "what needs doing"; a session is "the conversation that does it". When a task is handed out, a session opens to do it. You can also have sessions without a task (small jobs you look after yourself).
Where do finished tasks go? For 24 hours they're in the "Done" column; older ones go to Archived, and you can still search for them.
Can I get a "Won't do" task back? Yes. It goes to Archived, marked "Won't do", and isn't shown on the board.
Where do I accept work? Open the task in "Waiting on you"; the top of it is the acceptance view. See Prototypes & acceptance.