Agent builderPro
Shape a single assistant before shipping it: rename it in place, choose its model, write its brief, switch integrations on, attach reference files, try it in a sandbox chat, and push the result live.
oxyn add agent-builderNorthwind · v7
- StripeLook up invoices and issue refunds
- HubSpotRead the customer's account and notes
- GmailDraft replies in the shared inbox
- SlackAsk the billing channel for help
- NotionRead the billing playbook
- Refund policy.pdf420 KBReady
- Plan matrix.xlsx96 KB
- Escalation playbook.md18 KB
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
- Configure one agent in a card (name, model, instructions, tools, knowledge), try it, and publish it.
When not to use
- Sit in on a crew of agents mid-run: use Live Session instead.
- One overview for a whole fleet: use Fleet overview instead.
- The fleet overview laid out against time: use Fleet timeline instead.
Installation
Agent builder 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 agent-builderUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Configure
A billing helper, live and saved.
Northwind · v7
- StripeLook up invoices and issue refunds
- HubSpotRead the customer's account and notes
- GmailDraft replies in the shared inbox
- SlackAsk the billing channel for help
- NotionRead the billing playbook
- Refund policy.pdf420 KBReady
- Plan matrix.xlsx96 KB
- Escalation playbook.md18 KB
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Test
The Test view (Oxyn extra).
Northwind · v7
- Try Ledger with one of these:
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Unsaved
Unsaved changes whose first publish fails (Oxyn extra).
Northwind · v7
- StripeLook up invoices and issue refunds
- HubSpotRead the customer's account and notes
- GmailDraft replies in the shared inbox
- SlackAsk the billing channel for help
- NotionRead the billing playbook
- Refund policy.pdf420 KBReady
- Plan matrix.xlsx96 KB
- Escalation playbook.md18 KB
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
AgentBuilder
| Prop | Type | Default | Description |
|---|---|---|---|
nowrequired | ClockMs | — | Host clock. |
testing | bool | Default::default() | Start on the Test view. |
fail | bool | Default::default() | The first publish fails (error scenario). |
unsaved | bool | Default::default() | Start with unsaved changes (Slack turned on). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Through the title, the mode switch, each field and switch, then Publish |
| ←or→ | Swap between setup and sandbox |
| ↑or↓ | While choosing a model: step through, Esc dismisses |
| Enter | Title field: confirm (Esc reverts); sandbox: send |
Accessibility
- All inputs have names; an integration's description is folded into its switch label.
- Files uploading expose progress; a failed one states why beside an icon.
- Saves, uploads and sandbox replies are announced, noting nothing is really deployed.
From the spec
Every field and tool switch is labelled (the tool text is in the switch name); the model picker is a menu of radio items; uploads are progressbars; publishing and replies are announced, including that nothing was deployed. Every action returns the line the polite live region announces. The focus outline shows only for keyboard focus.
Motion & interaction
Tool switches slide; uploads fill; the reply streams two words a tick and names the tools it used; the publish state word changes with an icon.
Timing
Everything on screen is derived from the host clock now (no timers in the block), so playback, tests and the GPUI view agree.
| Transition | Duration | Easing |
|---|---|---|
| Upload | 2600 ms | linear |
| Publish | 1400 ms | — |
| Reply stream | 2 words per 34 ms | linear |
Reduced motion: shimmer, pulses and slides stop; every state keeps its words and icons.
Responsive behaviour
- Max 640 px; long labels end in an ellipsis and the sandbox chat scrolls under a fixed input.
Edge cases (spec)
Up to 640 px; names and descriptions truncate with an ellipsis; the Test thread scrolls with its composer pinned; the view switch takes its own row under 340 px. Layout follows the block's own width (container queries), never the viewport. Checked at 1440, 768 and 390 px in light and dark with no text overlap. Chrome is monochrome grey; colour is semantic only (success, warning, danger, info) plus data series and the official coloured brand and model marks.
Notes for AI
- Import
AgentBuilderfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
BlocksViewinoxyn_gpui. - Props to set first:
now. - 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.