atriumatrium

Tasks panes

Task list and task detail panes for the built-in task tracker.

There are two task pane types: the task list and the task detail view.

See Tasks & runs for the data model.

Task list pane

A workspace-scoped view of every task card.

Views

The pane carries two views and remembers the last one you used:

  • Kanban board (default) — one column per status, drag cards between columns to change status, and new cards land at the top of their column. A card with an active run embeds a live agent chat so you can follow and reply right on the card, and shows live launch progress while its agent spins up. Under a wallpaper, lanes keep a faint surface backing so columns stay legible.
  • List — the searchable, filterable table described below.
The pane can also dock as a resident, showing a compact task list with live agent badges that opens the full view in a room.

Opening

  • Cmd+Shift+K opens or focuses the task pane.
  • Toolbar tile, or Cmd+T K from the launcher chain.

Capabilities

  • Real-time search over title, description, and tags.
  • Filter by status, assignee, label, priority, and workspace (the workspace dropdown scrolls and scales past five entries when you have many).
  • Sort by status, priority, size, creation or update date — sort is exposed as a dropdown in the pane header, and rows show an updated-at timestamp.
  • Filter and sort selections are scoped per pane, so you can keep one pane filtered to "in review" and another to your full backlog without them stomping on each other.
  • Click a task to open its detail pane.
  • Inline status dropdown per row.
  • Group headers (e.g. by status) sit above their rows with an opaque, contrasted background so they stay legible while you scroll.
  • Priority color dots: critical (red), high (orange), medium (yellow), low (gray).

Keyboard

  • Arrow keys navigate the list.
  • Enter opens the selected task in a detail pane.
  • Cmd+F focuses the search field.
  • Escape clears the filter.

Task detail pane

Single-card view with full edit surface.

Opening

  • Cmd+Shift+J opens or focuses a task detail pane.
  • Click a task in the task list pane.
  • Cmd+click an ATR-# reference in any terminal pane to open that task in a detail pane (or focus an existing pane already bound to it).
  • atrium task show <id> opens it (or the CLI prints details if the pane is not used).
  • atrium task create from a pane auto-assigns the new card to the caller's workspace, so cards minted from inside a workspace's panes don't need an explicit --workspace.
  • Automatically opened when an adapter executes a task launched via task dispatch.

Capabilities

  • Edit title, description (rich Markdown), status, priority, size, assignee, labels, due date. The edit modal auto-saves as you type, mirroring the inline detail pane behavior.
  • Files section — drag files from Finder or the workspace tree into the task to attach them; attached files surface as chips on the card and appear in the create-task modal too.
  • Inline list of the task's runs with status (pending, running, succeeded, failed, cancelled), inline output/logs, Replay on completed runs, Cancel on running runs.
  • Comment thread with a full Markdown editor for composing — RTE toggle, code fences, mentions. Comments surface their kind (discussion / instruction / agent-update) and source stamp; the count is shown on the accordion before you expand it.
  • Dispatched review threads — when you Send-to-agent from the source control pane, the dispatched comments appear as nested diff-style cards inside the task's Comments section, with syntax-highlighted code snippets above each anchored comment so the conversation stays in one place.

Skills & Agents context

An accordion section on the task surface (create modal, edit modal, detail pane) lets you bind a named agent and overlay an ordered list of skills before launching. It mirrors the agent editor's attached-skills picker:

  • A search input opens a unified dropdown of agents and skills. Empty-state shows suggestion cards (recent + popular profiles, recently-used skills).
  • Once anything is picked, the row flips to a list view with Discoverable | Pre-loaded segmented controls per skill, per-row token chips, and × removal — same controls as the agent editor's attached-skills list.
  • Skill rows show their provenance in the pretty form (atrium · user, Claude Code · project); agent rows show a Bot glyph in the iconPrefix slot to distinguish them from skill rows.
The picker writes to the v8 agent_ref / skill_selection / profile_slug columns on the card row (see Tasks → Skills & Agents context). On launch, resolveTaskProfile reads back what useLaunchBoundRoom will hand to SessionStart, so the picker state and the agent's actual injected context never drift apart.

The detail pane also supports a task claim action — bind the pane to an existing card without launching it. See atrium task claim in the CLI reference for the agent-side equivalent.

Persistent state

  • Bound task card ID.
  • Expanded runs in the timeline.
  • Scroll position in the description editor.
  • Open modals and in-flight create-task drafts survive the pane's Surface remount, so a half-written draft survives the pane scrolling out of view and back.

Constraints

  • Task data lives in ~/.atrium/tasks.db, not in the pane snapshot. The pane only remembers which card it is bound to.
  • Cannot delete a task from the detail pane; use the task list row menu or atrium task delete.
  • Assignee is free-form text today — user picker UI is on the roadmap.