Tasks (markdown outliner, in development) (part 2)
These command keys are rebindable. Open Settings → Keyboard Shortcuts → Tasks (the tab appears once Tasks is enabled) to remap any of the command-mode actions — snooze, deadline, priority, estimate, waiting on (A), finish, context, launch agent, break-down, command line, insert link (Ctrl/Cmd+K), the focus moves, the one-hand move keys (Shift+W/A/S/D), cut/paste (Ctrl/Cmd+X / Ctrl/Cmd+V), move to project (V), fold/unfold (F), and help.
On this page
What it is
This is part 2 of the Tasks (markdown outliner, in development) page. It carries the next stretch of the material on that page, moved here because a single page is capped at 40,000 characters.
Where to find it
Reach this part through Tasks (markdown outliner, in development) — it lists every part and explains where the feature lives in the product. Everything below is reached from the same place.
How it behaves
Everything below is the behaviour, detail and edge cases that belong to this stretch of the Tasks (markdown outliner, in development) page.
Keyboard: two modes (writing vs command) (continued 2)
| Key | What it does |
|---|---|
Space / Enter |
Space edits this row (writing mode); Enter adds a new task below. While typing, Enter finishes editing (commits text — no new row). |
Space |
Edit this row (drop into writing mode); F2 does the same — the Windows "rename" alias for Space |
Enter |
Add a new task directly below this one (same level + project) and start typing it |
Shift+Enter |
Add a new task directly above this one (same level + project) and start typing it — the mirror of Enter. (While typing, Shift+Enter is a normal line break.) |
Cmd/Ctrl+Enter |
Submit + start the next task below — commits the current task and opens a fresh row right below it in edit mode, so you can type task after task without lifting your hands (rapid entry). Works while you're typing the row (it commits first) and when a row is just highlighted. It no longer finishes/archives (that's x / e / Delete). |
c |
Context — add or review the task's context attachments (i is an alias) |
h |
Snooze — opens the universal snooze box (the same command-palette snoozer used for sessions and the inbox): type a time ("2h", "fri 3pm", "next month") or arrow to a preset and Enter |
d |
Deadline — a small picker opens: press 1–5 for a preset (today · tomorrow · end of week · next week · next month; each lands on the same day as typing its name, so next week is seven days out), type a date ("friday", "mar 15", "in 2 weeks"), or None to clear the due date; a check mark shows the current choice. A typed date-and-time like 2026-10-20 01:30 is read as 24-hour, and today's date typed with no time is due at the end of today. A numeric date is read in your language's own short-date order, so US English refuses a dotted 23.10.2026 instead of guessing, while a year-first date like 2026/10/23 is always read. The picker marks the deadline already set (it compares calendar days, not timestamps, so a date matching no preset leaves every preset unmarked), and setting or clearing one is announced to screen readers. Tab reaches the options at one stop (the marked one, or the first when none is marked) and the arrow keys move between them |
x / e |
Finish the task — marks it done and files it into Archived, in one press (undoable with Ctrl/Cmd+Z); the highlight then moves to the next task in the same project — the same rule snooze uses (next below it, else the one above, else the next project). (Cmd/Ctrl+Enter no longer finishes — it now submits + adds the next task below; see its row.) |
Delete · Ctrl/Cmd+Delete |
Archive the highlighted task — files it into the same reversible, browsable archive, but without marking it done, so it never counts toward what you finished today (the highlight advances; undo with Ctrl/Cmd+Z). On a repeating task it asks first: Just this one (the next copy still comes) or Stop repeating. Plain Delete needs no modifier. Never fires while you're typing in a row, and it's Delete only — not Backspace — except that on a Mac (or iPad/iPhone keyboard), whose delete key sends Backspace, Cmd+Backspace does what Cmd+Delete does. With several tasks selected, Ctrl/Cmd+Shift+Backspace archives the whole selection — every selected task together with its sub-tasks — under exactly this row's rule: into Archived, not marked done, asking first when a selected task repeats, and undoable with Ctrl/Cmd+Z (past 2,000 tasks there is no undo, as with any dialog-less bulk archive). With nothing selected it does nothing. A fixed chord, not rebindable. |
p |
Priority — a quick None / Low / Medium / High picker (importance). Press 0 for None or 1–3 for Low / Medium / High, or click a level. The picker names the level already set (Currently Medium) and marks it with a check mark, so you can see what you are changing from; setting one is announced to screen readers. Tab reaches the options at one stop (the marked one, or the first when none is marked) and the arrow keys move between them. |
t |
Estimate — set the task's time estimate: press 1–5 for a preset (15m / 30m / 1h / 2h / 4h), 0 to clear, or type a duration (30m, 1h 30m, 2h); a check mark shows the current choice. The field prefills with the current estimate so t then Enter keeps it. |
A |
Waiting on — mark the task as waiting on someone else: a small box opens to name who or what is blocking it and (optionally) set when to be reminded to chase it in plain language (Enter marks it; an empty box still marks it "waiting"). Once waiting, the box edits that name, sets a new reminder time, or clears it. The keyboard twin of the row's ⏳ button. |
w / s |
Move the highlight up / down (k / j and the arrow keys do the same) |
← / → |
Walk the tree — ← collapses the row when it has sub-items on screen, otherwise steps out to its parent; → expands a collapsed row, otherwise steps in to its first child. The standard tree pattern, so a nested task is reachable without touching the mouse. Home and End jump to the first and last visible row. Home and End previously scrolled the page. These four keys work on a highlighted row only — while you are typing in a row, ←/→ and Home/End move the text caret. |
Cmd/Ctrl+. / Ctrl+, (Mac: Cmd+Shift+,) |
Drill in / out (zoom into a task) — Cmd/Ctrl+. shows just the highlighted task and everything nested under it, hiding the rest of the project; the drill-out chord climbs one level back out (from a top-level task, back to the whole project list). Drill out is Ctrl+, on Windows and Linux and Cmd+Shift+, on macOS, where a plain Cmd+, belongs to the Settings menu. While you are drilled in, a breadcrumb bar sits above the list: click a parent crumb to jump to it, or the home Tasks crumb, titled Back to Tasks, to climb back. Single-project view only — it does nothing in All Projects or Today. On a phone, press and hold the left edge of a row to drill into it. A fixed chord, not rebindable. |
Ctrl/Cmd+↑ / ↓ |
Move between projects — jump the highlight to the previous / next project. In All Projects it hops between project headers (staying in that view); in a single-project view it switches the shown project. Wraps around. Mirrors the app-wide Ctrl+↑/↓ "previous / next project". In Today — a cross-project plate with no project rows, and where switching a project would leave the plate — it stays the app-wide previous / next project and moves the sidebar's selected project instead. |
Shift+W / Shift+S |
Move the task itself up / down — one-hand reorder. With multiple rows selected, the whole block shifts together within each row's sibling group (order kept); in All Projects, a top-level block at its project's edge crosses as a set into the neighboring project (appended, one undo); a nested block at its sibling-group edge cleanly stays put (nesting-at-an-edge stays single-task). For a single row at the edge of its sibling group, a nested (indented) row nests into the item beside it — move-down → first child of the item below, move-up → last child of the item above (same project only). A top-level row instead hops to the next / previous project at a project's edge in All Projects. |
Shift+A / Shift+D |
Move the task left / right — outdent / indent (one-hand) |
Ctrl/Cmd+X / Ctrl/Cmd+V |
Cut / paste the task — mark it to move, then paste it right below the highlighted task in the project list and the All Projects view (same project or across projects; Today shows a cross-project plate and hosts no cut/paste, though pasting a link onto a focused task still works); pasting onto a project's heading drops it INTO that project instead (even an empty one). With multiple rows selected, Cut grabs the whole selection, so pasting into a project moves them all. Cut marks only; nothing moves until you paste, and Esc cancels. See Cut & paste a task. |
V |
Move to project — open a small picker and choose another project to move the task into (works in both views; rebindable; the ⋯ / right-click Move to project is the same). The picker also has a "+ New project…" row — type a name and it creates the project, moves the task into it, and opens it (so it shows even when the current project is your only one), though it leaves you where you are if you have navigated somewhere else by the time the move finishes. And a Today row at the top — Add to Today (or Remove from Today if it's already on the plate) — so you can put a task on or off today's plate from the same menu, just like filing it under a project. Today is an overlay, so this keeps the task's home project (see Today). |
Alt+Shift+↑/↓ · ←/→ |
Reorder the task up / down · outdent / indent it (← out, → in) — the full OneNote-style outline-move scheme (←/→ are aliases for Shift+Tab / Tab). With multiple rows selected, ↑/↓ shifts the whole block within each row's sibling group (order kept); and in All Projects, when that block sits at its project's edge, the whole selection crosses into the neighboring project (appended there, one undo) — the multi-select twin of the single-row cross below. At its sibling-group edge a (single) nested row nests into the adjacent item (move-down → first child of the item below, move-up → last child of the item above; same project, depth preserved). Snoozed and waiting tasks hidden from the list are never the neighbor, in a project and in All Projects alike: a move lands right beside, nests into, or jumps past only rows actually on screen, and a hidden row it passes keeps its place; the list redraws in its new order at once, before the save returns, and the save names that same on-screen neighbor (the right-click Move up/down availability reads the same visible rows). While zoomed into a task, its direct sub-items are the top level: outdenting one says "Cannot outdent further", and moving the first or last one past the edge does nothing (a selected block too, even one that spans two levels), so a row never leaves the zoomed view. In All Projects, a top-level row instead crosses into the neighboring project at a project's edge — including into an empty project (indent / outdent, and a child's nest, stay within the project). |
F |
Fold / unfold this task's sub-items — hide its subtree behind a chevron (only acts when the task has sub-items) |
: |
Command line — type a plain-English line and press Enter: "due friday", "high priority", "#work", "move to Errands", "snooze 2h", "done". One line can set several fields at once. "not important" and "not high priority" set low priority. (Urgency phrases are ignored on the v2 surface.) Also: note <text> adds a note to the task; duplicate (or dup / copy) adds a copy of the task's own line right below it straight away — not a clipboard copy, and without the sub-tasks and notes that Ctrl/Cmd+D brings along; remind me <time> and hide until <time> work like snooze; complete, finish and mark done work like done. Tags you type are added to the task's current tags (remove a tag in Task details); a repeat you type replaces the current one. Ctrl/Cmd+Z undoes the whole line. |
Ctrl/Cmd+K |
Insert link — open a small popover (URL + optional text) and drop a markdown [text](url) link into the task: while editing, a selected word becomes the link text (you just type the URL); on a highlighted row, the link is added to it. An empty URL writes nothing and says Enter a URL. under the field; no text → the URL shows as the text. The submit button reads Insert link (or Save link when editing an existing link). Works like the notes editor's Ctrl+K. Rebindable, and also on the row ⋯ / right-click → Insert link (the mouse + phone path). |
g · b |
Launch/open the task's agent · break it down with AI |
Ctrl/Cmd+C |
Copy the task — puts its text (raw markdown line) on the system clipboard and on an in-app clipboard so you can paste it as a duplicate into any project (Ctrl/Cmd+V / Paste here; see Cut & paste a task). The same as the ⋯ / right-click Copy. A pasted copy — like a Ctrl/Cmd+D duplicate — keeps the task's due date, snooze, tags, both priority dials, start date, time estimate and, for a meeting, its alarm; it does not copy done, today's plate, waiting-on or the AI's tags. A fixed chord (not rebindable); while you're editing a task it's the normal text-copy. |
Ctrl/Cmd+Z · Ctrl/Cmd+Y |
Undo · Redo — step back through your recent changes with Ctrl/Cmd+Z and re-apply them with Ctrl/Cmd+Y (or Ctrl/Cmd+Shift+Z). Both go back up to your last 100 changes, are real (they persist), and are fixed chords; while you're editing a row's text they're the normal text undo/redo. See Archive & universal undo. |
/ · Ctrl/Cmd+F |
Find tasks — open the find-as-you-type bar; matches (and their parents) stay visible, everything else drops away. See Find tasks. |
Ctrl/Cmd+A |
Select all visible tasks — the bulk action bar appears (snooze / due / priority / move / finish the whole selection at once). While typing, it stays the normal select-all-text. See Select many & act once. |
? |
Cheat-sheet — every shortcut, grouped (the answer to "I forget the keys"); also opens from ⋯ More → Help & setup → Keyboard shortcuts in the header |
These command keys are rebindable. Open Settings → Keyboard Shortcuts → Tasks
(the tab appears once Tasks is enabled) to remap any of the command-mode actions —
snooze, deadline, priority, estimate, waiting on (A), finish, context, launch agent, break-down, command line,
insert link (Ctrl/Cmd+K), the
focus moves, the one-hand move keys (Shift+W/A/S/D), cut/paste (Ctrl/Cmd+X / Ctrl/Cmd+V), move to project (V),
fold/unfold (F), and help. Each action keeps its
aliases (focus-down is J + S, context is C + I, finish is X + E) and supports
multiple bindings; press + Add then your key, the X removes one, Default restores. The ? cheat-sheet then shows your actual keys.
An empty key list switches a command off, and a command with no saved override uses its default.
An AI helper can do the same over the control server: GET /tasks-v2/shortcuts lists every
command with its default keys, current keys and any key two commands share; PUT /tasks-v2/shortcuts/<command> rebinds one command (each key is checked like PUT /keybindings,
and a two-step chord is refused); DELETE /tasks-v2/shortcuts/<command> restores its default. Both
apply at once. An unknown command name is refused, and a saved override for a command that no
longer exists (the old archive key, from before Finish and Drop were split) is simply ignored.
The command list lives in src/shared/tasks-v2-commands.ts, so the app and the control server
read the same names and defaults. It is in cheat-sheet order, and its defaults are the keys Tasks
always used (G launches the agent, C or I opens context). Keys use the same text as the app-wide
shortcuts: a bare letter is stored in capitals because that is what a key press produces, and a
command with several keys (focus down is J and S, for vim and WASD hands) lists them all. On a
keyboard layout whose letters are not Latin (Russian, Greek and the like), the letter commands
and Ctrl/Cmd+Z / Ctrl/Cmd+Y match the physical key, so the Latin-labeled key at that position
still works; Latin layouts such as AZERTY keep matching the letter they type. The
Customized badge compares the keys themselves, so saving the defaults again is not a
customization. The structural
keys — Enter / Shift+Enter / Space / Esc, Tab indent, the arrows, Ctrl/Cmd+↑/↓ between projects, Ctrl/Cmd+Z undo + Ctrl/Cmd+Y redo, duplicate, and
archive (Ctrl/Cmd+Delete and a bare Delete) — stay fixed (the bare Delete→archive and
Shift+Enter→add-above are v2-only additions).
Leaving the list with the keyboard. Plain Tab indent is the outliner's core muscle memory, so
it never moves focus out — which used to trap a keyboard-only user, because Escape on a plainly
focused row (no selection, no metadata, no edit in progress) did nothing. Escape now releases the
focused row as the last step of its priority chain (clearSelection → closeMetadata → exitEdit
→ clearFocus), and once no row is focused the Tab branch stops claiming the key: Shift+Tab
then walks the browser's own focus traversal back out of the list. Forward Tab still does not
leave — the rows carry tabbable controls (the checkbox and the collapse toggle) that are hidden by
opacity rather than display, so they stay in the tab order; Shift+Tab is the one-press exit
because the container precedes its own descendants in DOM order. Releasing does not blur the list —
focus stays in it and the container shows its subtle inset focus ring (no row is carrying the
cursor cue, and the container's own outline stays suppressed), so the keyboard is never left
somewhere invisible; arrowing back in returns to the row you released, not the top of the list.
Re-entering the list from outside re-seeds the focused row from the container's focus handler.
What a screen reader hears on a row's checkbox. Each checkbox is named for its own task —
"Complete task: Buy milk", or "Select task: Buy milk" when Checkbox selects is on — so tabbing
down a list never lands on a row of identical "Complete task" boxes. A row with no text is read as
"Empty task". Every name read aloud uses the task's words without its markdown: a task written
**Quarterly** report for _Sam_ is read "Complete task: Quarterly report for Sam", and the same
goes for the row itself, the "Added task" announcement, the Today row's done and remove buttons,
and the task names Plan my day lists (it looks each one up by id, so it never shows a raw id).
taskPlainText (task-plain-text.ts, over the shared parseInlineMarkdown) is the one place that
turns task markdown into words (BUG-B022). The Today row's visible text still shows the markers;
that is a known gap.
Using Tasks with a screen reader (Narrator, NVDA, JAWS). In a single project, All Projects and Today, the highlighted row holds real keyboard focus, so the screen reader reads its title, whether it is done, and its shortcut keys. The list sits in a region named "Task list. Shortcut keys act on the current task.", which tells Windows screen readers to pass single keys to Tasks, so X completes, H snoozes, Y adds to Today and A marks waiting on the highlighted row instead of jumping to the next checkbox or heading. If Narrator still reads a letter as a jump key, press Narrator + Space once to turn scan mode off. Mouse and sighted keyboard use do not change.
The 15-level nesting limit. Tasks nest at most 15 levels deep (top level = level 1). An indent
(Tab, Shift+D, Alt+Shift+→, swipe right on a phone) that would push a task past level 15
does nothing and shows a warning toast: "This task is nested too deep. Tasks can be nested up to
15 levels." Add subtask on a task already at level 15 shows the same warning and adds no row. An
indent on the first task in its group (nothing above it to indent under) is a quiet no-op that
screen readers announce as "Cannot indent further".
What a reorder announces. Moving, indenting or outdenting a multi-row selection is announced
only when the block actually moved: Tab on a block already at the start of its group changes
nothing and stays silent, and Shift+Tab on a top-level block says "Cannot outdent further"
instead of claiming it moved. A press on a single row announces that row's own new level — or
nothing from the list when it could not move — even while other rows happen to be selected.
One list column. The All Projects rows, its Today band and New project footer, and the single-project list all sit in the same centered column (about 900px wide, with side padding), so a task row does not shift sideways when you switch between All Projects and one project. When a search or filter matches nothing in All Projects, the project list is replaced by a "No tasks match your filters" message with a hint and a Clear filters button.
Today never says you are clear while a filter is hiding work. Today's empty area has three states, and the difference between the last two matters because the Today filter bar persists across restarts. When the plate itself is empty, you get the first-task box and the AI launchers. When the plate holds open tasks but nothing is left after your sort and filter, you get "No tasks match your filters" with a Clear filters button — never the "You're clear for today" celebration, which would claim the day is done while unfinished tasks sit hidden. Only when the plate holds open tasks and no filter is active does the celebration show.
The first-task box files into the Inbox. The box on an empty Today saves through the same Inbox-first rule as the Today quick-add bar, the All Projects add box and the server's own default for an unfiled task: the project named Inbox when one exists, otherwise the leading project. It does not simply take whichever project sits at the top of the rail, so dragging another project above the Inbox never changes where that first task lands.
Importance ties fall back to your own order. Sorting by importance ranks None-level tasks last and treats a stored 0 priority as the same level as an unset one, so two tasks that both have no priority are ordered by the order you arranged them in rather than by how "no priority" happened to be saved.
What a screen reader hears in All Projects and Today. In both views the list is the task tree ("All projects" or "Today"), and the highlighted row itself takes keyboard focus as you move, so each step reads that task's name. In All Projects a project header is a stop of its own: it reads the project name, its task count, and whether it is expanded or collapsed, and its heading sits inside it for heading navigation. In Today, finished tasks sit in a group named "Done" inside the same tree, and each row shows which project it belongs to, read as part of the row's description. Each row is read as checked or not checked for its done state. The AI arrange button is read by its visible text; pressing it says that it is working, then the arrange summary is read once when it finishes.
Related
The overview, the other parts, and everything else worth reading next all sit on Tasks (markdown outliner, in development).
Last verified 2026-10-24