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

# Fabriqa Desktop Documentation

> User guide for the Fabriqa Electron desktop app

Fabriqa Desktop App is the local, workspace-aware environment for serious AI coding workflows. This guide is focused on the desktop product experience and the features currently available today.

<Info>
  This documentation intentionally focuses on the Desktop App user journey: workspace setup, chat workflows, settings, and desktop-native capabilities.
</Info>

## What Fabriqa Desktop Is

<CardGroup cols={2}>
  <Card title="Workspace-first" icon="folder-open">
    Work directly in your project folders with persistent context and session continuity.
  </Card>

  <Card title="Agentic Chat" icon="sparkles">
    Run coding workflows through conversational threads with streaming output and tool activity.
  </Card>

  <Card title="Desktop-native" icon="desktop">
    Use features built for desktop usage such as global toggle hotkey, window pin, and in-app updates.
  </Card>

  <Card title="Governed Execution" icon="shield-check">
    Manage permissions, audit activity, and safety decisions from inside the app.
  </Card>
</CardGroup>

## Install And First Launch

<Tabs>
  <Tab title="macOS">
    Install Fabriqa Desktop App and open it from Applications. On first launch, the app initializes your local runtime and prompts you to select a workspace.
  </Tab>

  <Tab title="Windows">
    Install Fabriqa Desktop App and launch it from Start Menu or desktop shortcut. On first launch, choose your workspace folder and continue to chat setup.
  </Tab>

  <Tab title="Linux">
    Install Fabriqa Desktop App using the package format for your distro. Start the app, then choose a workspace to begin.
  </Tab>
</Tabs>

<Warning>
  If startup does not complete, use the troubleshooting section below to check workspace path validity, provider key setup, and update state.
</Warning>

## Open Your Workspace

<Steps>
  <Step title="Open the workspace selector">
    From the launch screen, choose an existing workspace or use the folder picker to open a new one.
  </Step>

  <Step title="Confirm workspace context">
    Verify the active workspace in the sidebar and ensure the folder you selected is the one you want the assistant to operate in.
  </Step>

  <Step title="Start your first chat">
    Enter a prompt from the welcome input to create your first chat in that workspace.
  </Step>
</Steps>

## First Chat

<Steps>
  <Step title="Send your prompt">
    Type your request and send it from the composer.
  </Step>

  <Step title="Watch streaming output">
    Follow response text, thinking, tool calls, and status as they appear in real time.
  </Step>

  <Step title="Interrupt when needed">
    Stop an in-flight response when direction changes, then continue with a refined prompt.
  </Step>
</Steps>

## Core Desktop Workflows

<CardGroup cols={2}>
  <Card title="Queue while streaming" icon="list-check">
    Add follow-up prompts while a response is still running. Fabriqa Desktop queues and executes them in order.
  </Card>

  <Card title="Cancel and steer" icon="hand">
    Interrupt a response and immediately provide a corrected instruction.
  </Card>

  <Card title="Chat tabs" icon="panel-top">
    Work across multiple chats in one workspace and keep draft context isolated per tab.
  </Card>

  <Card title="Fork conversations" icon="git-fork">
    Create a branch from a previous assistant message to explore alternate approaches.
  </Card>
</CardGroup>

## Settings Overview

<CardGroup cols={2}>
  <Card title="Providers" icon="key-round">
    Configure provider keys, default model/provider behavior, and preset preferences.
  </Card>

  <Card title="Appearance" icon="palette">
    Tune chat rendering mode, terminal output style, theme behavior, and sidebar preferences.
  </Card>

  <Card title="Changelog" icon="scroll-text">
    Review release notes directly inside the app.
  </Card>

  <Card title="Developer" icon="wrench">
    Control ACP debug logs, update actions, and global defaults such as auto-open Git changes.
  </Card>

  <Card title="Workspace Settings" icon="folder-cog">
    Manage workspace-scoped tabs: Overview, Actions, Permissions, Audit, and Diagnostics.
  </Card>
