Todos & subtodos

A todo is a title plus whatever structure the work deserves: a rich description, a status, a priority, labels, a due date, comments, and subtodos. Every todo gets a short identifier like MZ-123 — stable, human-readable, and safe to drop into commits and conversations.

Creating todos

Press C in a list to open the new todo dialog. ⌘ Enter saves; ⌘ ⇧ Enter saves and keeps the dialog open for rapid capture.

Descriptions

Descriptions are collaborative rich-text documents with markdown formatting. Two people — or a person and an agent — can edit the same description at once, and edits merge in real time.

Subtodos

When a todo turns out to be several pieces of work, break it down instead of letting the description sprawl. On a todo’s page, press C to add a subtodo (or S from a todo’s context menu). Subtodos are full todos — they have their own identifier, status, and detail page — nested under a parent, so you can track progress piece by piece.

Working with a todo

Open a todo to see its description, properties, subtodos, comments, and an activity timeline of what changed and when. From there:

• ⌘ C copies the todo’s identifier
• ⌘ ⇧ L copies a link to the todo
• ↑/↓ (or j/k) step to the previous or next todo
• ⌘ ⌫ deletes it — deleted todos go to the trash and can be restored

Comments

Every todo has a comment thread. Use it for decisions and context you want attached to the work rather than lost in chat — agents can read and write comments too.