Skip to content
Back

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
Fix the refresh-token race2/5 · 1 skipped
  • Read the auth middleware8.0s
  • Wrote a failing test21s
  • Holding the lock across the refresh31s
  • Run the auth tests
    waiting on #3
  • Update the changelog
  • ⤼Bump the session schemaskipped
    no schema change needed
The code is part of Oxyn Pro

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.

Get Pro

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.

Terminal
oxyn add todo-list

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Checklist

Every item with its status.

Fix the refresh-token race2/5 · 1 skipped
  • Read the auth middleware8.0s
  • Wrote a failing test21s
  • Holding the lock across the refresh31s
  • Run the auth tests
    waiting on #3
  • Update the changelog
  • ⤼Bump the session schemaskipped
    no schema change needed
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Dock

Docked above the composer.

  • Read the auth middleware8.0s
  • Wrote a failing test21s
  • Holding the lock across the refresh31s
  • Run the auth tests
    waiting on #3
  • Update the changelog
  • ⤼Bump the session schemaskipped
    no schema change needed
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Stopped

The run was stopped.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Strike

Done items struck through.

Fix the refresh-token race2/5 · 1 skipped
  • Read the auth middleware8.0s
  • Wrote a failing test21s
  • Holding the lock across the refresh31s
  • Run the auth tests
    waiting on #3
  • Update the changelog
  • ⤼Bump the session schemaskipped
    no schema change needed
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

TodoList

PropTypeDefaultDescription
planrequiredPlan—The plan.
agentAgentStateAgentState::IdleAgent state (dock: live / stopped).
nowrequiredClockMs—Shared clock.
variantString"checklist"`checklist` or `dock`.
done_atOption<ClockMs>Default::default()When the last item finished (dock fade).
expandedboolDefault::default()Dock expanded.
strikeboolDefault::default()Strike done items through.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EnterorSpaceExpand 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" with aria-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/calm after dur.shimmer.delay (600 ms); in the dock, the current label swaps with the verb-cycler fade (180 ms, Width::ReserveLongest so 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-sweep variants draw a strike line left → right over 200 ms. Numerator rolls. In step-timeline the connector to the next marker fills top → bottom (240 ms ease.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.enter and a color.plan.changed tint that fades over dur.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 ms ease.out). On Approve: footer collapses into "Approved" (220 ms spring.snap), the card folds to the "Plan · 0/7" pill (280 ms ease.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 on spring.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
TransitionDurationDelayEasing / springStaggerFrame rate
Item / step enter200 ms height + 160 ms fade0spring.snap / ease.out40 ms cap 660 Hz
○ → loader120 ms0ease.out—60 Hz
Active label shimmer1400 ms sweep / 800 ms rest600 msease.coast—30 Hz
Dock current-label swap180 ms0ease.out—30 Hz
Loader → ✓ + stroke160 + 240 ms≤ 200 ms beatspring.snap / ease.out—60 Hz
Tense roll240 msafter morphease.out—60 Hz
Strike sweep200 msafter morphease.out—60 Hz
Connector fill240 ms0ease.in-out60 ms per connector60 Hz
Progress numerator / denominator roll280 ms0ease.out30 ms30 Hz
Changed highlight fade1600 ms0ease.out—30 Hz
Reworded crossfade200 ms0ease.in-out—60 Hz
Moved glide (FLIP)240 msuntil pointer leavesspring.snap20 ms60 Hz
Removed: strike / hold / collapse200 / 600 / 180 ms0ease.out / — / ease.in—60 Hz
"Plan updated" note in / hold / out160 / 4000 / 240 ms0ease.out / — / ease.in—60 Hz
Coalesce window for rewrites300 ms————
Approval footer in200 ms0ease.out—60 Hz
Approved → fold to pill220 ms + 280 ms0spring.snap / ease.in-out—60 Hz
Spark to mode chipper composer-mode-switch.md———60 Hz
Dock expand / collapse220 / 280 ms0spring.snap / ease.in—60 Hz
Done tone / hold / fade600 / 4000 / 240 ms0— / — / ease.in—30 Hz
Auto-approve countdown (Pro)per second—digit swap—1 Hz
Reduced motionno 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—linearnone1 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 TodoList from oxyn_dioxus and include RUN_CSS plus the token stylesheet once.
  • A GPUI version exists: TodoListEl in oxyn_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.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI