Tasks

A task is one thing you need to do. Tasks are the heart of plan afoot: everything else — plans, the board, dependencies — exists to help you move tasks from “someday” to “done”.

Title and body

Every task has two parts:

• A title — short, the one line you’ll recognise it by. A task can’t be saved without one.
• A body — an optional markdown note for the details: steps, links, context, anything.

Repot the lemon tree

It's rootbound — get the 30 cm pot from the shed.

due in 5 months Garden ↻ every spring · #2

needs · 1 blocks · 1

123456

1. 1 The title — the one line you'll recognise it by
2. 2 Due or goal date
3. 3 Which plan it lives in
4. 4 Repeats, with a count of times around
5. 5 Color-codes the card
6. 6 What it waits on, what waits on it

Creating a task

From Plans or the Queue, press + New task (or add task on a lane). Type a title, add a body if you want, and press Save. New tasks start in the Queue until you pull them into your week.

The editor

The body is a rich Markdown editor: type Markdown and it formats as you go, insert blocks from a slash menu, drag blocks to reorder, build tables, add links, and drop in images. See Writing for the full guide.

Pills: dates, plan, repeat, color, assignees

Below the title sits a row of pills — small controls that add structure to a task. Add only the ones a task needs; a simple task can be just a title.

• + when / Due / Goal — schedule the task. See Scheduling.
• The plan pill — move the task to another plan. See Plans.
• ↻ repeat — make the task recur. See Scheduling. Once a task has come around, a #N counter shows up next to it.
• 🎨 Color — tints the card, so it’s easy to spot on the board. Pick one of twelve colors, or none to clear it.
• Assign — in a shared quest, assign the task to members.

Below the pills, the Blocked by / Blocks chip strip shows tasks that must be done before this one and tasks that are waiting on it — see Dependencies.

On a phone, tapping a pill opens its editor in a sheet from the bottom of the screen.

Moving a task along

A task’s progress is shown by which column it’s in — Queue → Todo → Doing → Done. Drag its card between columns on the board, or use the Move control on the card or in the editor. Mark a task finished by moving it to Done or checking it off.

The detail page

Every task has its own page (a permalink) with a full read view and an Edit button. Open it from a card’s Open detail page option — handy for linking to a specific task or focusing on just one thing.

Deleting a task

Open the task and choose Delete; you’ll be asked to confirm (“Delete this task?”). If you only want to back out of an edit, use Cancel instead — it discards your unsaved changes without deleting anything.

After you confirm, a notice appears telling you what was deleted, with an Undo button — you have a few seconds to change your mind. The menu also has an Undo / Redo row for reversing recent edits.