</CardGroup>

## Desktop-Only Features

<AccordionGroup>
  <Accordion title="In-app updates">
    Fabriqa Desktop checks for updates, downloads in the background, and lets you install when ready from in-app controls.
  </Accordion>

  <Accordion title="Always-on-top pin">
    Pin the window so Fabriqa Desktop stays visible while you work in other tools.
  </Accordion>

  <Accordion title="Global desktop toggle hotkey">
    Configure a system-wide shortcut to quickly show or hide Fabriqa Desktop.
  </Accordion>

  <Accordion title="Native folder picker">
    Open workspaces using the operating system folder dialog for a native workflow.
  </Accordion>
</AccordionGroup>

## Explore Features

<CardGroup cols={3}>
  <Card title="Window Management" icon="app-window" href="/features/window-management">
    Global hotkey, zen mode, always-on-top, and display controls.
  </Card>

  <Card title="Navigation & Search" icon="search" href="/features/navigation-and-search">
    Command palette, file search, slash commands, and tab navigation.
  </Card>

  <Card title="Chat & Conversations" icon="messages-square" href="/features/chat-and-conversations">
    Tabs, view modes, message navigation, forking, and streaming controls.
  </Card>

  <Card title="Panels & Layout" icon="layout-dashboard" href="/features/panels-and-layout">
    Dockable panels for terminal, git, timeline, debugging, and more.
  </Card>

  <Card title="Task Runner" icon="play" href="/features/task-runner">
    Run project tasks with VS Code and Fabriqa task file formats.
  </Card>

  <Card title="Git Integration" icon="git-branch" href="/features/git-integration">
    Diffs, branch tracking, and worktree-aware git panel.
  </Card>

  <Card title="AI & Agents" icon="sparkles" href="/features/ai-and-agent">
    Providers, presets, agent config, and tool permissions.
  </Card>

  <Card title="Settings" icon="settings" href="/features/settings-and-customization">
    Providers, appearance, themes, and workspace configuration.
  </Card>

  <Card title="Keyboard Shortcuts" icon="keyboard" href="/features/keyboard-shortcuts">
    Complete shortcut reference for all features.
  </Card>
</CardGroup>

## Workflow Guides

<CardGroup cols={2}>
  <Card title="Git Worktrees" icon="git-branch" href="/desktop/worktrees">
    Create isolated worktree chats for feature branches, experiments, and parallel work.
  </Card>

  <Card title="Multi-project Workspaces" icon="folders" href="/desktop/multi-project-workspaces">
    Attach multiple repos or folders to one workspace and start chats in the right project context.
  </Card>
</CardGroup>

## Workflow authoring

<CardGroup cols={2}>
  <Card title="Workflow DSL" icon="layout-dashboard" href="/workflows/workflow-dsl">
    Define custom workflows with phases, agents, artifacts, lifecycles, and document-first artifact rendering.
  </Card>

  <Card title="AI-DLC workflow" icon="zap" href="/workflows/ai-dlc">
    See how Fabriqa's built-in AI-DLC workflow is modeled and what the flow looks like from your perspective.
  </Card>
</CardGroup>

## Troubleshooting Quick Links

<CardGroup cols={2}>
  <Card title="Startup issues" icon="triangle-alert">
    Validate workspace path access, provider credential setup, and update/install state.
  </Card>

  <Card title="Hotkey unavailable" icon="keyboard">
    Choose a non-reserved shortcut and avoid key combinations blocked by system rules.
  </Card>

  <Card title="Streaming recovery" icon="activity">
    If a response is interrupted by refresh or temporary connectivity issues, retry from the active chat.
  </Card>

  <Card title="Permissions confusion" icon="shield">
    Review saved allow/deny rules in Workspace Settings and adjust scope as needed.
  </Card>
</CardGroup>