Settings

Open settings by clicking the gear icon in the sidebar. The settings modal is organized into three tabs: General, Appearance, and Agent.

​

General

​

Account

Manage your workspace profiles and authentication status.

• View all configured profiles with their workspace names
• Switch between profiles
• Add or remove profiles
• See connection status (green/red indicator)
• Log out of the current profile

See authentication for details on setting up profiles.

​

Providers

Configure API keys for each AI model provider. The app supports: Only providers with configured API keys appear in the model selector during chat.

​

OpenAI Compatible endpoints

Add custom OpenAI-compatible API endpoints below the built-in providers. Each endpoint has its own name, base URL, API key, and model list. Click + Add Endpoint to create one, then configure:

• Endpoint Name — a display name shown in the model selector (e.g., “Ollama”)
• Base URL — the API endpoint URL
• API Key — optional, depending on the provider
• Models — add one or more model identifiers available at this endpoint

Models from configured endpoints appear in the model selector and default model dropdown, grouped under the endpoint name.

​

Default model

Select a default model that is used for new sessions. You can override the model per session using the model selector in the input bar.

​

Updates

Check for and install app updates:

• Check for updates — queries the update server for the latest version
• Download & Install — downloads the update and restarts the app

Displays your current version and the latest available version.

​

Appearance

​

Theme

Choose a theme for the app:

• System — follows your operating system theme
• Light — light mode
• Dark — dark mode

Each option shows a miniature preview of a chat session and diff view in that theme. The theme is applied immediately.

​

Fonts

Customize the fonts used throughout the app:

• UI font — the font used for the interface (menus, labels, messages). Enter a CSS font family value.
• Code font — the font used for code blocks, terminal output, and diff sections. Enter a CSS font family value.

The UI font defaults to the platform-native sans-serif (SF Pro on macOS, Ubuntu/Noto Sans on Linux). The code font defaults to a cross-platform monospace stack. The input field previews your chosen font as you type.

​

Language

Select the app language:

• English (US)
• Traditional Chinese (繁體中文)
• Japanese (日本語)

The System option follows your operating system locale.

​

Agent

Configure agent behavior:

• Auto-approve bash commands — when enabled, full-access bash commands and trusted bricks devtools commands run without a confirmation prompt. When disabled (default), you must approve each command before it executes. Sandboxed commands always run within the sandbox regardless of this setting.
• Enable ACP — starts a local socket server so external tools (acpx, OpenClaw) can interact with the agent over the Agent Client Protocol. Disabled by default. Toggling takes effect immediately without restarting the app.
• Sandbox settings — opens sandbox.json to customize sandbox network and filesystem permissions. See Sandbox for details.

​

Default thinking level

Select a default thinking level for new sessions. Available levels: off, minimal, low, medium, high, xhigh. Leave empty to use High.

​

Sub-agent default model

Select a default model for sub-agent spawning. See sub-agents for how this fits into model resolution.

​

Sub-agent default thinking level

Select a default thinking level for sub-agents. Available levels: off, minimal, low, medium, high, xhigh. Leave empty to use the model-specific default. See sub-agents for the full resolution order.

​

Advanced

• Show Thinking Content — display model thinking content in chat messages. Disabled by default.
• Show Prompt Button — show the Prompt button in the input bar. Disabled by default.
• Show Environment Switch — show the environment selector on the login screen. Disabled by default.
• Enable Background Processes — allow the agent to spawn background child processes using the spawn_process tool. Supports daemon (persistent) and long-run (completion callback) modes. Disabled by default.

​

Data storage

The app stores its data in the following locations: