Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
Tasks
Surface
The main Tasks list (List layout, not project or CRM task lists) starts with the Tasks TutorialRow (from features/video-tutorials) once that video is in its catalog; it sits outside the virtualized rows, so list keyboard focus skips it.
Go to Tasks → /app/component/tasks. Task views: My tasks, All tasks, and Created by me.
The single-row desktop header contains the title, Filter, a separate
Task layout single-select icon group for List, Board, and enabled Gantt,
Sort, Group, New, and an expandable Search icon
(Ctrl+F opens it). The active-filter count sits beside the filter icon inside
its button, without overlapping the icon or the group border;
the filter uses the legacy compact option rows and searchable Assignee, Created by,
and Tags submenus. They use the shared multiselect dropdown pattern:
checkboxes toggle and stay open, rows add and close, and Shift/Only selects just
one option and stays open. Escape dismisses the menu.
The top of the Filter menu is a Filter with AI… textbox, focused when the menu opens: type a plain-English
description such as urgent and high priority tasks that are not completed and press
Enter. It replaces the current selection with the matching Status, Priority, Assignee,
Created by, and Tags options (exclusions on Status/Priority become the complementary
options; subject matter such as about billing lands in the search box), then closes
the menu. Requests that only partly map keep the menu open and show a muted note
under the box; requests that map to nothing (excluding a tag, an unknown person,
off-topic text) keep the typed text and show a red error there instead. The box keeps
focus while you type even if the pointer drifts over the rows; ArrowDown moves into
the rows and hovering a submenu hands focus to it as usual. The mobile drawer has no
AI box.
The desktop sidebar's Search icon, immediately left of collapse, opens the
search field above New. It shares the current Tasks or Projects list query.
The desktop sidebar and toolbar New menus offer Task, Subtask, Project (when
Projects is enabled), and Tag. Task and Project open their existing composers;
Tag opens the tag editor, with personal scope selected and team sharing available
when the user has a team. The Projects list uses the same menu. Mobile creation
controls are unchanged. With Projects enabled, the collapsible Projects section
appears above Saved views. It contains My projects (assigned to the viewer),
All projects (all accessible projects), and Created by me (owned by the viewer).
These replace the old Projects tab and individual-project shortcut list. The plus
beside the section opens the project composer even while collapsed.
On mobile, one Projects pill opens a drawer with the same three views; the
active pill shows the selected view's name. Selecting a task or saved view clears
the project pill's active state. Project scoping applies before pagination and
cannot be removed by clearing editable filters. Opening a project and returning
through its breadcrumb retains the selected project view.
Cached project rows remain available through offline/background refresh failures.
Cache misses, server/permission errors, and failed continuation requests retain
failure and retry controls.
Opening a project shows a content-shaped skeleton while its data loads: title,
wrapping property pills, description, and discussion for Overview; toolbar and
rows for Tasks. The mobile skeleton uses the same compact insets as the content.
The description has its own subtle three-line skeleton while its collaborative
editor initializes; the project title, properties, and discussion stay visible.
Priority groups appear in Urgent → High → Medium → Low order, followed by the unset-priority group, in desktop and mobile lists. Verify this order with REST and GraphQL Soup before and after refresh; item sorting is independent.
Task lists, including project and CRM task lists, load a group's next page when
the end of that group scrolls into view, with a spinner row instead of a
Load More button. A failed
page shows Retry in that row and stops automatic requests for the group.
ArrowDown waits on a group's last loaded task until the next page arrives; after
a failure it continues into the next group. Collapsed groups load nothing. A page
that arrives after you scroll past its group must not move the rows on screen.
With GraphQL Soup enabled, verify a group with more than one page in both the
regular Tasks list and a project task list (scroll and ArrowDown). Both must use
the parent Soup query's continuation owner; reaching
the last page removes the group's paging row without hiding already loaded tasks.
Refresh a group containing at least 11 tasks while delaying its continuation
response: every already loaded continuation row should stay mounted, with no
brief collapse to the first 10 rows. Verify both background and explicit refresh,
including a changed cursor and a failed later page. Retrying should replace the
old pages; changing projects or filters must discard the old scope immediately.
The sidebar has no Tags section: filter by tag from the Tags group of the Filter menu,
and switching tabs clears it like any other filter. On mobile, the tabs
are pills and the leading sliders button opens one drawer containing Sort, Group, and
Filters (including Tags). The mobile bottom dock has + Task and Search,
with no floating Ask AI input.
Mobile does not show the separate layout, sort, group, and filter toolbar.
Use the compact sliders drawer for task-list controls; project task lists use the
same drawer. Mobile supports List only. Opening a Board or Gantt link, or
restoring either layout, automatically selects List and replaces that host's
layout URL parameter without adding history or clearing search, sorting,
grouping, or filters. Desktop supports List and Board, plus Gantt when the
PostHog enable-gantt flag is enabled, or when running the local hot-reload
preview. This flag also gates project-task and Projects collection timelines. When the flag is disabled or still loading,
saved Gantt layouts and Gantt URLs render List without clearing the selected
layout, so enabling the flag restores Gantt. The local override is
VITE_ENABLE_GANTT=true (or false to force it off).
Keyboard: H and ← collapse the focused item or its parent group. On a focused group header, H collapses only that group; pressing it again does nothing. Typing H in a text field remains ordinary input.
New accounts are seeded with three sample tasks (Intro to tasks, Advanced task features,
How we use tasks at Macro).
The Project column shows the linked project's name when one project is assigned,
and Project when empty. Multiple linked projects show an item count.
Long assignee and project names truncate within their columns; hover the cell
to read the full value.
Editable property controls use ghost-button hover styling. Empty values are
dimmed, without adding opacity to the already-muted No priority icon. Folder
and assigned Project hover cards put their heading above the value; empty
Project keeps its simple one-line message.
Folder pills keep their link color and become circular when icon-only. When the
title area runs out of room, the folder path collapses to a clickable icon with
a full-path hover card first. Show at most three individual tag chips and keep the
rest in the existing overflow chip. As space shrinks, move more chips into
overflow one at a time before truncating the title. A task with only one tag
keeps that named chip, including on phones, rather than showing “1 tag”.
Open the overflow to edit all tags; hover it for hidden-tag names and filter/edit actions.
The overflow chip reads “N tags” when it represents all tags, or “+N tags” when
individual tag chips remain visible.
An open picker or nested tag editor stays mounted while resizing or when a
sorted insertion moves its chip into overflow. Keep the active chip within the
visible-chip cap until closing, then restore normal order. Live tag refreshes
retain staged picker changes while accepting remote changes and deleted tags,
including when a failed tag deletion restores its option. Add tags in a
constrained row and close the picker: excess tags must enter overflow without
resizing or reloading, restoring title space before truncating it. The share
indicator remains immediately beside the title whenever it is shown.
Compact desktop rows keep tags after the title and before the trailing properties;
phone rows retain the single tag or collapsed multi-tag chip instead of dropping tags.
Tag pills keep their compact height on touch.
Task rows order trailing properties as Due date, Project, then Assignees on
desktop and phones. List Due date icons use 12px on wide rows and the shared
16px icon size in compact columns. No due date uses a slashed calendar in rows,
property pills, the Properties panel, board cards, and group headers; populated
dates keep their calendar icon. Compact rows show both avatars for exactly
two assignees; larger groups show the first avatar
and the remaining count. Compact assignee slots reserve their width and keep the
first avatar anchored left, so a second avatar or count grows only to the right
without shifting Project or other properties.
Desktop and tablet rows keep the compact column grid and its header at every
pane width; only phones use the headerless narrow row layout. At list-container
widths up to 840px, Project, Assignees, Due date, and Updated headers
become icons with hover/focus tooltips and accessible names. Project occupies 32px
and Assignees 44px. The assignee header aligns with the first avatar. Updated
fits its full header and sort arrow, with a 56px content minimum for single-line
timestamps. At 600px, Updated fades and collapses over
160ms to leave more room for the title. Hidden Updated and Created by
columns reserve no width or spacing; visible cells own their 8px leading inset.
Reduced-motion preferences disable the transition. Visible timestamps stay on one line, and
Updated remains sortable. Created by is the final column, with a 16px avatar above
840px and a 20px avatar at compact widths, plus a 16px gap after Updated. Its header
keeps a 16px user-plus icon with a “Created by” tooltip on hover or focus. Owner names and the column label
stay accessible; names remain available on hover. The creator header and avatar
stay visible above 600px and hide alongside Updated at 600px. Shared tasks show the
shared badge next to the title only while the creator column is hidden.
The Projects collection reuses a single Due date column and hides Updated in compact panes.
Property controls retain their selected values in accessible names when compact styles hide the text.
The project pill beneath a task title shows the project icon and name without
a Project: prefix. It and the Project row in the Properties side panel split in
two once a project is set: the name opens the project (shift-click for a new
split, and an already open project is focused instead of opened again), and the
caret changes the project. Hovering the name turns its icon into an arrow. People
who can't edit the task get the name alone, so they can still open the project.
An empty or unavailable project keeps the plain pill, and composers never split it.
The property pills beneath the task title place Due date before Project and
Assignees. Due date has no Due date: prefix and uses a 12px desktop icon.
On touch devices, these pills use 16px Status, Priority, Due date, and Project
icons, including empty values. The tags selector in that row has a 36px minimum
touch height.
Task-list tags and property icons retain their separate compact sizing.
Empty values in the Properties panel show No status, No priority, Unassigned,
No due date, or No project with the shared empty-value icons; custom fields show
Not set. Click the empty value to open its existing picker or inline editor.
The Properties panel also uses 16px Project icons on touch, for both assigned
and empty values, without changing desktop sizes.
Enter activates a pill or any other document control holding focus, including one
that gets focus back when its picker or menu closes, however it closed. After a
mouse click on a control, Enter still moves to the editor. Tab reaches an editable
property's pill directly, so its hover card opens on hover only; a read-only
property keeps a stop that opens the card.
Wide desktop task rows and group headers share their leading icon alignment.
Task group headers retain their wide-layout caret-to-content gap at every list
width, including phones: 8px in the Tasks header and 10px in the next-soup header.
Their padding and the spacing between the value icon, label, and count stay
unchanged; the value-icon slot keeps its width when the pane narrows. Long labels
truncate on one line. Group-header caret containers stay square around their
16px glyphs, with 16px status and priority icons. Desktop list insets follow the
list container: 8px below 640px and 12px from 640px; phone insets remain 4px.
In grouped task and project lists, the current group header stays pinned at the top
of the scrolling pane until the next group pushes it away. The pinned header still
collapses or expands its group; keyboard navigation keeps rows below it visible.
Mobile headers remain below the floating chrome.
Phone task rows have 44px row height and an 8px unread-dot rail without a checkbox
column. The rail stays reserved on read tasks so titles do not shift. Status and
priority controls retain their 36px touch targets; selection highlighting and row
selection behavior remain available.
Click or tap the leading status or priority icon to edit without opening the task.
Status icons are 18px on desktop and phones; priority icons are 16px on desktop
and 20px on phones and never flex-shrink. Phone tap targets sit edge-to-edge.
Priority comes first, then Status directly beside the title. The shared badge follows with
4px of layout spacing and its existing internal padding. Their pickers replace
the separate Status/Priority columns and duplicate trailing mobile pills; Project
and Assignees stay on the right, with 20px phone icons. Empty assignees use a filled
person in a dashed circular frame. Empty priority shows the same wide ascending
bars as Low/Medium/High, with every bar at 30% opacity. Urgent shows a rounded
square with a transparent exclamation cutout. Completed and Canceled use filled
discs with transparent check and cross cutouts. Set projects use a cube; empty
projects use its corner-dashed counterpart. Not started stays a neutral hollow
ring without shadows or highlights; In progress and In review add counterclockwise
half and three-quarter pies from 12 o'clock. Current status colors and icon
dimensions stay unchanged.
The property edit menus use 16px status and priority icons on desktop and mobile,
including empty-value options.
Each status has its own task-status-* theme color, shared by task icons and
group-header tints. Completed defaults to accent; explicit Completed theme overrides
remain available. In the theme editor's Task statuses section, change a status
color and verify its icons and group-header tints update together in List and Gantt,
while Board column icons match and global warning/success colors stay unchanged.
In Progress defaults to amber blended with the theme's foreground: 20% foreground
in dark mode and 15% in light mode. Check the icon's legibility against the list,
menu, and board surfaces in both modes; custom status-color overrides stay intact.
Click a task row or favorite to replace the list with the editable task document. Its top bar shows the originating task tab as a text-only return breadcrumb, followed by the task name and actions, Share, and the Details/Properties side-panel toggle. The return label matches the task title's font weight in both wide and narrow layouts. Narrow splits also show a close button when multiple splits are open. Choose the originating tab breadcrumb, a task tab, or a tag to return to the list. Shift-click a row or favorite to open it in a new split instead. Keyboard list navigation only moves focus; press Enter to open the focused task.
Status and Priority values use 12px icons beneath the opened task's title on desktop, 16px on touch, and 16px in the Properties side panel. Number, text, and link values in the Properties side panel edit in place. Enter saves and Escape cancels, and both return focus to the value, or to + on a link list, so the keyboard stays on the row. A failed save leaves the field open and focused. Tab or a click elsewhere saves and leaves focus where it went.
In the task's Properties side panel, hover or focus a row for Pin below title or Unpin from title. Pinning adds the property to the title row; unpinning keeps its saved value and the side-panel row. The title pill's hover card also offers Unpin as a filled icon-only button with a gap: beside the value in a row, or beside the key above a full-width divider in a column. Status, Priority, Assignees, and Due Date are pinned by default, with Project when enabled. Defaults apply only when the task has no saved pin list; customized pins stay unchanged. Unpinning a default preserves the other pins, and clearing all pins stays cleared after reopening. The empty Project placeholder can also be pinned or unpinned without creating an assignment; its pin follows the real assignment when one is saved. Builtin task properties cannot be deleted from the title or side panel.
Property edits should update the visible task before the save finishes. To verify, delay the GraphQL mutation and change Status, an existing Priority, and an unset Priority in the list and task detail. In a view grouped by that property, the task should move groups and update both counts immediately. Reject a save to check that the value, group membership, and counts all roll back without refreshing the page.
For tags, include a task with no prior tag assignment. Delay
UpdateEntityPropertyOptions and the following EntityProperties query: the tag
should appear immediately and stay visible through both responses in the list,
task header, side panel, and a reopened picker. A rejected save should remove only
the optimistic tag. Repeat with an existing assignment and with removal.
Due dates
Tasks lists and boards offer Status, Priority, Due soonest, and Due furthest away sorting alongside Viewed, Updated, and Created. Status follows stored option order; Priority puts urgent tasks first. Missing values stay last. Property-sort ties use newest update, then descending task ID. Text search retains its existing ordering and flat list results; clear search to sort. Boards group the loaded search results as before, without complete counts or grouped-search requests.
Filter → Due date offers Overdue, Today, Tomorrow, Next 7 days, Later, Has due date, No due date, and Custom range. Any due date removes only the date filter. Custom range includes both selected calendar dates; either endpoint can be empty. Cancel leaves the previous filter unchanged. Status remains independent: select Completed or Canceled explicitly to include closed tasks in a date filter. The mobile controls use the same options and date-range dialog in the sliders drawer.
Group → Due date puts No due date first, then uses non-overlapping viewer-local calendar buckets:
Overdue is before today's midnight; Today and Tomorrow cover those entire days;
Next 7 days covers D+2 through D+7; Later starts at D+8; No due date includes
missing and cleared dates. Relative filters and groups refresh at local midnight,
timezone changes, and app resume. Changed boundaries start fresh continuation pages.
Task lists show an editable Due date property column with a calendar icon
only when a date is set; click its header to switch between Due soonest and Due
furthest away. Phones and narrow panes show only the urgency-colored icon for
dated tasks. Empty date cells remain editable without a calendar icon. The
dropdown shows the current date, or No due date when unset, above the date
choices. Due dates stay outside the title.
Board cards show due dates in property pills. Overdue dates
on open tasks use the danger color; only dates due today or tomorrow use the
warning color. On light themes, list and board warning icons and text mix 60%
warning with 40% foreground for contrast; dark themes keep the warning color.
Later dates, completed tasks, and canceled tasks have neutral due dates. Urgency
refreshes at local midnight, on timezone changes, and app resume.
Date selections persist with the navigation entry and round-trip through
tasks.dueDate, tasks.dueStart, and tasks.dueEnd URL parameters.
Verify dates around midnight and a daylight-saving transition. Check both sort directions with tied and undated tasks. Filter during local and service search, then edit or clear a due date: loaded rows move between buckets immediately, and refetches correct complete counts and previously absent tasks. Gantt's saved-date semantics do not change.
Saved views
Saved views are available on main Tasks, not inside Project or CRM task lists.
- Desktop: use the Saved views sidebar section. Its icon-only + remains available when the section is empty, populated, collapsed, loading, or in an error state. Enter on the focused + starts a draft instead of opening the selected task.
- Mobile: the Saved views pill sits after Filters and before the built-in task tabs, using the same mobile pill component. It shows the selected view's name and active styling, and opens a drawer of saved-view rows with selection and management menus, without a duplicate section heading or a header create button. Create views from changed filters, layout, grouping, or sort in the filter drawer.
- The empty sidebar and mobile picker show Your go-to views, the muted description Save your setup for next time., and a secondary Create view button with a leading plus icon in a rounded container with a subtle border, 12px padding, the surrounding background, and no shadow or illustration. It starts the same unsaved draft as desktop +; on mobile, the picker closes first. Configure the draft in Filters, then choose Save view.
- Desktop + starts an unsaved view without person restrictions and with explicit open-status filters. It expands the section and adds a selected, italic New view row labeled Draft in the sidebar and mobile picker. Configure filters, then choose Save view; the name defaults to New view and can be edited before saving. A confirmed save replaces the draft with the named view; Cancel in the desktop toolbar or mobile filter drawer, another selection, or leaving Tasks removes the unsaved row. Canceling only the name dialog keeps the draft for later.
- Desktop Save view and draft Cancel are separate standalone buttons with a gap, not segments of a button group.
- When filters, due date, layout, grouping, or sort differ from the built-in tab defaults, the filled Save view button appears immediately left of Filters on desktop and in an edge-to-edge mobile banner above the filter drawer footer. The borderless banner overlays content on a drawer-colored backing and has a leading bookmark icon on its button. Base settings and search alone do not show the banner. It captures current filters, relative due-date presets or custom calendar bounds, layout, grouping, and ordered sort directions, but excludes text search and scroll state. My Tasks adds Me to Assignee; Created by me adds it to Created by. Additional people in the same filter use OR matching.
- Saved views use the normal Assignee and Created by filters, not a separate Scope control. Me stays relative; its tooltip says “Matches whoever opens this saved view.” A named person stays fixed. Removing Me removes that restriction.
- Temporary filter, due-date, layout, grouping, or sort edits show a filled Save changes button and Reset. Opening or resetting a saved view restores all five, including due-date grouping and property sorts. Older definitions without a due-date filter remain unrestricted. Mobile still displays a list without replacing the stored desktop layout. Right-click a sidebar view or use its … button for Edit, Duplicate, Copy link, and confirmed Delete view. On desktop, the selected view's topbar shows a bookmark icon before its name and an unframed ghost overflow button immediately after it. On mobile, the picker shows the name and contains row menus; creation and draft cancellation appear in the filter drawer's overlay banner above the footer; Save changes and Reset sit on the footer's right, opposite Clear all, not below the tabs. Non-owners cannot rename, share, overwrite, or delete a shared view.
- Edit opens the shared create/edit dialog with the saved name and team-sharing checkbox prefilled, without saving temporary filter, layout, grouping, or sort changes. Edit and delete dialog titles identify the saved view by name and wrap long names. Both create and edit modes use a 600px-wide dialog that stays within narrow viewports. Duplicate opens a private copy with a prefilled “(copy)” name; duplicating the selected view includes its temporary settings. If the original has unsupported or invalid settings, the dialog warns that the copy omits them and leaves the original unchanged. Sidebar actions on another view do not change the current selection unless a duplicate is saved.
- The optional Share with team checkbox shares only the view definition. Its adjacent info icon shows the explanation on hover; click, tap, or keyboard activation opens it without changing the checkbox. Each teammate still sees only permitted items. Both the owner and viewer must currently belong to that team; leaving disables access and rejoining restores it.
- Leaving the view or opening task detail discards temporary edits. The return breadcrumb retains the saved-view identity and reloads its saved filters, layout, grouping, and sort.
- An unavailable or deleted view shows an explicit unavailable state, not All Tasks under the old name. Unsupported or malformed filters are skipped while supported filters apply immediately. A danger-colored banner above the results names affected filters or view settings without an extra description. If no filters apply, the list shows all permitted tasks, including closed tasks. Loading never changes the saved definition. Unknown tag/person labels retain their filters until deliberately removed. Ordinary Save changes is disabled until the app understands every setting or the owner explicitly removes unsupported settings; Edit remains available.
- Owners can choose Remove & save at the right edge of that banner. It removes only skipped settings from the stored definition, preserves supported filters, due date, layout, grouping, sort, and sharing, and leaves temporary edits unsaved. The banner disappears only after a confirmed save; failures retain it for retry, and revision conflicts offer Reload saved view.
- A conflicting save retains the draft and offers Reload saved view or Duplicate. A network failure also retains the name and sharing inputs.
- Copy links use the existing split search codec, for example
/app/component/tasks?s0.tasks.savedView=<uuid>.

