> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fabriqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings & Customization

> Configure providers, appearance, themes, the global hotkey, agents, and workspace settings in Fabriqa Desktop.

# 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

| Method            | How                                          |
| ----------------- | -------------------------------------------- |
| Keyboard shortcut | `Cmd+,` (macOS) / `Ctrl+,` (Windows / Linux) |
| Slash command     | `/settings`                                  |
| Command palette   | `Cmd+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](/features/ai-and-agent) for details on using presets and the model picker.

## Appearance

<AccordionGroup>
  <Accordion title="Themes">
    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.
  </Accordion>

  <Accordion title="Chat rendering mode">
    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`.
  </Accordion>

  <Accordion title="Always on Top">
    Pin the Fabriqa window to float above all other windows. Toggle in Settings → Appearance or from the header pin icon.
  </Accordion>

  <Accordion title="Font settings">
    Adjust the interface and code font sizes to suit your display and preference.
  </Accordion>
</AccordionGroup>

## 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

<AccordionGroup>
  <Accordion title="ACP debug logs">
    Enable verbose logging of the Agent Communication Protocol stream. Useful for troubleshooting unexpected agent behavior. View the stream in the ACP Debug Panel (`/acp`).
  </Accordion>

  <Accordion title="Auto-open Git Changes">
    Automatically opens the Git Changes panel when an agentic session modifies files. Disabled by default.
  </Accordion>

  <Accordion title="Updates">
    Check for, download, and install in-app updates. Fabriqa Desktop checks for updates automatically and notifies you when one is available.
  </Accordion>

  <Accordion title="Global defaults">
    Set global defaults that apply to all workspaces, such as default agent behavior and feature toggles.
  </Accordion>
</AccordionGroup>

## 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.

<Tabs>
  <Tab title="Overview">
    Workspace name, root folder path, active session details, and the custom task file path override for the task runner.
  </Tab>

  <Tab title="Actions">
    View, add, and edit task definitions for the task runner. Changes are saved to `.fabriqa/tasks.json`.
  </Tab>

  <Tab title="Permissions">
    All saved allow/deny rules for tool use in this workspace. Rules can be individually removed or toggled.
  </Tab>

  <Tab title="Audit">
    Full chronological audit log of every tool call, permission decision, and agent action in this workspace.
  </Tab>

  <Tab title="Diagnostics">
    Health checks for workspace path access, provider connectivity, session state, and configuration validity.
  </Tab>
</Tabs>

## Changelog

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