Thread listPro
Agent threads grouped by where they stand: what needs you rises with an Approval or Input chip, finished work says Done, Working and Settled fold into counted groups.
oxyn add thread-listThe 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
- Agent threads grouped by where they stand (group_threads).
- The top group puts what needs you first: Approval, then Input, then unseen Done, then everything else newest first, each idle row showing its age (21m).
- Working threads sit in a counted group with a dashed spinner and their run time (Working 2m); Settled threads fold into a counted group that starts closed.
- Each row has a square project badge with initials (initials), the project, the chip or age, the title and the agent mark.
When not to use
- Mail folders with counts and labels beside a message list: use Inbox sidebar instead.
- The app frame: use App shell instead.
- An assistant docked beside a page: use AI side panel instead.
Installation
Thread 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 thread-listUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Needs you
Approval and Input rise to the top; Working and Settled group underneath.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Calm
Nothing waiting: rows show their age.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Open
Settled group open, no search.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
ThreadList
| Prop | Type | Default | Description |
|---|---|---|---|
threadsrequired | Vec<Thread> | — | Threads. |
selected | Option<String> | Default::default() | Open thread id. |
search | bool | true | Show the search row. |
settled_open | bool | Default::default() | Start with the Settled group open. |
on_select | EventHandler<String> | — | A thread was opened. |
on_new | EventHandler<()> | — | The new-thread button. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| ↑or↓orHomeorEnd | Move through rows and group headers |
| Enter | Open the thread, or open / close a group header |
| ←or→ | Close / open the group under the cursor |
Accessibility
- The list is role=listbox with aria-activedescendant: one tab stop.
- Chips carry text (Approval, Input, Done, Working 2m), not colour alone; the 'need you' count is role=status.
- Reduced motion drops the row entrance and the working spinner.
From the spec
- role=listbox with aria-activedescendant; rows are role=option with aria-selected; headers carry aria-expanded.
- Chips are words, not colour alone (Approval amber, Input blue and Done green are status colour, allowed by the colour rule).
Motion & interaction
Timing
- Rows rise in over 220 ms; chips swap with a 200 ms rise when a thread changes state.
- The group chevron turns in 200 ms.
- Working spinner: 2.4 s a turn.
- Reduced motion: no entrance, no spinner turn.
Responsive behaviour
- Fills its column up to 300 px; titles ellipsize.
Edge cases (spec)
- Fills its column up to 300 px; titles and projects ellipsize.
Notes for AI
- Import
ThreadListfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
ThreadListElinoxyn_gpui. - Props to set first:
threads. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.