Todo listPro
The agent's task list: done, active, blocked, pending and skipped items, as a checklist or a dock above the composer that fades once everything is done.
oxyn add todo-list- Read the auth middleware8.0s
- Wrote a failing test21s
- Holding the lock across the refresh31s
- Run the auth testswaiting on #3
- Update the changelog
- ⤼Bump the session schemaskippedno schema change needed
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- For any task longer than a few calls the user wants to know what the agent intends to do, how far along it is, and whether the plan changed.
- Before execution they want to review and approve (or edit) the plan; during it they want a calm "3/7 · Running tests" they can glance at; afterwards, a record of what happened step by step.
- Research note 03 rates the todo checklist and plan document as table-stakes: Claude Code's task list toggles with Ctrl+T (pending / in_progress / completed); Windsurf keeps an in-conversation todo list maintained by a background planning agent; Warp auto-creates task lists with status icons; Devin's Progress tab has a task drawer that filters the activity stream; Conductor's todos can block merging; Kiro runs tasks.md items individually or all; Cursor's plan is an editable document with a Build button and minimises to a "Plan" pill above the prompt; Lovable versions plans ("Viewing version 2 of 3"); Jules has Approve plan with an auto-approve timer; Factory combines "proceed" with an autonomy level in one approval (notes 03, 05, 08).
- Hoplite shows a collapsible "Agent tasks" dock above the composer with pending / in-progress / completed / cancelled (note 10).
When not to use
- A turn's tool calls grouped the way a transcript reads them: use Tool stack instead.
- One tool call in one line: use Tool call instead.
- Switch the agent between Ask, Plan and Agent: use Mode switch instead.
Installation
Todo list is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add todo-listUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Checklist
Every item with its status.
- Read the auth middleware8.0s
- Wrote a failing test21s
- Holding the lock across the refresh31s
- Run the auth testswaiting on #3
- Update the changelog
- ⤼Bump the session schemaskippedno schema change needed
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Dock
Docked above the composer.
- Read the auth middleware8.0s
- Wrote a failing test21s
- Holding the lock across the refresh31s
- Run the auth testswaiting on #3
- Update the changelog
- ⤼Bump the session schemaskippedno schema change needed
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Stopped
The run was stopped.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Strike
Done items struck through.
- Read the auth middleware8.0s
- Wrote a failing test21s
- Holding the lock across the refresh31s
- Run the auth testswaiting on #3
- Update the changelog
- ⤼Bump the session schemaskippedno schema change needed
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
TodoList
| Prop | Type | Default | Description |
|---|---|---|---|
planrequired | Plan | — | The plan. |
agent | AgentState | AgentState::Idle | Agent state (dock: live / stopped). |
nowrequired | ClockMs | — | Shared clock. |
variant | String | "checklist" | `checklist` or `dock`. |
done_at | Option<ClockMs> | Default::default() | When the last item finished (dock fade). |
expanded | bool | Default::default() | Dock expanded. |
strike | bool | Default::default() | Strike done items through. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| EnterorSpace | Expand or collapse the dock |
Accessibility
- role=list labelled "Agent tasks, 2 of 6 done"; each item reads its label, status and duration.
- An item becoming active is announced only if it stays active for 2 s.
From the spec
- Roles. Todo list =
role="list"witharia-label="Agent tasks, 3 of 7 done"; items are list items whose name is "<label>, <status>[, <duration>]" ("Run tests, in progress"; "Update schema, done, 2.1 seconds"; "Lint, skipped: no files changed"; "Deploy, failed: build error"; "Write docs, waiting on task 3"). Plan card =role="region"labelled with its title and version. Step timeline = ordered list; nested calls are a sub-list. - Announcements (composer polite region): plan ready ("Plan ready for review, 7 steps" — assertive if approval is required, owned by family G); item becomes active only if it stays active ≥ 2 s ("Working on: Run tests"), debounced to once per 10 s; item failed (once); "Plan updated, 2 added, 1 removed" (once per coalesced change set); "All tasks done".
- Changed items carry a text tag ("new", "edited", "reopened", "removed from plan") — the tint is never the only cue.
- Keyboard. ↑/↓ items; Enter jumps to the item's step or calls; in Proposed: E edit, Alt+↑/↓ move step, Delete remove (with undo), Enter (on CTA) build; dock toggle shortcut (§4.1); Esc collapses the dock and returns focus to the composer.
- Contrast. Secondary (done / pending) labels ≥ 4.5:1; struck labels stay ≥ 4.5:1; glyphs ≥ 3:1; the highlight tint keeps text ≥ 4.5:1.
- Focus. Arriving or moving items never steal focus; if the focused item is moved, focus moves with it; if it is removed, focus goes to the next item.
- Reduced motion. §6 last row.
Motion & interaction
- Item enter.
dur.row.enter(height spring + fade, y +4 → 0); the initial list staggers 40 ms, Cap 6, then the rest appear together (A run card opens steps on a critically damped spring, - Becoming active. ○ crossfades to the loader (120 ms); the label starts
text-shimmer/calmafterdur.shimmer.delay(600 ms); in the dock, the current label swaps with the verb-cycler fade (180 ms,Width::ReserveLongestso the dock never jitters). - Completing. Loader finishes its beat, morphs to ✓ (
dur.row.morph) and the stroke draws (240 ms); label rolls to past tense (dur.tense.roll);strike-sweepvariants draw a strike line left → right over 200 ms. Numerator rolls. In step-timeline the connector to the next marker fills top → bottom (240 msease.in-out); when several steps complete at once the connectors fill one after another with a 60 ms stagger (Arc stepper behaviour, note 12). - Skip. Label fades to secondary italic (160 ms), ⤼ appears, denominator rolls down.
- Fail. ✕ morph + 2-cycle 3 px glyph nudge, reason line opens under the item.
- Agent edits mid-run (agents often rewrite the whole list each time; we diff by item id, falling back to text similarity ≥ 0.6 when the adapter gives no ids — proposed):
- *Added:* item enters at its position with
dur.row.enterand acolor.plan.changedtint that fades overdur.highlight.fade(1600 ms); a "new" tag stays 4 s. - *Reworded:* old text crossfades to new (200 ms); "edited" tag 4 s; hover shows the previous text.
- *Moved:* FLIP glide to the new position (240 ms
spring.snap); held until the pointer leaves the list, so nothing moves under the cursor. - *Removed:* a pending item gets a strike line (200 ms), holds 600 ms, then collapses (180 ms); done items are never removed visually — they stay with a "removed from plan" tag.
- *Reopened:* a done item going back to pending/active gets an amber "reopened" tag.
- A one-line note "Plan updated · 2 added, 1 removed" slides in under the header (160 ms) and fades after 4 s; "Show changes" opens the previous version beside the current one.
- Rewrites arriving within 300 ms of each other are coalesced into one change set.
- Plan streaming. Steps enter as they arrive; the newest step's label shimmers until the next one starts; the title is laid out first so the card width never changes.
- Approval hand-off. Entering
AwaitingApproval, the family-G footer rises from the card's bottom edge (200 msease.out). On Approve: footer collapses into "Approved" (220 msspring.snap), the card folds to the "Plan · 0/7" pill (280 msease.in-out), the todo dock unfolds above the composer, and — when the app is in Plan mode — the Build/Approve button flies a small spark to the mode chip, which morphs Plan → Agent (the choreography defined in composer-mode-switch.md §"Plan approved → Agent"). On Request changes: the footer swaps in place to the note field (height follows onspring.snap); after submit, the card dims to 60 % and a new version streams in below or in place (variant). On Reject: card dims, footer collapses to "Rejected". - User editing (Proposed). Hover shows a drag handle and an edit pencil per step; editing opens an inline text field in the same row (no height jump for one-line steps); edited steps get a "you edited" tag that rides along with the approval.
- Dock toggle. Expand: list height opens with
dur.expand, capped at 50 % of the viewport (scrolls inside); the active item is scrolled into view without animation if it is far away. - Done. Dock shows "Done · 7/7" in success tone for 600 ms, then holds 4 s and fades out (240 ms).
- Hover. Items tint 80 ms; tooltip after 400 ms with duration, owner (sub-agent), reason for skipped / failed, and the time it changed.
Timing
| Transition | Duration | Delay | Easing / spring | Stagger | Frame rate |
|---|---|---|---|---|---|
| Item / step enter | 200 ms height + 160 ms fade | 0 | spring.snap / ease.out | 40 ms cap 6 | 60 Hz |
| ○ → loader | 120 ms | 0 | ease.out | — | 60 Hz |
| Active label shimmer | 1400 ms sweep / 800 ms rest | 600 ms | ease.coast | — | 30 Hz |
| Dock current-label swap | 180 ms | 0 | ease.out | — | 30 Hz |
| Loader → ✓ + stroke | 160 + 240 ms | ≤ 200 ms beat | spring.snap / ease.out | — | 60 Hz |
| Tense roll | 240 ms | after morph | ease.out | — | 60 Hz |
| Strike sweep | 200 ms | after morph | ease.out | — | 60 Hz |
| Connector fill | 240 ms | 0 | ease.in-out | 60 ms per connector | 60 Hz |
| Progress numerator / denominator roll | 280 ms | 0 | ease.out | 30 ms | 30 Hz |
| Changed highlight fade | 1600 ms | 0 | ease.out | — | 30 Hz |
| Reworded crossfade | 200 ms | 0 | ease.in-out | — | 60 Hz |
| Moved glide (FLIP) | 240 ms | until pointer leaves | spring.snap | 20 ms | 60 Hz |
| Removed: strike / hold / collapse | 200 / 600 / 180 ms | 0 | ease.out / — / ease.in | — | 60 Hz |
| "Plan updated" note in / hold / out | 160 / 4000 / 240 ms | 0 | ease.out / — / ease.in | — | 60 Hz |
| Coalesce window for rewrites | 300 ms | — | — | — | — |
| Approval footer in | 200 ms | 0 | ease.out | — | 60 Hz |
| Approved → fold to pill | 220 ms + 280 ms | 0 | spring.snap / ease.in-out | — | 60 Hz |
| Spark to mode chip | per composer-mode-switch.md | — | — | — | 60 Hz |
| Dock expand / collapse | 220 / 280 ms | 0 | spring.snap / ease.in | — | 60 Hz |
| Done tone / hold / fade | 600 / 4000 / 240 ms | 0 | — / — / ease.in | — | 30 Hz |
| Auto-approve countdown (Pro) | per second | — | digit swap | — | 1 Hz |
| Reduced motion | no shimmer (active item marked by the static ◐ glyph and a bold label); morphs, tense changes and swaps become 80 ms crossfades; no strike draw, no connector fill animation (fills instantly), no FLIP (items jump), no spark; changed items get a static 2 px inline-start bar for 4 s instead of a tint fade | — | linear | none | 1 Hz idle |
Responsive behaviour
- checklist fills a panel; dock sits above the composer and expands on demand.
Edge cases (spec)
- Long lists (30–100 items): checklist shows a window around the active item — 2 done above, active, 4 pending below — with "12 done" and "+40 more" rows that expand; the dock never exceeds 50 % of the viewport.
- Nested items. Depth capped at 2 visible levels (deeper levels indent no further and show a "…" path); parent auto-completes only if the adapter says so (we never infer).
- No item ids. Text-similarity matching (§5); if confidence is low the whole list is replaced with one crossfade and a "Plan rewritten" note instead of per-item changes.
- Agent rewrites the list every call. Coalescing (300 ms) and id diffing keep unchanged items perfectly still; only real changes animate.
- Several active items (parallel sub-agents): each shimmers (max 8 animate, loaders.md §2.3); the dock shows "3 active" instead of one label.
- All done but the run continues. Dock shows "Done · 7/7" without fading until the run ends; new items re-open it.
- Run ends with pending items.
Stopped · 4 left; pending items stay ○; no failure tone unless an item failed. - One-item plans. No fraction; the dock shows only the label.
- Very fast plans (items done within 150 ms of appearing): enter already done, no active phase.
- Very slow items (hours): elapsed in Units; after 10 min the active shimmer slows to the calm cadence (status-text.md §10 "very slow turns").
- User edits a step while the agent revises. The agent's version wins for the item text; the user's edit is kept as a pending note with "Your edit wasn't applied · Apply again".
- Long labels. Wrap to 2 lines max, then end-truncate with full text in the tooltip; in the dock, single line, end-truncated.
- RTL. Lists mirror (glyph at inline-start); connectors stay vertical; progress fractions are LTR isolates; FLIP moves are vertical only.
- Tiny sizes (16–20 px rows). Glyph + label only, durations hidden; dock shows only "3/7".
- Dense IDE. 22–24 px rows, 12 px text, dock as a status-bar segment.
- Touch. 44 px rows; drag handles appear on long-press in Proposed; dock becomes a bottom sheet with a grab handle; swipe down collapses.
- Offline / reconnect. The list keeps its last state; on reconnect the snapshot is diffed (no enter animations for items that already existed).
- Terminal surface. Glyphs
○ ◐ ✓ ✕ ⤼ ⧗, no shimmer (bold active label), progress as[3/7].
Notes for AI
- Import
TodoListfromoxyn_dioxusand includeRUN_CSSplus the token stylesheet once. - A GPUI version exists:
TodoListElinoxyn_gpui. - Props to set first:
plan,now. - It reads a clock (
now) for live timers; pass one clock for the whole page rather than one per component. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.