Skip to main content

​
Settings & Customization

Fabriqa Desktop settings are split between application-level settings (providers, appearance, developer options) and workspace-level settings (permissions, audit, diagnostics). Both are accessible from keyboard shortcuts or slash commands.

​
Opening Settings

MethodHow
Keyboard shortcutCmd+, (macOS) / Ctrl+, (Windows / Linux)
Slash command/settings
Command paletteCmd+Shift+P → “Open Settings”

​
Providers

Configure the AI providers Fabriqa connects to:
  • API keys — add keys for Anthropic, OpenAI, and other supported providers.
  • Default provider — select which provider is used when no explicit choice is made.
  • Default model — set the model used for new chats.
  • Presets — manage saved provider+model combinations.
See AI & Agent Features for details on using presets and the model picker.

​
Appearance

Fabriqa includes multiple built-in themes. Open the theme selector with /themes or from Settings → Appearance.Themes include both light and dark variants. The selected theme applies immediately across all windows.
Choose how chat responses are displayed by default:
  • Document — formatted markdown with headings, code blocks, and rich text.
  • Terminal — unformatted terminal-style output.
This is the global default. Individual sessions can override it with /render-document, /render-terminal, or /cycle-view.
Pin the Fabriqa window to float above all other windows. Toggle in Settings → Appearance or from the header pin icon.
Adjust the interface and code font sizes to suit your display and preference.

​
Desktop Hotkey

The global toggle hotkey shows and hides Fabriqa Desktop from anywhere on your desktop. Default: Cmd+Shift+Space (macOS) / Ctrl+Shift+Space (Windows / Linux) To change it:
  1. Go to Settings → Appearance.
  2. Click the hotkey field.
  3. Press your desired key combination.
Restrictions:
  • Keys left of 1 on the keyboard (`, §, ±, °, ¬) are blocked for reliability across international keyboard layouts.
  • Cmd+`` “ on macOS is reserved by the system for window cycling.
If a blocked combination is entered, Fabriqa resets to the default and shows a warning.

​
Developer Settings

Enable verbose logging of the Agent Communication Protocol stream. Useful for troubleshooting unexpected agent behavior. View the stream in the ACP Debug Panel (/acp).
Automatically opens the Git Changes panel when an agentic session modifies files. Disabled by default.
Check for, download, and install in-app updates. Fabriqa Desktop checks for updates automatically and notifies you when one is available.
Set global defaults that apply to all workspaces, such as default agent behavior and feature toggles.

​
Agents

Configure custom agent definitions:
  • Built-in agents — Fabriqa ships with default agent configurations for common workflows.
  • Custom agents — define your own agent with a custom system prompt, tool allowlist, and behavior settings.
  • Agent settings — set defaults for how agents handle ambiguity, confirmation, and tool use.
Access via Settings → Agents, or configure per-chat from the agent settings button in the chat header.

​
Workspace Settings

Workspace settings are separate from application settings and scoped to the active workspace folder. Access via /workspace-settings or Settings → Workspace.
Workspace name, root folder path, active session details, and the custom task file path override for the task runner.

​
Changelog

Review release notes inside the app from Settings → Changelog. Updates are listed in reverse chronological order with descriptions of new features and fixes.