Settings

Open settings with /settings, Cmd+,, or the gear menu. Every preference persists across restarts; storage is handled by the Tauri backend in the standard app-support directory for your OS.

The settings UI is split into sections that match the tabs in the side panel.

Appearance
Confirmations
Debug Container
Saved Queries
Prometheus
Plugins
Column Overrides
History

Appearance

Pick a theme. The picker shows a live preview swatch for every theme (background, surface, text, accent). Click a swatch to apply immediately.

See themes.md for the full catalog.

Confirmations

Two settings live here.

Mutation Confirmations, a one-of-three picker:

Option	Behavior
Phrase (default)	When a phrase is required (typically the object name), the Confirm button stays disabled until you type it verbatim.
Yes / No	Phrase typing is suppressed; Confirm is immediately enabled. The modal still appears so you can review diffs and inputs.
No Confirmation	Mutations fire immediately. The modal only renders if an error needs to be surfaced.

Auth Failures, a single toggle: Impersonate on Auth Failure. When enabled, a Permission Denied or Not Signed In error prompts you to activate /as with a recent or new identity. The failed action is not retried automatically; you re-run it under the new identity.

For the full mutation flow, see mutations.md.

Debug Container

The default image used when adding an ephemeral debug container from a pod’s Shell tab (the equivalent of kubectl debug). Leave blank to be prompted for an image every time. A typical value:

registry.example.com/debug:latest

The Save button stays disabled until the value differs from what is saved.

Saved Queries

Inline editor for command aliases. Each row has a name and a body; the name expands to the body when you type /<name> in the command bar.

Buttons on each row:

Button	Effect
Save	Persist the current edits.
Run	Execute the body as if you had typed it in the command bar.
Copy	Copy the body to the clipboard.
Delete	Remove the alias.

You can also save and remove aliases from the command bar with /save and /unsave. See command-bar.md.

Prometheus

Appears when Prometheus support is enabled. Configure data source URLs and per-resource default dashboards. Once configured, the Metrics tab on supported kinds renders charts and the /prom workspace runs PromQL against the configured sources.

Plugins

Lists every installed plugin: built-ins shipped with the binary, and user plugins dropped into the plugins directory or installed from a URL. Each row shows the plugin name, version, description, and an enable or disable toggle. Compile errors surface inline so you can fix and reload without restarting the app.

Buttons:

Button	Effect
New TypeScript Plugin	Scaffolds a `<name>.tsx` plus the SDK typing files. Equivalent to `/plugin new <name>` from the command bar.
Install from URL	Fetches a `.tsx` from an HTTPS URL into the plugins directory. Equivalent to `/plugin install <url>`. HTTPS only; `http://` and `file://` are rejected.
Open Plugins Folder	Reveals the plugins directory in your file manager.

See plugins/README.md for authoring details.

Column Overrides

Per-resource overrides for the default extra columns. Each entry pairs a resource (kind plural, like pods or deployments) with a list of -L, --ann, and -F columns. The Reset button restores Buoy’s built-in defaults for a single resource. The overrides apply to plain <resource> queries; they are still composable with explicit -L/-F/--ann flags on the command line.

You can also edit column overrides for a single resource from the command bar with /cols:

/cols pods +L env
/cols pods +ann owner-email
/cols pods -L env

History

Read-only list of every command you have run, up to 1000 entries. The Clear button removes the entire history (gated by a confirmation). The list is also reachable as an autocomplete source in the command bar: press Up or Down inside the command bar to walk through it.

Edit this page on GitLab