Agent PlanPro
An agent's step-by-step plan to review before it runs: rename, drag to reorder, remove or add steps, then watch each run with live timers and retry from a failed step.
oxyn add agent-planAdd rate limiting to the public API
~3 min- 1readsrc/api/router.rs, src/api/middleware/*
- 2edit
- 3edit
- 4bash
- 5edit
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
- An agent's step-by-step plan to review before it runs.
- In draft every title is editable, steps drag to reorder (or ⌥↑/⌥↓), can be removed (at least one stays) or added; an estimate shows in the header.
- Run plan starts the first step; each step then shows a live timer, done steps their time, a failed step its error with Retry from here; the tray offers Run again once done.
When not to use
- An agent asks before it acts: use Approval Card instead.
- Several open requests in one card: use Approval pager instead.
- An agent's question in its own card above the composer: use Decision Card instead.
Installation
Agent Plan 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-planUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Review
Draft: rename, drag, remove, add, Run plan.
Add rate limiting to the public API
~3 min- 1readsrc/api/router.rs, src/api/middleware/*
- 2edit
- 3edit
- 4bash
- 5edit
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Running
Running with live timers.
Add rate limiting to the public API
2/5- 1read9sRead the API router and middlewaresrc/api/router.rs, src/api/middleware/*
- 2edit19sAdd a token-bucket limiter keyed by API key
- 3edit12sReturn 429 with Retry-After
- 4bashWrite tests for burst and refill
- 5editUpdate the API docs
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Failed
A step failed: Retry from here.
Add rate limiting to the public API
3/5- 1read8sRead the API router and middlewaresrc/api/router.rs, src/api/middleware/*
- 2edit22sAdd a token-bucket limiter keyed by API key
- 3edit9sReturn 429 with Retry-After
- 4bash17sWrite tests for burst and refill2 tests failed: refill_after_burst, retry_after_header
- 5editUpdate the API docs
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Done
Finished with Run again.
Add rate limiting to the public API
5/5- 1read10sRead the API router and middlewaresrc/api/router.rs, src/api/middleware/*
- 2edit20sAdd a token-bucket limiter keyed by API key
- 3edit16sReturn 429 with Retry-After
- 4bash24sWrite tests for burst and refill
- 5edit15sUpdate the API docs
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
AgentPlan
| Prop | Type | Default | Description |
|---|---|---|---|
planrequired | PlanDraft | — | Plan. |
nowrequired | ClockMs | — | Shared clock. |
cancellable | bool | true | Show Cancel next to Run plan. |
on_rename | EventHandler<(usize, String)> | — | Rename step. |
on_move | EventHandler<(usize, usize)> | — | Move step from → to. |
on_remove | EventHandler<usize> | — | Remove step. |
on_add | EventHandler<String> | — | Add a step. |
on_run | EventHandler<()> | — | Run plan / Run again. |
on_cancel | EventHandler<()> | — | Cancel. |
on_retry | EventHandler<String> | — | Retry from a step id. |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Step titles (editable), remove buttons, Add, Cancel, Run plan |
| ⌥↑or⌥↓ | Move the focused step |
| Enter | Commit a rename |
Accessibility
- An ordered list named by the goal; each title is a labelled text input in draft.
- Remove buttons are named “Remove step n”; failed steps show their error as text.
From the spec
- Ordered list labelled by the goal; inputs labelled “Step n”.
- Remove buttons named; errors are text.
Motion & interaction
Timing
- Reduced motion: no entrance rise, no shimmer (static muted text), rings and bars jump to their value.
Responsive behaviour
- Fills its container; tool tags and timers stay on the right.
Edge cases (spec)
- Fills its container.
Notes for AI
- Import
AgentPlanfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
AgentPlanElinoxyn_gpui. - Props to set first:
plan,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.