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

# Collate Desktop

> The Collate Desktop app gives you native Mac and Windows access to the Collate AI experience.

# Collate Desktop

Collate Desktop is a dedicated app for macOS and Windows that puts your whole Collate workspace, Home, Explore, Governance, AI Analytics, and more, on your desktop, no browser tab required. It opens your hosted Collate instance directly and adds native touches like deep links, a global command palette, and desktop notifications.

<Card title="Download Collate Desktop" icon="download" href="http://collate-desktop.getcollate.io/" horizontal>
  Get the macOS or Windows installer.
</Card>

## Key Features

Collate Desktop opens your hosted Collate instance in a native window, so every area of the product looks and works the same as it does in the browser.

### Home

Your home dashboard surfaces platform health, pending approvals, announcements, and recommended improvements as soon as you open the app.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/home-dashboard.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=9730e7732a9657634113afef483221dc" alt="Home dashboard with platform health and pending approvals" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/home-dashboard.png" />

### Explore Your Catalog

Browse databases, dashboards, pipelines, and every other asset in your data estate, with filters for domain, owner, tag, and tier.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/explore-assets.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=f358d37d9e568ff436411ddbc1b3c981" alt="Explore Assets page showing the catalog browser" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/explore-assets.png" />

### Connections

View and manage every connected service across your data platform from one screen.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/connections.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=5d088e1875595c63f617f65e200c0ce5" alt="Connections page listing connected services" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/connections.png" />

### Governance

Manage glossary terms, classifications, and metrics that keep your data estate consistent and compliant.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/governance-glossary.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=996fd8f6b64637934a78a052ae259b28" alt="Governance glossary showing Data Privacy and PII terms" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/governance-glossary.png" />

### Observability

Monitor data quality with test case results, data health scores, and dimension-level breakdowns like accuracy and completeness.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/data-quality-observability.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=a08d60f51499bc6b8c756c1a1bd7303b" alt="Data Quality observability dashboard" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/data-quality-observability.png" />

### AI Analytics

Create and browse dashboards built with Collate AI, from high-level summaries down to chart-level detail.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/ai-analytics-dashboards.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=e21c828adc35fa146507966b20a55efb" alt="AI Analytics dashboard gallery" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/ai-analytics-dashboards.png" />

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/ai-analytics-dashboard-detail.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=fb5c9412c0d9c7d9c4691cf33ea77250" alt="AI Analytics dashboard detail view" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/ai-analytics-dashboard-detail.png" />

### AI Automations

Automate routine data work with agents that document, test, and classify your data on a schedule.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/ai-automations.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=6a5dcc0de6e1b8f9b7414b3098f0c590" alt="AI Automations page listing automation templates and runs" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/ai-automations.png" />

### Data Marketplace

Discover trusted data products and domains, and track data access requests from one place.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/data-marketplace-overview.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=cf718e50505051d5b9df68e9ce31eb20" alt="Data Marketplace overview with data products and domains" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/data-marketplace-overview.png" />

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/data-marketplace-access-request.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=ebeca03038a4f908257312e0eccd99b3" alt="Data Marketplace access request detail panel" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/data-marketplace-access-request.png" />

### Context Center

Keep your knowledge base close at hand, with articles, documents, and memories the AI can reference.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/context-center-dashboard.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=9e0644bcf956d57d0cf0bdd0e9e67762" alt="Context Center dashboard showing articles, documents, and memories" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/context-center-dashboard.png" />

### AI Studio

Build and manage the AI agents that power your automations and AI chat experience.

<img src="https://mintcdn.com/collatedocs/TbSXPuFDM1WXNKIC/public/images/ai-2.0/collate-desktop/ai-studio-agents.png?fit=max&auto=format&n=TbSXPuFDM1WXNKIC&q=85&s=2ed552c07ebdd68ad88a60b63a8f5960" alt="AI Studio agents list" width="3840" height="2160" data-path="public/images/ai-2.0/collate-desktop/ai-studio-agents.png" />

## Key Capabilities

### Deep-Link Protocol (`collate://`)

Collate Desktop registers the `collate://` link type on your computer. Deep links let any app, notification, or message open a specific view in Collate Desktop with a single click. Supported deep-link actions include:

* **Chat prompts**: `collate://chat?prompt=<your-question>` opens Collate AI Chat with a question already filled in.
* **Asset FQNs**: `collate://asset?type=table&fqn=<fqn>` opens the detail page for any data asset by its Fully Qualified Name.
* **Search**: `collate://search?query=<query>` opens the Explore page with a search term already filled in.
* **Notifications**: `collate://notify` lets the web app send native desktop notifications that link back to the relevant activity or task.
* **Auth callbacks**: SSO redirects route through `collate://auth-callback?url=<encoded-url>` so browser-based SSO flows finish inside the app.

