Session StudioPro
Agent apps / Session Studio: a desktop coding-agent app in the session-and-tools pattern. A session list; a chat whose turns show Read, Edit (inline diff) and Bash blocks; permission prompts (Allow once, Always allow, Deny, keys 1 2 3); a permission mode (Ask before edits, Accept edits, Plan mode; Shift + Tab cycles) where Plan mode answers with a plan to approve that becomes the todo list; a todo list with progress; and side panes (Diff with each session's own changes, a side chat, Context) that collapse and can be dragged into a new order.
oxyn add session-studioInvoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesThe 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
- Work with a coding agent in a session: see every file it reads and edits and every command it runs, answer its permission prompts, plan first when you want to, and check the diff.
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
Session Studio 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 session-studioUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Sample
Sample data, the main area as an inset card.
Invoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Flat
The same view with the main area edge to edge.
Invoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Loading
Skeletons in the sidebar, the conversation and the pane.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Empty
A first run: nothing yet, the composer front and centre.
What are we changing today?
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Permission
The session stopped to ask before running the test command.
Invoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesRun this command? It runs the invoice tests in billing-svc.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
X1
Oxyn: the sidebar as a 56 px icon rail; the top bar expands it.
Invoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
X2
Oxyn: the sidebar hidden for focus; the top bar brings it back.
Invoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Chat
The side chat pane under the diff: ask about the session without interrupting it.
Invoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Arrange
Rearrange: drag the Diff, Side chat and Context panes by their handles, or move them with the arrow buttons.
Invoice PDFs are rendered on every download. Cache them by invoice id and version, and clear the cache when an invoice changes.
I'll find where PDFs are rendered, add a cache keyed by id and version, then run the invoice tests.
src/invoices/pdf.tsRead 88 linessrc/invoices/events.tsRead 41 linessrc/invoices/pdf.ts+const cache = new Map<string, Buffer>();+const key = `${inv.id}@${inv.version}`;+if (cache.has(key)) return cache.get(key)!;-return render(inv);+const pdf = await render(inv);+cache.set(key, pdf);+return pdf;
src/invoices/events.ts+onInvoiceChanged((id) => clearPdf(id));$ npm test -- invoicesCode Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
SessionStudioScreen
| Prop | Type | Default | Description |
|---|---|---|---|
layout | String | "inset" | `inset` or `flat`: the main area as a rounded card on the sidebar's grey, or edge to edge. |
state | String | "sample" | A state key (`sample`, `loading`, `empty` or `permission`). |
height | u32 | 900 | Height px (outside a stage). |
rail | bool | Default::default() | Oxyn: open with the sidebar as a 56 px icon rail. |
sidebar_hidden | bool | Default::default() | Oxyn: open with the sidebar hidden (the top bar brings it back). |
data | Option<SessionStudioData> | Default::default() | Your data. `None` shows the sample for `state`; start from `SessionStudioData::default()` and replace what you have. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| ShiftTab | Cycle the permission mode (Ask, Accept edits, Plan) |
| Enter | Send (Shift + Enter for a new line) |
| Tab | Sessions, the blocks and their buttons, todos, the composer, the diff |
Accessibility
- The sidebar is a nav landmark; the open session carries aria-current=page.
- A permission prompt and a plan are labelled groups; their buttons say what they do.
- Todos are real checkboxes; the running one shows a spinner and the waiting one an amber dot.
- Permission mode and model are menus of menuitemradio; every action reports in a polite live region.
Responsive behaviour
- Authored on the 1440 × 900 canvas: a 272 px sidebar, the conversation and a 440 px pane (380 px under 1180).
- Under 960 px the sidebar becomes a drawer from the top bar and the pane opens over the conversation from its top-bar button.
- Under 620 px the chips shorten and the composer and pane keep their actions; labels ellipsise.
Edge cases (spec)
As Command Center: drawer sidebar and the diff pane over the chat under 960 px; shorter chips under 620 px; no text overlap at 1440, 768 and 390 in light and dark (scripts/ovl.py).
Notes for AI
- Import
SessionStudioScreenfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
SessionStudioElinoxyn_gpui. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.