Verify creation without early persistence, explicit save/reset, copy versus owner-only editing, desktop/mobile metadata dialogs, and returning from task detail. Repeat with another teammate, a removed/rejoined owner, an unavailable tag, and a stale revision.
Exercise these flows at desktop, phone, and tablet widths. Verify the mobile pill strip reserves its full height without overlapping task content, including after scrolling and returning from a drawer. Check that the mobile creation banner stays above the footer while filters scroll behind it and that the final filter controls can scroll clear of the banner. Verify it appears for changes to filters, layout, grouping, or sort and disappears when all four match the built-in tab defaults. Check keyboard navigation inside the mobile picker and focus after opening and closing Edit, Duplicate, or Delete. These focused dialogs use the shared imperative dialog host and must close when their owning account or view changes; the picker closes before a management dialog opens. Saving from the filter drawer closes it before opening the name dialog; Cancel or Escape reopens the unchanged filter draft, while a confirmed creation selects the new view without reopening the drawer. Delay a save while navigating or editing filters, and delay a deletion while selecting its target: stale saves must not change the new selection, later filter edits must survive, and confirmed deletion must clear its selected target. Also return a malformed definition from create or from another row's update: the selected view must remain accessible. Advance the selected view's revision while a duplicate saves; completion must not navigate away. Ordinary creation retains current facets even if its confirmed definition differs. Verify mixed supported and invalid entries, unsupported fields, conflicting tag bindings, and an unknown version. Supported conditions must immediately filter results while the danger banner stays visible. If none apply, verify unfiltered tasks, including closed tasks. Confirm the saved definition is unchanged on load, reset, and navigation, and permission failures still show an unavailable state without querying tasks. Verify banner cleanup on desktop and mobile, including an entirely unsupported definition. Confirm that only owners see the action, temporary filter edits stay unsaved, sharing stays unchanged, and failed or conflicting writes retain the original definition and warning. Verify layout-only, grouping-only, and sort-only save/reset, duplicate and reload, sort direction, mobile list fallback without overwriting a saved board/Gantt layout, and delayed saves while presentation changes. Older views without grouping default to Priority. A future filter, layout, grouping, sort, or version must warn and block ordinary Save changes without altering the original; explicit cleanup remains available.
Gantt layout
Choose Gantt in the Task layout group to see task timelines. The same option is available in a project's Tasks section. The timeline uses Created at as the start and Due date as the end; no separate Start date is created or saved. Bars without a due date fade to transparent at the right edge. The fade affects only the bar fill; labels remain visible. Their displayed tail is a visual placeholder, not a saved deadline. Invalid or missing start dates and due dates before creation are identified rather than silently displayed as valid intervals. The calendar fills the available pane width and height, including empty space below loaded rows. Zooming, pane resizing, and loading earlier items preserve the visible calendar position. On first load, the chart centers on today after its viewport is measurable. Refetches and later resizes do not reset the scroll. Bars use the app's neutral depth-two surface without an outline, with a small status-colored indicator. In light mode, bars have a stronger solid neutral fill, and item panels have a subtle neutral fill and clearer border. Dark-mode base surfaces stay unchanged. Active items due within seven calendar days use a danger-color background gradient at the due-date edge, blending into the neutral fill toward the left and strengthening as the deadline approaches. Due-today and overdue items use the strongest tint; completed, canceled, and undated items stay neutral. Deadline tints and the Today marker refresh at local midnight and when a tab becomes visible or focused again. The tint only appears when the actual end is inside the calendar range. Bar text stays inside the visible portion of its bar as you scroll, zoom, or open the item drawer, and truncates in narrow segments. The full-width date header stays visible during vertical scrolling; the pointer's date label stays in that header, and the vertical scrollbar begins below it. Timeline-edge fades stay within the date header, beneath its floating buttons. Fades start at the calendar edges, span up to 128px, and shrink in narrow calendars. The floating item list uses separate rounded, bordered, low-contrast panels for consecutive groups. Items clip inside their panels and use the same height and padding as bars, with transparent backgrounds and hover-only highlighting. Group headers match the normal list's rounded surfaces, status tints, disclosure controls, and count pills. The list starts expanded in wide panes and collapses automatically below 640px until you explicitly choose open or closed. That choice stays in effect across pane resizes while the chart is mounted. Use the top-left toggle to change it. The drawer slides in and out, respecting reduced motion, and shares vertical scrolling with the bars without shifting dates or reserving calendar width. Clicking or focusing the calendar keeps the list open. Escape or the toggle closes it; focus returns to the toggle when closing a focused item. Closed drawer items are not focusable. Task and project context menus remain available on drawer items. Today and timeline settings are separate floating buttons at the top right. Hold Ctrl or Cmd and scroll to zoom between 4 and 80 pixels per day, keeping the date under the pointer in place. Hold the middle mouse button and drag to pan both axes, including from bars or item panels, without changing dates or grouping properties. Release the button, press Escape, or move focus away from the window to stop panning. Ordinary scrolling is unchanged. Period presets in the settings menu also set zoom; calendar labels adapt to the zoom level. Floating controls at the chart's bottom right zoom out/in around the visible calendar's center. The percentage/reset button stays visible; adjacent minus/plus buttons sit to its left and appear on hover, keyboard focus, or during Ctrl/Cmd scroll zoom. Minus/plus controls have no invisible hit area while auto-hidden; when revealed, they remain visible but disabled at zoom limits or during edits. The reset/value button matches the zoom buttons' height and has a fixed width for the full percentage range. Click it to reset to 100%; the same zoom limits apply. Controls stay fixed during scrolling and are disabled during date drags.
Today smoothly centers the current day, except when reduced motion is enabled; initial centering is immediate. Its line extends into the calendar header, stays behind bars, and clips outside the left item panels, including their gaps and rounded corners, until the drawer finishes sliding closed. Only items and bars have hover feedback, not full calendar rows. The settings menu changes the displayed period (Day, Week, Month), toggles calendar lines, and changes their spacing (Daily, Weekly, Monthly) and style (Solid, Dashed). Grid settings do not change item dates. Compact bold month names share the main date band and switch from abbreviated names at Month zoom to full names at Week/Day zoom. The pinned month always includes its year; other months show the year after January only, when a new year starts. Unpinned month text is centered on its date mark; a trailing year does not shift that center. Short, higher-contrast date marks stay anchored to their calendar dates, even when month text hides an overlapping day number. Marks do not move with the sticky month labels, so daily gaps stay equal across month boundaries. Month/year labels fade as the next month pushes them toward the left edge, before the expand/collapse button. Week-scale date marks divide each month into four near-even calendar-day sections, not Monday-based weeks. Weekly grid lines use the same sections. Day spacing and month widths still follow the real calendar, including leap-year February. Labels remain visible during horizontal scrolling, and the date header remains visible during vertical scrolling. The calendar extends as you approach either horizontal edge, even during continuous scrolling. Left-edge rebasing preserves the current visible date immediately; right-edge extension does not write the scroll position. Click a task label or bar to open the task; right-click either for the same actions as its list item.
Timeline dates are read-only: bars have no resize handles or end-date editing. Created at stays fixed, and moving a bar between groups does not shift its dates.
When grouped by Status, Priority, Assignee, or Project, drag a task's list item or bar into another visible group to change that property. Projects support Status, Priority, and Assignee moves. Move at least 10px to start a drag; ordinary clicks still open items. The drag overlay snapshots the visible item or bar; the original placement dims, and a dashed ghost reserves the destination's sorted row. Drag sources stay mounted during virtual scrolling and immutable row updates. If the item already belongs to the destination assignee group, its existing row becomes the ghost instead of creating a duplicate. Drop on a group's header (including collapsed groups) or its rows. The active sort determines the resulting order; same-group reordering is not supported. Assignee moves replace only the source assignee and preserve other assignments. Unassigned accepts only a sole-assignee item; mixed-assignee drops are rejected so they cannot clear other assignments. Creation-date grouping and ungrouped views do not accept group moves. Membership and destination checks run again on release. Escape cancels, failed saves show an error, and neither Created at nor Due date changes during a group move. Active filters still apply. Task group moves follow the task list's editing policy: no task or destination permission prefetch is required before attempting a save. The backend authorizes property writes; rejected saves roll back, show an error, and release the task lock. Project Gantt also shows empty Status/Priority destinations from property options, Unassigned when allowed, and assignees already seen in the current collection scope. An emptied assignee group remains available for another drop. The ordinary project list still shows only its loaded groups.
Drag horizontally across empty calendar space to open the task composer with Due date prefilled and visible. Past dates and permission-disabled creation remain unavailable, without a diagonal-line pattern. This works with no loaded rows too. Release opens the composer rather than immediately creating a task; Escape cancels the selection. In a project's Tasks section, creation preserves that project and its edit gate. The Projects collection offers the same interaction with the project composer. There is no Start date property, so the selection sets only Due date; Created at remains automatic. New selections begin today or later, so creation never produces an end before Created at. Existing overdue items remain unchanged.
The timeline reuses the list's filtered, sorted, grouped rows and collapsed
state. Sidebar items fill the list's inset width and share vertical scrolling with
bars. Compact group headers show the grouping's icon and span both the list and
calendar; they remain visible when the list is collapsed.
A continuation row loads the next page when it scrolls near the visible rows,
showing a spinner in the item list and at the visible calendar's left edge
outside the open list, even after horizontal panning. A failed page shows
Retry loading tasks there instead. Group continuations stay after their
group; the global continuation appears once after the loaded rows. As in the
list, a page that lands above the visible rows keeps them in place. Continuation
rows and group headers do not start range creation.
The chart contains loaded results, not an implied complete schedule. Selecting
Gantt persists in tasks.layout or projectTasks.layout, just like List and Board.
Board layout
Choose Board in the Task layout group in the toolbar (or List to switch back). One icon is selected at a time; hover or focus shows its label. Group by offers Status, Priority, Assignee, Due date, and (when Projects is enabled) Project. Both layouts share one grouping, which restores with the Tasks navigation entry. List-only None and Date groupings display Status columns in Board; switching back to List retains those selections and collapsed groups until grouping changes.
Status, Priority, Assignee, Project, and Due date column headers have an icon-only Add task plus button. The button opens the task composer with that column's property preselected, while preserving the originating pane's other creation presets. Due-date columns prefill yesterday for Overdue, today or tomorrow for their named columns, D+2 for Next 7 days, and D+8 for Later. No due date clears any inherited date preset. The draft's due date remains editable. Unassigned and No priority start with that property empty. No project starts empty outside project boards; project boards always retain the current project. No status starts with Not started, because new tasks require a status. Each pane or project scope and column keeps a separate composer draft. Dated column drafts are also scoped to the current local day and timezone, so reopening after midnight or a timezone change starts with the new date preset. Undated and non-date columns keep their existing draft scope. Normal draft expiration still applies. Project boards hide creation actions when the project is read-only.
Click a card's body or title to open the task. Right-click a card, or press
Shift+F10 on its focused title, for the List row's task menu; it acts on that
card alone, since the board has no selection. Right presses never start or
redirect a drag. Move at least 10 pixels with the primary
mouse button held to start dragging to another column; holding still does not
start a drag. Property pills remain interactive and do not start a drag.
A new destination column highlights once movement slows
or pauses for about 100 ms. Fast travel suppresses activation of new columns.
A valid hover shows Board sorted by Updated, Created, Viewed,
Status, Priority, or the active due-date sort label. The drop does not choose a pointer insertion slot:
its card takes its place in the current sort (or existing text-search order).
Same-column moves and column reordering remain disabled.
Layout, primary sort, sort direction, and grouping are reflected in tasks.layout,
tasks.sort, tasks.sortReversed, and tasks.groupBy search parameters.
Explicit URL values override saved preferences; back/forward navigation
restores the corresponding controls, including the layout.
Columns are 336px wide. Each column loads its next page when the end of its cards
scrolls into view; a failed page shows Retry at the bottom of that column.
Ungrouped results, such as a search, load their next page from the end of any
column.
Use the horizontal scrollbar to reach more columns. Vertical wheel input over
empty board background or gaps also scrolls horizontally. A wheel gesture stays
with its original scroll area until momentum stops, even if another column moves
under the pointer. A new gesture inside an overflowing column scrolls vertically.
Each column has its own vertical scrollbar when its cards overflow, while keeping
its heading visible. Lane scrollbars appear while hovering the lane or scroll track
and hide 200 ms after leaving. Off-hover momentum does not reveal them; focus and
active scrollbar dragging retain visibility.
Normal columns fit their content up to the viewport height; only the hidden-column
summary fills the height. Both columns and cards are virtualized, so offscreen
content is not all present in the DOM. A column's vertical position restores when
scrolling away and back. The active drag source
stays mounted while scrolling to a destination.
While dragging, hold the card near a column's top or bottom edge to scroll its
cards vertically. Hold near the board's left or right edge to scroll horizontally;
moving beyond that edge keeps scrolling until release or cancellation. Valid drops
still require the pointer to be inside a visible destination column.
Column titles use status/priority icons, assignee avatars, or the project icon. Active filters also restrict columns: excluded values do not remain as empty boards. Allowed Status and Priority values retain empty destinations. Assignee and Project columns come from matching task groups; there is no extra-column selector. When filters hide known columns, a full-height dashed summary appears at the end. A filter illustration, count, and outline Reveal hidden columns button stay near the top of that column. Status and Priority show N hidden. Assignee and Project show N+ hidden: these lower bounds count known groups, not every group excluded by server filters. Reveal hidden columns clears only the current grouping's filter; other filters, the current tab, and search stay active. The dashed column is not a drop target.
An icon-only status pill appears before the task title, and an icon-only assignee pill appears to its right in every grouping. The lower row omits status, assignee, and the grouping property, except that the exact due-date pill stays visible in Due date grouping. The remaining properties use standard pill controls and icons. Priority uses a compact icon-only pill; due date and project appear when set. Metadata properties stay read-only, and pending writes disable editing. A task assigned to multiple people appears in each person's column. Moving it from Alice to Bob replaces Alice while keeping the other assignees. Moving to Unassigned clears all assignees. Project moves change the task's Project property (an initiative), never its legacy folder.
Task moves and property pills follow the list's editing policy without permission prefetches. Property definitions and valid destinations must still be available. A pending move disables further moves of the same task in every column; failed writes use the shared property mutation's rollback and show an error. A valid destination highlights and shows the sort overlay only while dragging inside that column, not in gaps or outside the board. Drops move the card immediately while the save is pending; failures restore its prior membership. After a successful save, the board scrolls only as needed to reveal the destination card, including virtualized columns and rows; already visible cards stay in place. It does not scroll after a cancelled or failed drop, or when the current board scope changes during the save. Successful moves show no notification. A cross-column drop settles one opaque visual copy from the card's release position into its sorted destination; the real card appears when the copy lands. The release snapshot survives source unmounting after edge scrolling. Sorting updates retarget an in-flight copy without restarting from the source column. Visible placements animate during moves and rollback without animating ordinary scrolling or paging. In Assignee grouping, moving to an already assigned person reveals the existing card rather than creating a duplicate. Reduced-motion preferences disable these transitions. Filters remain active: completing a task or removing yourself as assignee can hide the card from the current view. Click its title to open the task; modified clicks can open a separate split.
Due-date drops reschedule the task: Today and Tomorrow assign those dates; No due date clears the value. Overdue, Next 7 days, and Later open a date picker restricted to that bucket, with explicit Apply and Cancel. The source placement stays unchanged until Apply; Cancel, Escape, dismissal, or a scope change makes no write. A failed save restores the prior placement and counts. Existing property permissions and pending states apply, and the destination uses the active sort. A due-date filter also hides buckets that cannot contain a matching date; Reveal hidden columns removes only that date filter. Priority and Status use the same sort choices as the task list. The shared board primitives remain independent of Tasks queries and mutations.
Cached grouped lists
Project grouping in the task list matches the Project column: tasks group by their initiative Project property, with unassigned tasks under No Project. Legacy folder membership does not affect these groups. Projects sort by name with No Project last. Headers show the name the server labels the group with; a group still labeled by its key resolves the name through the same authorized identity query as the Project column. Verify two projects and an unassigned task on desktop and mobile; changing or clearing a task’s Project must move it to the matching group without reloading.
The synthetic project-grouping browser regression uses the production grouping
logic and group headers, with HTTP replaced. Run from apps/web:
bunx playwright test --config src/features/tasks-view/browser-test/playwright.config.ts project-grouping.browser.e2e.ts.
With GraphQL caching enabled, previously loaded grouped task lists remain usable when their background refresh fails without an HTTP response. Load a Priority-grouped view online, navigate away, then reopen it offline. Repeat by holding its GroupSoup request: cached rows should appear before the response, and rejecting that request must not replace them with Tasks couldn’t be loaded. A cached empty result is also usable. An initial cache miss still shows failure; HTTP and GraphQL errors remain visible even with cached rows. Change filters while retaining prior rows: those older results must not hide a failure for the new, uncached query.
For project labels, warm the Projects list or a project detail, then scroll tasks
referencing that project out of view and back. With GraphQL caching enabled,
row remounts must reuse complete cached identities without new
InitiativeIdentity requests; missing identity fields still fetch. Explicit
permission refreshes remain separate. Hold a cold folder-preview or identity
request while scrolling on desktop and phone: only the row metadata may show
loading, and the list must remain mounted at the same scroll position.
After a project read is denied, scroll its row out of view and back: the cached
label must remain hidden until a new authorized response succeeds. Switch viewers
while retaining cached rows: mismatched identities must reauthorize immediately,
without exposing the previous viewer's data or repeatedly retrying a failed read.
Reviews view
With enable-tasks-reviews enabled (on by default in development),
Reviews is available in desktop navigation and the mobile bottom dock's
More views drawer (or directly in the dock after Customize dock), not the mobile Tasks tabs.
It opens a separate /app/reviews shell whose sidebar lists Pull requests,
Authored by me, Assigned to me, Involves me, and Review requests;
Involves me is selected by default. The selected tab is stored in the URL and
survives opening a PR and returning through the breadcrumb.
The top of the Reviews list (List layout) holds the GitHub TutorialRow (from features/video-tutorials) once that video is in its catalog.
The list contains accessible GitHub pull requests of any status. Involves me
uses the server's participant filter for your linked GitHub account: author,
requested reviewer, assignee, commenter, or reviewer. Participant IDs are retained
across partial GitHub refreshes, so this is not strictly a list of current
review requests.
Authored by me, Assigned to me, and Review requests match the linked
GitHub user ID. If the link-status endpoint has no identity, the list explains
why the tab is unavailable.
The sidebar offers Search reviews above its navigation. On desktop the
List/Board icon group lives in the header; List is the default and the
choice is remembered. The desktop header always offers an expandable Search icon; Command-F expands and
focuses it. The single row contains the selected scope, status tabs, grouped
filter and sort controls, New, and Search. Active-filter counts sit beside the
filter icon inside its button. A separate
Open / Closed / All toggle with icons (aria-label="Pull request status") picks the status in the desktop header and above the list on touch
devices, and the board hides it. The desktop sidebar has no layout or status
switches. Status tabs size to their labels with even horizontal padding and use
the shared fully rounded segmented style. Open is the default; Closed includes
both closed and merged PRs, and All shows every status. The filter dropdown and mobile drawer also
offer independent Open, Closed, and Merged selections. Custom multi-status
selections hide the toggle, except the combined Closed preset keeps it visible.
A partial Closed-only or Merged-only selection leaves every option unhighlighted.
Status combines with other filters, counts toward filter badges, and applies
before pagination. Clearing filters resets to Open. Other filters cover
priority, linked work, started from, repository, author, assignee, label, and,
when a GitHub identity is linked, reviews (Reviewed by you, Not reviewed by you,
and Awaiting review from you). The selected scope remains in the desktop header
when the sidebar is collapsed; there is no separate title or search row.
Saved review selections stay inactive, including their filter badge and empty-state
copy, while the GitHub identity is unavailable; they resume when it returns.
Sort offers Priority, Recently updated, Least recently updated, Newest, and Oldest;
Priority orders the loaded rows most urgent first and keeps recency within a
priority. Date sorts group rows under the same headings as email (Today,
Yesterday, Last 7 days, Earlier this month, Last month, Older) by the sorted
date; Priority sorts and searches list rows flat. When visible PRs
have GitHub labels, a Labels section below Favorites lists them like email's
Tags section (a colored dot and the name); choosing a label shows only PRs with
it, and choosing it again clears it. Above it, an Agents section lists the
tools the loaded PRs were started from (Claude, Codex, Cursor, and so on, with
their marks); choosing one shows only PRs started from it, using the same
Started from filter as the filter menu. PR rows use the shared entity layout with selection checkboxes,
author avatars and names, and a context menu. The current user's Macro display
name appears when their linked GitHub identity matches the PR author; other
authors fall back to GitHub names. The virtualized list fetches more pages as
you scroll, including when local filtering removes most fetched rows.
Linked agent sessions appear alongside the row's other metadata pills and beneath
the PR detail title. Narrow PR rows put wrapping metadata below the title, keeping
session chips visible without squeezing the title. One session shows its name with the agent sparkle icon;
multiple sessions show a count chip that opens a list of names. Selecting a name
opens that session; Shift-click on the single-session chip opens another split.
Chip clicks do not open or select the containing PR row. Empty results have no
chip, and loading, private, deleted, or unavailable sessions never offer navigation.
The PR's status pill stays passive; status filtering lives in the Reviews list tabs.
Each PR row shows what it links to. A priority icon before the title comes from
the most urgent open linked task (a closed task counts only when none is open),
otherwise from a GitHub priority label (P0–P3, priority: high, urgent,
critical); the tooltip names its source. Row pills use the email tag style
(neutral outline; GitHub labels show a colored dot and name). After the title
they show where the PR was started, the channel messages its agents were
started from (for example an @mention), Customers (CRM companies in linked
tasks' Companies property, or a company whose thread started a session),
Tickets (tasks the PR text, branch, or comments mention as MACRO-<id>, and
tasks whose thread started a session), the GitHub labels, the author, the diff
size, comments, and the linked agent sessions chip. A channel pill names the
channel; hovering it previews the starting message in the same card as message
mentions, and clicking opens the channel at that message (Shift-click for
another split). Several channel messages stack as overlapping pills that spread
out on hover. Customer and ticket pills with one item open it; with more they
show +N and open a list. Items the viewer cannot access are omitted. When the
pills would squeeze the title, they drop their text (keeping icons, dots, and
tooltips) and overlap; they expand again once the row is wide enough. Rows show
a pulsing placeholder while links load. The first pill names where the PR was started
(Claude, Codex, Cursor, Devin, Copilot, Jules, or Macro), including PRs opened
outside Macro: a Macro agent session that opened the PR wins and shows the tool
its harness ran; otherwise a session link in the description (claude.ai/code/…,
chatgpt.com/codex/tasks/…, cursor.com/agents…, app.devin.ai/sessions/…,
jules.google.com/…, macro.com/app/agent/…), then footers such as
"Generated with Claude Code" or a Co-Authored-By: Claude trailer, then the
bot author (for example Copilot or devin-ai-integration[bot]), then the
branch prefix (claude/, codex/, cursor/, devin/, copilot/, jules-).
Its tooltip names the signal; clicking it opens the Macro session in a split or
the external session in a new tab. Filters add Priority (including No
priority), Linked to (an agent session, a ticket, a customer, a channel),
and Started from (each tool, or Unknown); these run on the loaded rows,
which wait for their links before matching. The PR side panel's Linked work
section shows the same origin under Started from, plus the priority,
tickets, customers, and channels.
Board lays the scope's open and merged PRs (status filter and tabs give
way to the board) out in columns: Draft, In review (checks running or
none), Checks failing, Conflicts (GitHub reports the branch conflicting
with its base; read live for the open PRs on the board), Ready to merge
(every check passed), and Merged. Cards show the status icon, priority,
title, checks, owner/repo#N, author, link pills, labels, and agent sessions;
clicking a card opens the PR. Right-clicking a card, or Shift+F10 on its focused
title, opens the list row's context menu. Dragging asks GitHub for the change as you: drop
on Merged (from In review or Ready to merge) to merge after the same
confirmation as the PR's Merge button; drop on Draft to convert any open PR
to a draft; drop a draft on In review to mark it ready for review. Checks
failing, Conflicts, and Ready to merge take no drops, and merged cards cannot be
dragged. A refusal shows GitHub's message and the card returns. Load more pull
requests fetches the next page.
Pull requests can no longer be favorited. PRs favorited earlier still appear in a collapsible Favorites section below the views (hidden when there are none). Favorite rows open the PR in Reviews (Shift-click opens another split), and their context menu can remove the favorite. PR favorites also open in Reviews from the global Favorites sidebar or command menu. A PR row's context menu offers Open in new split, Copy Link, and Open on GitHub.
Select a PR to open /app/reviews/pr/<foreignEntityId> in the Reviews shell.
Opening a PR refreshes it from GitHub in the background for viewers with a
linked GitHub account, so labels, reviewers, and review state catch up without
waiting for GitHub's next webhook. A successful refresh also reloads the Changes
summary, so new commits replace the previous diff range.
Its breadcrumb returns to the Reviews list. Old /app/pr/<id> links redirect
to the Reviews detail. When the flag is off, the Reviews shortcut is hidden and
opening /app/reviews redirects to /app/tasks after flags load. Copied PR
detail links still work; check both URLs with the flag off.
The PR header has a Changes toggle (aria-pressed) with the diff's +N −M
at the PR's current base and head. It opens the same resizable Changes pane as
an agent session (see "Reviewing a linked GitHub pull request" in
AI chat) beside the PR, read-only: there is no review-note gutter,
notes chip, or hand-off card. The PR's split stores the pane in
s<N>.changes.pane and s<N>.changes.style, the same as a session, until you
leave the PR or close its split. The first view of a base and head reads GitHub; later
views, and agent sessions linked to the same PR, reuse the stored diff. An
unavailable or oversized PR is explained in the pane.
The Agent sessions side-panel section distinguishes loading PR details, loading sessions, failed requests, and an empty result. Failed session requests offer Retry. Hover a truncated session name to see its full name.
Check all five tab URLs, the Labels section, author avatars and display names, row selection and
context menu, favorites add/remove and collapse/empty visibility, filters, sort,
illustrated empty states, loading, errors, and pagination after filtering. Use
Open in new split from a PR row's context menu; verify the Reviews list stays in
the original split and the PR appears beside it. Open a favorite from the global
sidebar, return through the breadcrumb, and open a copied link in a second split.
Open a PR's Changes pane; check the file tree, a file's diff, Unified / Split,
refresh after new commits, and that reloading with s<N>.changes.pane in the URL
restores the pane. Check session loading/error/empty copy and full-name tooltips.
Check both status tabs and the menu's individual statuses. Confirm Closed includes
merged PRs, custom multi-status choices hide the tabs, and Clear filters returns
to Open. Combine status with a repository filter while loading another page.
Repeat on touch. Check the tabs follow search and filters, and that the topbar
shows Reviews after narrowing or collapsing navigation.
Check zero, one, and multiple linked sessions in PR rows and beneath the detail
title, including keyboard activation and a long name. Open the count menu, choose
a session, and confirm the PR row was not activated. Check permission-denied and
loading session previews remain disabled.
Use existing PRs and do not modify hosted data.
Create a task
On touch devices, task creation opens in a bottom sheet with a drag handle and
scrollable, keyboard-aware content. It opens at 70% of the screen, with the
description filling the room above the properties; the keyboard shortens it.
Opening it from + Task or Home's + New raises the keyboard with the title
focused and the caret after any text. Its glass pane has broad screen-scaled
corners, an 8px outer inset, and a blurred backdrop, matching the create and
filter sheets. Its header has Continue editing in split on the left and
Create Task on the right, with a text-only Clear 32px to its left once the
draft has changes, and no close button. When the
keyboard leaves too little room for the whole composer, the header pins to the
top of the sheet (with a solid background only while pinned over content), so
Create Task stays in reach. The properties sit on a single line that scrolls
horizontally, with the Share with <team name> switch below them. The sheet
has no Create More switch and no similar-tasks list. Create Task shows no
keyboard shortcut on touch. Assignees, Project, Tags, and Due Date open their
pickers in a full-height sheet stacked over the composer (PickerSheet), with
Cancel, the property's name, and Done: picks apply on Done, Cancel or the
backdrop drop them, picking keeps the keyboard up, and a single-choice Project
or a date applies its pick at once. Status and Priority keep their dropdowns,
which leave focus in the title. Tapping a pill doesn't take focus, and closing
a picker sheet returns it to the title or description with its caret, so the
keyboard stays up throughout. Desktop uses
the centered composer dialog. Both layouts are views in
apps/web/src/features/task-composer/views composing the shared
TaskComposer parts.
After creation, the Task created toast shows an Open action. Touch devices
omit Open (New Split); desktop keeps both actions. Either action immediately dismisses the toast before opening
the task. Verify the toast at phone and tablet widths with touch
emulation: the message and action fit without clipping, and Open visits the
created task in place.
- Click the
Taskbutton (orCreate→Task T, or keyboardcthent). - A dialog opens with the title contenteditable focused (placeholder
New task), plusAdd description..., and property buttons:Not Started(status),Priority, assignee chip (defaults to you),Due Date,Project(when Projects is enabled; the standard property dropdown, listing projects),Change or select tags, a desktop-onlyCreate Moreswitch, andCreate Task Ctrl ↵(Create Taskalone on touch).Attach image or video(paperclip) sits just under the description, above the property buttons. If the chosen project can't be set, the task is still created and a toast says it wasn't added to the project. TheShare with <team name>switch in the footer's left corner (hidden when you aren't on a team) defaults to on and remembers your choice in local storage across composer openings and page reloads. Recovered submissions use their saved sharing choice without changing this default. Hovering it explains whether the task will be visible to your whole team or only to you and the people you share it with. The choice also applies to Create More, continuing in a split, and tasks created from a project. type_textthe title, then press Ctrl+Enter to create, or tapCreate Taskon touch (the button enables once there is a title). Dialog also offersContinue editing in splitto open the task as a full document. Creating shows aTask createdtoast withOpen(andOpen (New Split)on desktop) as soon as the server returns, then copies the task link in the background. A denied or prompted clipboard write never delays or replaces that toast.
The property row adapts when the launching pane supplies a task-composer preset. The app shell's creation-context provider snapshots the focused pane's preset before the composer opens. It reads the layout's existing focus accessor, not a global context registry; no detail fetch or navigation-state capture is needed. Without a preset, the standard property row and draft are used. The shared composer's only flag gate is the Customer / Contact pill below. Create-menu actions, shortcuts, and pane buttons capture the provider during setup and read the preset when invoked.
With PostHog enable-crm and enable-crm-activity both on, every opening of the
composer, and Universal Input's task mode, shows one Customer / Contact pill, a single-choice picker of companies
and contacts that writes the Companies and Contacts properties. Picking a company
leaves the contact unset; picking a contact also sets its company, and the pill
shows the contact with both named on hover. A team with no CRM records sees the
pill with "No customers or contacts found". Neither property is offered separately
under Add property while the pill shows. With either flag off, there is no pill
and both stay under Add property.
Customers supplies its preset when enable-crm-activity is on. Record-level task
creation prefills the company or contact, including the contact's company when
already loaded. With the CRM flag off or loading, record-level creation uses the
standard property row while retaining its record-scoped draft and associations. Add property opens the same property
editor as the document/task side panel: search by name or type, select a property
and enter its value, or create a property from an unmatched search. Assignments
and values stay in the task draft until creation; opening or closing the editor
preserves other draft values. Tag selection continues through its separate Tags
picker. CRM drafts are isolated from the ordinary task draft and from other CRM
records; reopening restores added properties as well as their values. Clear Draft
restores that view's preset.
Later flag, focus or record changes leave the open draft and associations intact,
even between launch and mount. The next opening uses the current context.
Task creation requires a connection. Before any create request, the composer
saves a separate copy of the title, description/editor state, properties, and
sharing choice on this device. Pending submissions do not expire and survive an
app restart. Reopen the same task composer context and choose Recover: