CourierPro
Agent apps / Courier: a coding-agent app built around threads. Every active thread in the sidebar with All, Running and Needs you; the agent's tool lines and one edits card per turn (files with line counts, each diff on demand); suggested replies above the composer; Model and Effort; a Pod pane, the thread's own cloud machine, with Desktop, Ports (open or forward) and Changes (revert a file).
oxyn add courierThe product page calls the pricing service on every render. Cache prices for 60 s, keyed by SKU and currency.
- SearchedgetPrice( in src/
- Readsrc/pricing/client.ts
- Readsrc/pages/product.tsx
- Ranpnpm test pricing · 14 passed
Prices are cached for 60 s per SKU and currency, so a product page now makes one pricing call a minute instead of one per render. The new test covers a hit and an expired entry.
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
- Run several coding agents as threads, see which ones need you, review each turn's edits in one card, reply with a suggestion, and look into the thread's own cloud machine (its desktop, ports and changes).
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
Courier 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 courierUsage
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.
The product page calls the pricing service on every render. Cache prices for 60 s, keyed by SKU and currency.
- SearchedgetPrice( in src/
- Readsrc/pricing/client.ts
- Readsrc/pages/product.tsx
- Ranpnpm test pricing · 14 passed
Prices are cached for 60 s per SKU and currency, so a product page now makes one pricing call a minute instead of one per render. The new test covers a hit and an expired entry.
Code 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.
The product page calls the pricing service on every render. Cache prices for 60 s, keyed by SKU and currency.
- SearchedgetPrice( in src/
- Readsrc/pricing/client.ts
- Readsrc/pages/product.tsx
- Ranpnpm test pricing · 14 passed
Prices are cached for 60 s per SKU and currency, so a product page now makes one pricing call a minute instead of one per render. The new test covers a hit and an expired entry.
Code 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.
Start a thread
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Changes
The pod on Changes: three files with their line counts and Revert on each.
The product page calls the pricing service on every render. Cache prices for 60 s, keyed by SKU and currency.
- SearchedgetPrice( in src/
- Readsrc/pricing/client.ts
- Readsrc/pages/product.tsx
- Ranpnpm test pricing · 14 passed
Prices are cached for 60 s per SKU and currency, so a product page now makes one pricing call a minute instead of one per render. The new test covers a hit and an expired entry.
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.
The product page calls the pricing service on every render. Cache prices for 60 s, keyed by SKU and currency.
- SearchedgetPrice( in src/
- Readsrc/pricing/client.ts
- Readsrc/pages/product.tsx
- Ranpnpm test pricing · 14 passed
Prices are cached for 60 s per SKU and currency, so a product page now makes one pricing call a minute instead of one per render. The new test covers a hit and an expired entry.
Code 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.
The product page calls the pricing service on every render. Cache prices for 60 s, keyed by SKU and currency.
- SearchedgetPrice( in src/
- Readsrc/pricing/client.ts
- Readsrc/pages/product.tsx
- Ranpnpm test pricing · 14 passed
Prices are cached for 60 s per SKU and currency, so a product page now makes one pricing call a minute instead of one per render. The new test covers a hit and an expired entry.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Desktop
The pod's desktop: the product page in the pod's browser with the cached price.
The product page calls the pricing service on every render. Cache prices for 60 s, keyed by SKU and currency.
- SearchedgetPrice( in src/
- Readsrc/pricing/client.ts
- Readsrc/pages/product.tsx
- Ranpnpm test pricing · 14 passed
Prices are cached for 60 s per SKU and currency, so a product page now makes one pricing call a minute instead of one per render. The new test covers a hit and an expired entry.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
CourierScreen
| 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`, `changes` or `desktop`). |
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<CourierData> | Default::default() | Your data. `None` shows the sample for `state`; start from `CourierData::default()`. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Enter | Send (Shift + Enter for a new line) |
| ← → | Move between Desktop, Ports and Changes |
| Escape | Close the model, effort or account menu |
Accessibility
- The sidebar is a nav landmark; All, Running and Needs you are a radiogroup; each thread names its state.
- Each file in the edits card opens its diff (aria-expanded).
- Suggested replies are a labelled group of buttons that fill the composer.
- Desktop, Ports and Changes are a tablist (roving tabindex, arrow keys); 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)
1440 × 900 stage; /full at the real viewport. Under 960 px the sidebar is a drawer and the pane opens over the conversation from the top bar. Under 620 px chip labels shorten and dates hide in rows. scripts/ovl.py finds no text overlap at 1440, 768 and 390 in light and dark.
Notes for AI
- Import
CourierScreenfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
CourierElinoxyn_gpui. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.