Skip to content
Back

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

Add rate limiting to the public API

~3 min
  1. 1
    src/api/router.rs, src/api/middleware/*
    read
  2. 2
    edit
  3. 3
    edit
  4. 4
    bash
  5. 5
    edit
Drag or ⌥↑ ⌥↓ to reorder
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

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

Terminal
oxyn add agent-plan

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

Review

Draft: rename, drag, remove, add, Run plan.

Add rate limiting to the public API

~3 min
  1. 1
    src/api/router.rs, src/api/middleware/*
    read
  2. 2
    edit
  3. 3
    edit
  4. 4
    bash
  5. 5
    edit
Drag or ⌥↑ ⌥↓ to reorder
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

Running

Running with live timers.

Add rate limiting to the public API

2/5
  1. 1
    Read the API router and middleware
    src/api/router.rs, src/api/middleware/*
    read9s
  2. 2
    Add a token-bucket limiter keyed by API key
    edit19s
  3. 3
    Return 429 with Retry-After
    edit12s
  4. 4
    Write tests for burst and refill
    bash
  5. 5
    Update the API docs
    edit
Running
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

Failed

A step failed: Retry from here.

Add rate limiting to the public API

3/5
  1. 1
    Read the API router and middleware
    src/api/router.rs, src/api/middleware/*
    read8s
  2. 2
    Add a token-bucket limiter keyed by API key
    edit22s
  3. 3
    Return 429 with Retry-After
    edit9s
  4. 4
    Write tests for burst and refill
    2 tests failed: refill_after_burst, retry_after_header
    bash17s
  5. 5
    Update the API docs
    edit
Running
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

Done

Finished with Run again.

Add rate limiting to the public API

5/5
  1. 1
    Read the API router and middleware
    src/api/router.rs, src/api/middleware/*
    read10s
  2. 2
    Add a token-bucket limiter keyed by API key
    edit20s
  3. 3
    Return 429 with Retry-After
    edit16s
  4. 4
    Write tests for burst and refill
    bash24s
  5. 5
    Update the API docs
    edit15s
Plan finished
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

AgentPlan

PropTypeDefaultDescription
planrequiredPlanDraft—Plan.
nowrequiredClockMs—Shared clock.
cancellablebooltrueShow Cancel next to Run plan.
on_renameEventHandler<(usize, String)>—Rename step.
on_moveEventHandler<(usize, usize)>—Move step from → to.
on_removeEventHandler<usize>—Remove step.
on_addEventHandler<String>—Add a step.
on_runEventHandler<()>—Run plan / Run again.
on_cancelEventHandler<()>—Cancel.
on_retryEventHandler<String>—Retry from a step id.

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabStep titles (editable), remove buttons, Add, Cancel, Run plan
⌥↑or⌥↓Move the focused step
EnterCommit 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 AgentPlan from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: AgentPlanEl in oxyn_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.

Guides

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