### Global Command Palette

Press `Cmd+Shift+Space` (macOS) or `Ctrl+Shift+Space` (Windows) from anywhere on your desktop to open the Collate AI Chat command palette. Enter a question, paste an asset name, or enter a `collate://` deep link. No window switching or browser tab required.

### Native Menus and System Tray

Collate Desktop includes a native menu bar (macOS) and system tray icon (Windows and macOS) for quick access to common actions, recent searches, and notification summaries.

### File Associations

Collate Desktop registers as the default handler for the following file types:

| Extension        | Use case                                                                          |
| ---------------- | --------------------------------------------------------------------------------- |
| `.sql`           | Open SQL files and send them to Collate AI Chat for explanation or lineage lookup |
| `.yaml` / `.yml` | Open connector configuration files for review                                     |
| `.json`          | Open JSON schema or metadata export files                                         |
| `.csv`           | Open CSV exports from Collate's bulk operations                                   |

### Automatic Updates

Collate Desktop checks for updates automatically in the background. When a new version is available, an in-app prompt appears at the bottom of the window. Select **Install Update** to apply the update and restart the app. Updates are silent and do not require you to sign in again.

### Native Browser-Based SSO

Collate Desktop handles SSO by opening your organization's login page in the system browser. After sign-in, the browser redirects to `collate://auth-callback`, which hands control back to the desktop app and stores the session securely.

## Installation

Download Collate Desktop from [collate-desktop.getcollate.io](http://collate-desktop.getcollate.io/). Installers are available for both macOS and Windows.

| Platform | Installer type                                              |
| -------- | ----------------------------------------------------------- |
| macOS    | `.dmg` (universal binary, works on Intel and Apple Silicon) |
| Windows  | `.exe` installer                                            |

#### macOS

1. Download the `.dmg` file.
2. Open the `.dmg` and drag the Collate app to your Applications folder.
3. Launch Collate from Applications or Spotlight.

#### Windows

1. Download the `.exe` installer.
2. Run the installer and follow the prompts.
3. Collate Desktop appears in your Start Menu and system tray after installation.

## Connecting to Your Collate Instance

On first launch, Collate Desktop prompts you to enter your organization's Collate workspace URL.

1. Enter your workspace URL in the format `https://<your-org>.getcollate.io`.
2. Select **Connect**.
3. Sign in using your organization's SSO provider. The login page opens inside the app.
4. After you sign in, Collate Desktop takes you to your home screen.

Your workspace URL and session are remembered across restarts. To switch workspaces, go to **Settings** > **Workspace** inside the app.

## Using the Command Palette

The global command palette is the fastest way to use Collate AI Chat from anywhere on your desktop.

1. Press `Cmd+Shift+Space` (macOS) or `Ctrl+Shift+Space` (Windows) from any application.
2. The Collate AI Chat command palette appears in the foreground.
3. Enter a question (for example, "What is the customers table used for?"), paste an asset name, or paste a `collate://` deep link.
4. Press Enter to submit.

The command palette doesn't require Collate Desktop to be the active window. Trigger it from any application, including your BI tool, SQL editor, or terminal.

## Deep Links

Use `collate://` deep links to navigate directly to specific views in Collate Desktop from external sources such as Slack messages, emails, Jira tickets, or CI/CD notifications.

### Open a Collate URL

```
collate://open?url=https%3A%2F%2Facme.getcollate.io%2Ftable%2F...
```

Opens any Collate URL inside the desktop app. URL-encode the `url` parameter.

### Open a Chat with a Pre-Filled Prompt

```
collate://chat?prompt=What+is+the+monthly_revenue+table+used+for
```

Encodes the question as a URL query parameter. Encode spaces as `+` or `%20`.

### Open an Asset by Fully Qualified Name

```
collate://asset?type=table&fqn=snowflake.prod.public.customers
```

Use the asset's type (for example, `table`, `dashboard`, or `pipeline`) and its Fully Qualified Name as query parameters.

### Open a Search

```
collate://search?query=customer+revenue
```

Opens the Explore page with the search term pre-filled.

### Open Preferences

```
collate://open-preferences
```

Opens the Settings screen inside the app. Equivalent to pressing `Cmd+,` on macOS.

### Auth Callback

```
collate://auth-callback?url=https%3A%2F%2Facme.getcollate.io%2F...
```

Used internally by the SSO flow. Collate Desktop constructs and handles this URL automatically during sign-in.
