Skip to content
Back

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-panel
Team workspaces · Spec

Team workspaces

Product spec · Maya Chen · Edited Oct 18

Intro

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 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

  • 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

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.

Terminal
oxyn add ai-side-panel

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

Ask

Suggestions; ask and watch the answer stream.

Team workspaces · Spec

Team workspaces

Product spec · Maya Chen · Edited Oct 18

Intro

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 code is part of Oxyn Pro

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

Get Pro

Proposed

A word diff with Apply and Discard.

Team workspaces · Spec

Team workspaces

Product spec · Maya Chen · Edited Oct 18

Intro

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 code is part of Oxyn Pro

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

Get Pro

Closed

Closed; the Assistant button reopens it.

Team workspaces · Spec

Team workspaces

Product spec · Maya Chen · Edited Oct 18

Intro

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 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

AiSidePanel

PropTypeDefaultDescription
now_msrequiredu64—Host clock (ms).
pageVec<Block>sample_page()Page blocks.
openbooltrueStart open.
proposedboolDefault::default()Start with the intro rewrite proposed (for demos).
assistantString"Assistant"Assistant name.
heightf32480.0Height (px).
on_applyEventHandler<String>—A change was applied (block id).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
EnterAsk
EscapeClose the panel
TabApply, 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" / treeitem with aria-level, aria-setsize, aria-posinset, aria-expanded, aria-busy while 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 input aria-controls the 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 a toolbar labelled "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.soft once.
  • 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 ● n rolls instead (no auto-expand unless Follow-agent is on). New files created by the agent grow in: row height 0 → 24 px with spring.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 −r rolls 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-out glide (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.snap and 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
TransitionDurationDelayEasing / springStaggerFrame rate
Pane underline glide~180 ms0spring.snap—60 Hz
Pane content crossfade120 ms, 4 px shift0ease.out—60 Hz
Badge roll / pop280 ms / ~240 msmax 2 Hzease.out / spring.soft30 ms per digit30 Hz
Agent-touch tint decay600 ms0ease.out—30 Hz
New file grow-in~200 ms0spring.snap40 ms, cap 660 Hz
Expand children / chevron~200 ms / 120 ms0spring.snap / ease.out15 ms, cap 1260 Hz
Collapse140 ms0ease.innone60 Hz
Lazy-load indicator / skeleton120 ms fade150 ms / 400 msease.out——
Filter debounce / reflow80 ms / ≤ 160 ms glide80 msspring.snap (≤ 8 rows) else instant—60 Hz
Follow-agent reveal200 ms (instant > 2,000 px)0ease.in-out—60 Hz
Status value crossfade / roll160 ms / 280 ms0ease.out—30 Hz
Attention tone ramp400 ms0OKLab linear—30 Hz
Gliding tooltip move / swap~160 ms / 100 ms400 ms first show, 0 afterspring.snap—60 Hz
Reduced motionno 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—linearnone≤ 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: LoadError with 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 AiSidePanel from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: AiPanelEl in oxyn_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.

Guides

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