Skip to content
Back

Settings commandPro

Workspace settings on one page: the search grows into a palette that flies to any setting (the row breathes twice), and an unsaved-changes bar counts edits, validates, saves or retries.

oxyn add settings-command

Settings

General

Your workspace

Shown in the sidebar and emails
Letters, numbers and dashes
oxyn.dev/
Light, dark or follow the system

Agents

How agents run by default

Used for new threads
Writes outside the worktree, installs, pushes
How long agents think before acting

Notifications

When we reach you

A summary of runs each morning
Notify when a background run ends
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

  • Workspace settings people search more than they browse: "where do I turn off the digest?" The answer should be one keystroke away, and edits should be safe to undo before they're saved.

When not to use

  • Search and run anything from one field: use Command palette instead.
  • On or off for things that apply right away: use Switch instead.
  • Pick one option in the text field's look: use Select instead.

Installation

Settings command 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 settings-command

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

Search

The palette finds Daily digest by its keyword.

Settings

General

Your workspace

Shown in the sidebar and emails
Letters, numbers and dashes
oxyn.dev/
Light, dark or follow the system

Agents

How agents run by default

Used for new threads
Writes outside the worktree, installs, pushes
How long agents think before acting

Notifications

When we reach you

A summary of runs each morning
Notify when a background run ends
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

Page

The settings page; edit to see the bar.

Settings

General

Your workspace

Shown in the sidebar and emails
Letters, numbers and dashes
oxyn.dev/
Light, dark or follow the system

Agents

How agents run by default

Used for new threads
Writes outside the worktree, installs, pushes
How long agents think before acting

Notifications

When we reach you

A summary of runs each morning
Notify when a background run ends
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

Retry

The first save fails with Retry.

Settings

General

Your workspace

Shown in the sidebar and emails
Letters, numbers and dashes
oxyn.dev/
Light, dark or follow the system

Agents

How agents run by default

Used for new threads
Writes outside the worktree, installs, pushes
How long agents think before acting

Notifications

When we reach you

A summary of runs each morning
Notify when a background run ends
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

SettingsCommand

PropTypeDefaultDescription
sectionsrequiredVec<(String, String, String)>—Sections (id, label, one line).
settingsrequiredVec<Setting>—Settings.
savedrequiredBTreeMap<String, SettingValue>—Saved values.
suggestedVec<String>Default::default()Ids offered before typing.
titleString"Settings"Heading.
save_msu32900Simulated save time ms.
fail_firstboolDefault::default()The first save fails (to show Retry).
open_queryOption<String>Default::default()Start with the palette open and this query.
widthf32640.0Width px.
on_saveEventHandler<Vec<String>>—Saved (changed ids).

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
⌘KorCtrlKor/Open the settings search
↑or↓Move through results
EnterJump to the setting and focus its control
EscClose the palette

Accessibility

  • Each control is labelled by its setting and described by its hint or error.
  • Edited rows carry a dot plus hidden "Edited" text; saves and errors are announced.
From the spec

Each control is labelled by its setting and described by its hint (or error, aria-invalid). Edited rows add hidden "Edited" text, not just a dot. Save results are announced.

Motion & interaction

The search field grows into the palette. Jumping scrolls smoothly and the target row breathes twice. The unsaved bar pops in; its label rolls as the count changes.

Timing
TransitionDurationEasingReduced motion
Palette open260 msease.out120 ms fade
Row breathe1.6 s, 2 pulsesease.outone 800 ms pulse
Bar in280 msease.outfade
Saved1.6 s visible—same

Responsive behaviour

  • 640 px wide by default; the section nav sits beside the scrolling page.
Edge cases (spec)

Text settings validate length and required. Saving with nothing changed is impossible (no bar). Very long setting lists scroll; the palette shows at most eight results.

Notes for AI

  • Import SettingsCommand from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • There is no GPUI version yet; use the Dioxus component.
  • Props to set first: sections, settings, saved.
  • 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