User Settings

Settings

BLXCode opens settings in a center workbench tab (not a modal). The command palette entry Open Settings focuses an existing settings tab or creates one per workspace.

Sidebar categories

Category	What it configures
App	UI language, STT language + push-to-talk, keyboard shortcut mode, notifications, terminal hooks, app updates (GitHub Releases auto-updater)
Appearance	App themes — 20 presets, search, Dark/Light filters; see Appearance & Themes
API Keys	All provider secrets in one pane — see below
Workspace	Default project directory, agent sandbox root, embedded browser URL, category colors for Memory
BLXCode Agent	Text, image, and voice inference — see below

Legacy saved categories (Image, Voice, Memory) still open the correct pane.

Appearance

Settings → Appearance lets you pick an app theme:

• BLXCode (default) — the original dark workbench look
• Nineteen additional dark/light presets (Dracula, Gruvbox, Solarized, Nord, One Dark, Catppuccin, Tokyo Night, Rosé Pine, Everforest, Kanagawa, GitHub Dark, Night Owl, Ayu Mirage, …)
• Search and All / Dark / Light filters
• Instant preview on each card; choice persists across restarts

Full list: Appearance & Themes.

Themes affect sidebar, panels, terminals, graphs, and settings chrome. Embedded web pages, native webviews, and your Memory category color swatches are documented exceptions — see Theme exceptions.

App tab

Settings → App also includes:

• App updates — optional check on startup and manual Check for updates against signed GitHub Releases metadata. When an update is available, BLXCode shows a banner and a themed install dialog (progress, restart). Linux .deb/.rpm remain manual downloads; macOS/Windows can install via the built-in updater when the release ships updater-capable artifacts.

API Keys

Settings → API Keys is the only place to enter provider secrets.

• LLM providers: OpenRouter, Anthropic, OpenAI, and coming-soon rows (Google, Mistral, Grok xAI).
• Media / search: Tavily, Brave, fal.ai (image), Amazon Polly (AWS voice).
• One Save / Discard footer for the whole pane; per-row remove marks keys for deletion on save.
• Keys use the OS keyring (BLXCode service) with BLX_* env fallback when the store is empty; the UI shows via env when a fallback is active.

Agent, image, and voice panes show a short status line pointing here — they do not contain password fields.

BLXCode Agent

Settings → BLXCode Agent uses a grid:

Area	Settings
Text	Provider, thinking level, model (AgentModelPicker), refresh
Image	Provider, quality level, model, auto-save
Voice	Provider (OpenAI / OpenRouter / AWS), STT + TTS models, recording quality, post-STT behavior, voice picks, speak replies
Web Tools	Tavily / Brave / disabled backend

One Save / Discard at the bottom persists text provider + web tools together. Image and voice sections auto-save on change.

Details: Agent Providers, Image Mode, Voice.

Workspace

Settings → Workspace:

• Paths & sandbox — default folder for new workspaces and BLXCode Agent file sandbox root.
• Embedded browser — default URL for the Browser tab.
• Category colors — presets used for Memory category dots and sidebar accents (formerly under a separate Memory settings tab).

See Workspaces.

See also

• Agent Harness — core skills, web tools behavior
• Troubleshooting — keyring and key errors