AI side panelPro
An assistant docked beside a page: it streams an answer, proposes an edit as a word diff, applies it with a tint and offers Undo.
oxyn add ai-side-panelTeam workspaces
Product spec · Maya Chen · Edited Oct 18Intro
Team workspaces are a new feature that will make it possible for people who work together to share their projects, files and billing in one single place, so that they no longer need to forward invoices around.
Goals
Cut the time it takes to invite a team from six minutes to under one. Move 30% of paid solo accounts to a team plan by March.
Pricing
Per seat, billed monthly. Admins add or remove seats at any time and changes are prorated on the next invoice.
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
- sub-agents, browser, trace, MCP servers — with a badge telling them which one has news.
- Claude desktop has pane kinds chat, diff, browser, terminal, file, plan, tasks, subagent with a ⋮ overflow for panes without buttons (notes 03, 05); Claude desktop also has a session-details rail with cards (where it runs, Changes, running tasks, Context %) (note 03); Devin uses workspace tabs Progress / Shell / IDE / Browser (note 03); Hoplite thread tabs Chat, Diff, Pull requests, Previews, Terminal, Subagents from a "+ tab menu" (note 10); OpenCode desktop plugins render their own sidebar UI (note 03). and where is the one I need?" Research note 05 §6 lists node states unchanged, added, modified, deleted, renamed, agent-touched (sparkle dot), in-context (@-mentioned), ignored, conflicted, reviewed; AI Elements File Tree shows "files the agent changed, as a folder tree" (note 05); Hoplite's changed-files tree carries per-file + / − counts, filter and jump, mark as viewed, [ / ] to step files, drag-to-resize and a hide button (note 10); a tree that grows as the agent touches files [R004] [R038].
- MCP health, problems, notifications.
- Codex CLI's footer collapses by width with priority rules; Claude CLI's /statusline (model, dir, context, cost); Zed's ✨ agent icon in the status bar; Verdent's workspace bar (all note 03); ObsidianUI Status Bars with a gliding tooltip and keyboard grid [R094].
When not to use
- An app sidebar: use Sidebar instead.
- How full the context window is: use Context meter instead.
- Search and run anything from one field: use Command palette instead.
Installation
AI side panel 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 ai-side-panelUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Ask
Suggestions; ask and watch the answer stream.
Team workspaces
Product spec · Maya Chen · Edited Oct 18Intro
Team workspaces are a new feature that will make it possible for people who work together to share their projects, files and billing in one single place, so that they no longer need to forward invoices around.
Goals
Cut the time it takes to invite a team from six minutes to under one. Move 30% of paid solo accounts to a team plan by March.
Pricing
Per seat, billed monthly. Admins add or remove seats at any time and changes are prorated on the next invoice.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Proposed
A word diff with Apply and Discard.
Team workspaces
Product spec · Maya Chen · Edited Oct 18Intro
Team workspaces are a new feature that will make it possible for people who work together to share their projects, files and billing in one single place, so that they no longer need to forward invoices around.
Goals
Cut the time it takes to invite a team from six minutes to under one. Move 30% of paid solo accounts to a team plan by March.
Pricing
Per seat, billed monthly. Admins add or remove seats at any time and changes are prorated on the next invoice.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Closed
Closed; the Assistant button reopens it.
Team workspaces
Product spec · Maya Chen · Edited Oct 18Intro
Team workspaces are a new feature that will make it possible for people who work together to share their projects, files and billing in one single place, so that they no longer need to forward invoices around.
Goals
Cut the time it takes to invite a team from six minutes to under one. Move 30% of paid solo accounts to a team plan by March.
Pricing
Per seat, billed monthly. Admins add or remove seats at any time and changes are prorated on the next invoice.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
AiSidePanel
| Prop | Type | Default | Description |
|---|---|---|---|
now_msrequired | u64 | — | Host clock (ms). |
page | Vec<Block> | sample_page() | Page blocks. |
open | bool | true | Start open. |
proposed | bool | Default::default() | Start with the intro rewrite proposed (for demos). |
assistant | String | "Assistant" | Assistant name. |
height | f32 | 480.0 | Height (px). |
on_apply | EventHandler<String> | — | A change was applied (block id). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Enter | Ask |
| Escape | Close the panel |
| Tab | Apply, Discard, Undo |
Accessibility
- The panel is a labelled complementary region; the thread is a polite log.
- Apply moves focus to Undo; changes are announced.
From the spec
- Side panel: tab strip =
tablist; panes =tabpanel; badges are part of the tab name ("Changes, 12 files", "Agents, needs you"). - File tree:
role="tree"/treeitemwitharia-level,aria-setsize,aria-posinset,aria-expanded,aria-busywhile loading; name composes file, git status in words, agent marks and in-context ("refresh.rs, modified, 42 added 7 removed lines, edited by Researcher, in context"). Type-ahead;*expands siblings; Home / End. Filter inputaria-controlsthe tree and announces "12 matches" politely (debounced 500 ms). - Agent changes are not announced per file; one polite summary per agent step ("Researcher changed 3 files").
- Status bar: container
role="status"is wrong for an interactive bar, so the bar is atoolbarlabelled "Status bar" with roving focus, plus a separate visually hidden polite live region for attention changes ("Agent needs approval", "3 problems"). Values never announced per tick. - Contrast: git letters and diff counts ≥ 4.5:1; marks ≥ 3:1 and always backed by text in the name; conflict and deletion use glyph + strike, not colour alone; colour-blind palette option swaps green/red for blue/orange (Claude daltonized idea, note 08).
- Focus: F6 lands on the last focused tree row; agent activity never moves focus.
- Reduced motion: §6 last row.
Motion & interaction
- Pane switch. Underline glides between tabs (
spring.snap); content crossfades 120 ms with a 4 px shift in the direction of travel; no height animation (panes fill the dock). - Badge. Count rolls (odometer, tabular digits, ≤ 2 Hz); a new Attention badge pops 0.8 → 1 with
spring.softonce. - Agent touches a file (tree visible). The row's ✦ fades in and the row gets a 600 ms tint in the agent tone that decays; if the file's folder is collapsed, the folder's
● nrolls instead (no auto-expand unless Follow-agent is on). New files created by the agent grow in: row height 0 → 24 px withspring.snap, siblings slide; several new files stagger 40 ms (cap 6) — a calm version of [R004]'s growth-as-reveal (≈40–60 ms stagger). - Live edit. ✦⠋ loader while the agent writes; on finish it morphs to ✦ and
+a −rrolls in. - Expand / collapse. Children height-open with
spring.snap, rows fade in staggered 15 ms (cap 12); chevron rotates 90° in 120 ms. Collapse is faster and unstaggered. - Lazy load. No spinner for loads under 150 ms; after 150 ms the chevron becomes ◌; after 400 ms one skeleton row; children then replace it without layout jump.
- Filter. Results update per keystroke after 80 ms debounce; highlight characters in medium weight; the list reflows with small glides (≤ 8 rows) and snaps on long jumps (same rule as the slash menu, composer-slash-mentions.md).
- Follow agent. The live file scrolls into view with a 200 ms
ease.in-outglide (instant if > 2,000 px) and a brief outline; user focus never moves. - Status bar value change. Numbers roll; text crossfades 160 ms; attention tone ramps in 400 ms; the gliding tooltip moves between items with
spring.snapand changes content with a 100 ms crossfade. - Width collapse. Items leaving for
⋯fade 120 ms; the⋯badge pulses once if a hidden item gains attention.
Timing
| Transition | Duration | Delay | Easing / spring | Stagger | Frame rate |
|---|---|---|---|---|---|
| Pane underline glide | ~180 ms | 0 | spring.snap | — | 60 Hz |
| Pane content crossfade | 120 ms, 4 px shift | 0 | ease.out | — | 60 Hz |
| Badge roll / pop | 280 ms / ~240 ms | max 2 Hz | ease.out / spring.soft | 30 ms per digit | 30 Hz |
| Agent-touch tint decay | 600 ms | 0 | ease.out | — | 30 Hz |
| New file grow-in | ~200 ms | 0 | spring.snap | 40 ms, cap 6 | 60 Hz |
| Expand children / chevron | ~200 ms / 120 ms | 0 | spring.snap / ease.out | 15 ms, cap 12 | 60 Hz |
| Collapse | 140 ms | 0 | ease.in | none | 60 Hz |
| Lazy-load indicator / skeleton | 120 ms fade | 150 ms / 400 ms | ease.out | — | — |
| Filter debounce / reflow | 80 ms / ≤ 160 ms glide | 80 ms | spring.snap (≤ 8 rows) else instant | — | 60 Hz |
| Follow-agent reveal | 200 ms (instant > 2,000 px) | 0 | ease.in-out | — | 60 Hz |
| Status value crossfade / roll | 160 ms / 280 ms | 0 | ease.out | — | 30 Hz |
| Attention tone ramp | 400 ms | 0 | OKLab linear | — | 30 Hz |
| Gliding tooltip move / swap | ~160 ms / 100 ms | 400 ms first show, 0 after | spring.snap | — | 60 Hz |
| Reduced motion | no glides, grows, tint decays or pops: state appears with an 80 ms crossfade; marks and counts still update (information); live-edit loader shows its still frame; tooltip jumps | — | linear | none | ≤ 2 Hz |
Responsive behaviour
- The panel takes up to 48% of the frame and at most 340 px.
Edge cases (spec)
- Huge repos (100k+ files): rows virtualised (render window + 20 rows overscan); folders with > 2,000 children show the first 2,000 then "Show 2,000 more"; filter runs over the app's index, not the DOM, and shows "Searching…" after 300 ms.
- Symlink loops: detect by canonical path; show the link with ↪ and don't descend.
- Permission denied / unreadable folders:
LoadErrorwith the OS reason; never infinite spinner (10 s timeout). - Rename / delete while the agent is editing that file: blocked with tooltip "Researcher is editing this file"; the user can take over (acting-indicator).
- Agent edits 200 files at once: tint and grow animations are skipped above 20 changes per second; folder counts roll once at the end; a summary "Agent changed 200 files" appears in the pane header.
- Deleted files: stay as struck-through rows until committed, so the user can review deletions.
- Long names: middle-truncate with extension kept (
refresh_tok…_test.rs); full path tooltip. - Case-only renames / Unicode normalisation: display the new case; compare NFC-normalised paths.
- Ignored files: hidden by default with "⋯ 2 ignored hidden"; in-context ignored files are shown with a warning (the agent can see something the project ignores).
- Status bar overflow: below 480 px only priority 1–2 plus
⋯; attention items always win. - RTL: tree indents from the inline-start (right); chevrons mirror; paths stay LTR inside bidi isolates; status bar zones mirror.
- Tiny sizes: tree rows at 20 px drop diff counts first, then git letters (kept as colour + tooltip, plus the letter in the accessible name).
- Dense IDE: 22 px rows, 10 px indent, 11–12 px text.
- Touch: 44 px rows; swipe-left on a row reveals Mark viewed / Attach; long-press = context menu.
- Slow networks / remote FS: lazy-load timeout 10 s →
LoadError; watcher desync banner; status values older than 30 s show a dim "stale" dot. - Very fast agents: live-edit loaders shorter than 300 ms are not shown (only the final ✦ mark).
Notes for AI
- Import
AiSidePanelfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
AiPanelElinoxyn_gpui. - Props to set first:
now_ms. - 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.