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

# Panels & Layout

> Use Fabriqa's dockable panel system to access the terminal, git changes, timeline, ACP debug, workflow designer, and more.

# Panels & Layout

Fabriqa Desktop uses a dockable panel system. Panels can be opened, closed, moved, and resized. They appear in four areas: left sidebar, main content area, right side pane, and bottom drawer. Every panel is accessible from the command palette or a slash command.

## Panel System Overview

* **Drag and drop** — panels can be repositioned between areas.
* **Resizable** — drag the dividers between pane areas to redistribute space.
* **Persistent state** — panel layout is saved per workspace and restored on relaunch.
* **Zen mode compatible** — use slash commands to open panels temporarily even in zen mode.

Open any panel from the chat composer using its slash command, or search for it in the command palette (`Cmd+Shift+P`).

## Panels Reference

<AccordionGroup>
  <Accordion title="Terminal — /terminal">
    An integrated terminal running in your workspace folder. Run shell commands, watch build output, and interact with running processes without leaving Fabriqa.

    * Inherits the workspace folder as the working directory.
    * Multiple terminal sessions are supported as sub-tabs within the panel.
    * Slash command: `/terminal`
  </Accordion>

  <Accordion title="Git Changes — /git">
    Shows the current git status of your workspace, organized into three groups:

    * **Staged** — files added to the index, ready to commit.
    * **Unstaged** — modified tracked files not yet staged.
    * **Untracked** — new files not yet tracked by git.

    Click any file to open a diff view. Toggle between **unified** and **split** diff modes from the panel header. A search field filters the file list. The panel header shows the current branch name and a status badge.

    Slash command: `/git`

    See [Git Integration](/features/git-integration) for full details.
  </Accordion>

  <Accordion title="Timeline — /timeline">
    Displays a chronological view of the active conversation, including:

    * All user and assistant messages.
    * Inline tool calls with input/output detail.
    * Timestamps and duration for each step.

    Use the filter controls to show only tool calls, only messages, or a combined view. Useful for reviewing what happened during a long agentic run.

    Slash command: `/timeline`
  </Accordion>

  <Accordion title="ACP Debug Panel — /acp">
    The ACP (Agent Communication Protocol) debug panel shows the raw stdin/stdout streams between Fabriqa and the underlying AI process. Use it to diagnose communication issues or inspect the exact messages being sent to and received from the model.

    Features:

    * **Real-time streaming** — messages appear as they arrive.
    * **Filtering** — show stdin, stdout, or both independently.
    * **Search** — filter the log by keyword.
    * **Pause / Resume** — freeze the stream to inspect a specific point without losing scroll position.
    * **Chat picker** — switch between ACP streams for different active chats.
    * **Pin chats** — pin specific chats to keep their stream visible.

    Slash command: `/acp`
  </Accordion>

  <Accordion title="Workspace Settings — /workspace-settings">
    A dashboard for the current workspace with five tabs:

    | Tab         | Contents                                       |
    | ----------- | ---------------------------------------------- |
    | Overview    | Workspace name, path, session info             |
    | Actions     | Custom action definitions for the task runner  |
    | Permissions | Saved allow/deny rules for tool use            |
    | Audit       | Full audit log of all tool calls and decisions |
    | Diagnostics | Workspace health and configuration diagnostics |

    Slash command: `/workspace-settings`
  </Accordion>

  <Accordion title="Audit Log — /audit">
    A dedicated view of every tool call, permission decision, and agent action in the current workspace. Entries include timestamps, tool name, input parameters, and the allow/deny outcome.

    Slash command: `/audit` (opens Workspace Settings on the Audit tab)
  </Accordion>

  <Accordion title="Specs Explorer & Artifact Viewer">
    Browse specification files and view AI-generated artifacts (documents, code files, structured outputs) produced during your sessions. The artifact viewer renders markdown, code, and structured content inline.

    Access via the sidebar activity bar or the command palette.
  </Accordion>

  <Accordion title="Workflow Designer — /workflow-designer">
    A visual canvas for designing multi-step agent workflows. Connect steps, define inputs and outputs, and orchestrate complex sequences without writing orchestration code manually.

    Slash command: `/workflow-designer`
  </Accordion>

  <Accordion title="Developer Console — Cmd+Shift+J">
    The in-app developer console for debugging frontend issues. Mirrors browser devtools console output inside Fabriqa Desktop.

    Shortcut: `Cmd+Shift+J` (macOS) / `Ctrl+Shift+J` (Windows / Linux)
  </Accordion>

  <Accordion title="Diagnostics — Cmd+Shift+D">
    A standalone diagnostics dashboard that shows connection status, configuration validity, provider reachability, and runtime health metrics.

    Shortcut: `Cmd+Shift+D` (macOS) / `Ctrl+Shift+D` (Windows / Linux)

    Slash command: `/diagnostics`
  </Accordion>

  <Accordion title="Usage — Cmd+U">
    Shows token usage statistics for the current session and workspace, including per-model breakdowns and cumulative totals.

    Shortcut: `Cmd+U` (macOS) / `Ctrl+U` (Windows / Linux)

    Slash command: `/usage`
  </Accordion>
</AccordionGroup>

## Layout Tips

<CardGroup cols={2}>
  <Card title="Focus mode" icon="maximize">
    Close all panels except the active chat to get a clean working environment. Reopen panels with slash commands when needed.
  </Card>

  <Card title="Side-by-side" icon="columns-3">
    Dock the Terminal and Git Changes panels side-by-side in the bottom area to watch build output and diffs simultaneously.
  </Card>

  <Card title="ACP + Timeline" icon="activity">
    Run the ACP Debug Panel and Timeline together to correlate protocol messages with conversation steps during debugging sessions.
  </Card>

  <Card title="Persistent layout" icon="save">
    Layout is saved automatically per workspace. Set up your ideal panel arrangement once and it restores every time you open that workspace.
  </Card>
</CardGroup>
