Skip to main content
The Glean Desktop App for macOS is designed to provide chat-first access to the Glean Chat Assistant from anywhere on your machine. This experience is delivered via the following components:
  • Quick entry for Glean Chat Assistant: The universal shortcut (⌘+⇧+J by default) that launches a search bar can be configured to default to a Glean Chat Assistant. spotlight-chat-first
  • Quick Chat: A dedicated, assistant floating window that always stays on top of all other applications. It provides a persistent, uninterrupted space for conversations with the Glean Chat Assistant.
  • Chat with Screenshot: The ability to attach a screenshot directly to your query within the Companion Chat, giving the Assistant visual context for faster, more accurate answers. ask-assistant

Configuration and customization

All features are managed from the Desktop App settings panel.

Step 1: Access settings

  1. In the Glean application, click the Glean icon (bottom-left) and then click Your settings. settings-assistant
  2. Click the Desktop app section.

Step 2: Define Quick Entry behavior

Configure the shortcuts and default modes for quick entry.
  1. In the Quick Entry > Quick entry shortcut field specify the key combination for the the Quick entry shortcut (e.g., ⌘+⇧+J).
  2. Set the Default mode: for the Quick entry shortcut:
    • Chat: Launches the interface directly into the Assistant chat composer (recommended).
    • Search: Launches the Glean Chat Assistant in the Glean application.
  3. In Open new chats, select the default destination for all new chat queries:
    • In Quick Chat: Launches the conversation in the persistent floating window.
    • In Main Window: Launches the conversation in the Glean application window.

Step 3: Define Quick Chat behavior

  1. In the Quick Chat > Companion Chat shortcut: field specify the key combination for the Companion chat shortcut (e.g., ⌃+⇧+G).
  2. Set the default Quick chat behavior.
    • Toggle window
    • Open new window

Step 4: Provide permissions for Screen Capture

  1. Under Permissions, toggle on Screen Capture to enable the Chat with Screenshot feature.
Once configured, the feature is immediately accessible via the shortcut. Note: After making changes to the settings, you may need to quit and relaunch the app for the new configuration to take effect.

Usage

Access Chat Assistant from anywhere

  • Quick Entry: Press the defined Quick entry shortcut (⌘+⇧+J) to instantly launch the chat composer and submit your query.
  • Quick Chat: Press the defined Companion chat shortcut (⌃+⇧+G) to launch the floating Assistant window.

Attach visual context

  1. Open the Quick Chat window.
  2. Click the Screenshot button (camera icon) in the chat composer. The captured screenshot attaches directly to your query, providing visual context to the Assistant.
I