Skip to content

User Settings

Jump to bottom
github-actions[bot] edited this page May 23, 2026 · 5 revisions

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 — see Workspaces → Center tabs for the tab lifecycle. Settings can be opened even without an active workspace — BLXCode lazily provisions an ephemeral shell workspace that hosts only the Settings tab and is disposed when you close it.

Sidebar categories

Category What it configures
App UI language, STT language + push-to-talk, keyboard shortcut mode, notifications, terminal hooks, app updates
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.

App

Settings → App collects shell-wide preferences that aren't tied to a single workspace: UI language, voice/STT defaults, keyboard shortcut mode (Tmux-style vs Classic), notification toasts and sounds, terminal hooks, and the GitHub Releases auto-updater.

Settings → App pane with UI Language (English), Input language (Follow app language / Auto-detect / Manual), Keyboard shortcuts (Tmux style / Classic), push-to-talk toggle, Notifications (Show success toasts, Play success sound), Terminal hooks for claude/codex/gemini/cursor/opencode with Install hooks button, and App updates (Check for updates on startup, Current version 0.2.3)

Appearance

Settings → Appearance lets you pick an app theme:

  • BLXCode (default) — the original dark workbench look
  • Eleven additional dark/light presets (Dracula, Gruvbox, Solarized, Nord, One Dark, Catppuccin, Tokyo Night, BLXCode Light)
  • Search and All / Dark / Light filters
  • Instant preview on each card; choice persists across restarts

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

Full guide: Appearance & Themes.

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.

Settings → API Keys pane with LLM Providers (OpenRouter configured ********4b6e, Anthropic NOT SET with BLX_ANTHROPIC_API_KEY env fallback hint, OpenAI NOT SET, Google/Mistral/Grok xAI COMING SOON), Search Providers (Tavily NOT SET, Brave Search NOT SET), and Image/Video/Voice section with fal.ai row

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.

Settings → BLXCode Agent pane with Text card (Provider OpenRouter, Thinking level Medium, Model openai/gpt-5 with pricing $1.25 in / $10.00 out per 1M tokens), Image card (Provider OpenRouter, Quality level Medium, Model google/gemini-2.5-flash-image with pricing $0.30 in / $2.50 out), Voice card (Provider OpenRouter, STT model gpt-4o-mini-transcribe, TTS model neural, recording quality Low / Standard / High, post-STT behavior, 6-voice picker grid, Speak agent replies toggle), and Web Tools row (Disabled / Tavily / Brave)

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

User guides

Developer guides

Documentation source · Repository

Clone this wiki locally