Skip to manual
gluon

Desktop assistant

Get started and find your way around Gluon Desktop

Follow the welcome guide and Getting started, then use Chat, Knowledge, Memory, Settings, the bottom bar and the Develop menu.

Person on their own Mac

Gluon Desktop: your own knowledge workspace on your Mac. First start: a three-step welcome guide. After that: Chat is the home screen. Navigation: Chat, Knowledge and Memory in the sidebar, your conversations and skills under them, Settings at the bottom left. State: the bottom bar. Nothing here needs a server; Account links one when you want it.

Follow the welcome guide

The guide opens on the first start, until you finish or skip it. The three tabs at the top show where you are; each is a button, so you can jump between steps.

  1. Meet Gluon. Read what Gluon does, then press Let's get started. Press I'll explore first to skip the guide.
  2. Add knowledge. Pick A folder on your Mac (Markdown notes) or A connected app (an MCP server). The dialog is the same as on Sources, and its button reads Connect and read. Gluon adds the source and reads it at once. While it reads, the guide says "Reading your source…" and its buttons are off. If the read fails, the source stays added: the guide says so, and Manage sources opens Sources to try again. One source is enough; press Continue.
  3. Make it yours. The card says whether your chat model is ready ("Your chat model is ready") or not ("Choose a model to start chatting"). Choose a model opens AI connections. Screen awareness is explained here and stays off: adding a source does not turn it on. Under it, Getting started says whether you can ask now ("Ready to answer: you can ask now.") and lists four steps (below). Press Go to chat.

Go to chat and I'll explore first both mark the guide as finished. The next start opens Chat. If Gluon cannot save that choice, a message says the guide may appear again; you can still use the app.

Getting started

Four steps, each adding one thing. The first one not done leads, with a filled button; every step stays open to you.

StepDone whenButton
Connect a sourcea source is ready to answer (it has records, or a tool is on)Add a source
Get a first answera conversation is kept on the MacAsk now
Add a skillyou have a skill for answeringOpen skills
Look at memoryyou opened Memory onceOpen memory

Asking works once a source is ready and a chat model is chosen; the other two steps are optional.

Open the guide again

  • Settings › Getting started (the card opens the guide).
  • Until chat is ready to answer and all four steps are done, the sidebar shows a Getting started card ("n of 4 done") with Open setup guide.

The window

PartWhat it does
New conversationstarts a new conversation in Chat. On Chat it asks first, because it clears the conversation and the draft
Chatthe home screen: ask questions, see discoveries
Knowledgethe knowledge map and what Gluon discovered. A number beside it counts discoveries waiting for you
Memorywhat Gluon keeps on this Mac: correct it or wipe it
Recent chatsthe latest five conversations; All chats lists every one, with search and Delete (the trace)
My skillsyour skills for answering; pick one to use it in Chat (Skills)
Settingsthe cards below
Name and "On this Mac"bottom left. Press it to open Account. It reads Linked to host instead of On this Mac when you sign in
Top bar of each screenthe screen's name (All settings inside a settings card), and Back to chat. On Chat it shows how many sources are connected
Bottom barthe state of Gluon and of screen awareness (below)

Chat keeps your conversation and your unsent question while you open Settings or Knowledge. Come back to Chat and both are there. Every conversation is kept on the Mac; reopen it from Recent chats or All chats. Signing in as someone else, or signing out, starts a new conversation.

Right-click opens Gluon's own menus where they apply, such as Open, Rename and Delete on a chat. Elsewhere right-click does nothing; inside a text field, or over selected text, you get the usual menu with Copy, Paste and spelling.

Settings

Settings shows nine cards. All settings at the top left of a card returns to them (not on Memory and Getting started, which have their own place in the sidebar). Command-comma (menu Gluon › Settings…) opens Settings from anywhere.

CardOpensPage
Sourcesfolders, apps and databases Gluon readsAdd sources
Toolswhat your sources can be asked; turn tools onAdd sources
Skillshow Gluon handles one kind of questionSkills
Memorywhat Gluon keeps on this MacMemory
AI connectionsthe model for each job, and where it runsChoose the AI that answers and discovers
Accountlocal use, or your organisation's serverLink Gluon Desktop to your Gluon server
Privacy & storageapps never watched, and where files are keptSet up screen awareness and its controls
Screen awarenessthe helper, permissions and the Watching switchSet up screen awareness and its controls
Getting startedthe welcome guidethis page

Read the bottom bar

The bottom bar has two buttons. The left one is about Gluon, the right one about screen awareness. Each opens the screen where you fix it. While Gluon works in the background, a third item shows left of them (below).

Left buttonMeaningOpens
Connecting to Gluon…the first check is runningScreen awareness
Gluon is readya chat model is chosen and a source is ready to answerAI connections
Finish chat setupno chat model yet, or no source ready to answer yetAI connections
Local service unavailablethe service inside Gluon does not answer; restart Gluon, and see the log in ~/Library/Logs/com.gluon.desktopScreen awareness
Right buttonMeaning
Screen awareness offWatching is off, or the helper reports it is off. Nothing is read
Screen awareness unavailableGluon Assistant is not running, or its state cannot be read
Screen permission neededWatching is on, but macOS Accessibility is not granted to Gluon Assistant
Screen awareness onWatching, or an offer is showing
Screen awareness pausedWatching is on and something stops it, such as screen sharing. The blob names the reason

The left button opens AI connections whenever the service answers (also on Finish chat setup), and Screen awareness while it does not. The right button always opens Screen awareness. See the assistant blob for what each reason means.

See what Gluon is doing in the background

Gluon imports sources, reads them for discoveries and indexes passages on its own. While one of these runs, the bottom bar shows a turning circle and one line for the most important one, with "+n more" when more run. When nothing runs, the item is gone. With reduced motion turned on in macOS, the circle stands still. Click the item to see every run, each beside the logo of the source it reads.

LineWhat runs
Importing source · n read (or n of m)an import, started by you or by the automatic import every 30 minutes
Installing the document reader · n%the one-time install of the reader for Word, PDF and PowerPoint files
Reading the tables of sourcea database source's tables are read for discoveries after a sync
Discovering in source · n leftthe local model reads the records of an import for discoveries
Reading attachments · n leftattachments read before the document reader was installed are read again
Indexing · n of m passages leftpassages wait for the search model, so chat finds them by meaning

Press the item to see every run in a list, with a thin bar where the end is known. Open beside a source opens Sources. A source whose last import stopped shows here too, with the reason. Escape or a press outside closes the list.

Develop

Recognition Playground is for trying the recogniser; it is not part of daily use. Open it from the menu bar, Develop › Recognition Playground, or from Settings › Develop (a collapsed section; press Recognition playground). See Try the recogniser in the Playground.

Other states

  • Connecting to Gluon… in the top of the window: the app is reading its first state.
  • Could not check for discoveries, on Chat: the list of discoveries did not load. Press Try again.
  • Open this in the Gluon app on a screen: the page is open in a browser tab, which has no local service.
The first step of the welcome guide with the three step tabs, the three feature tiles and the Let's get started button.
The welcome guide, step 1: meet Gluon.
The second step of the welcome guide with a folder choice and a connected app choice.
Welcome guide step 2: a folder on your Mac or a connected app.
The third step of the welcome guide asking to choose a model to start chatting, explaining screen awareness, and the start of the Getting started list.
Welcome guide step 3: the chat model, screen awareness and Getting started.
The Settings screen with cards for Sources, Tools, Skills, Memory, AI connections, Account, Privacy and storage and Screen awareness.
Settings: a card for each part of Gluon; Getting started and the collapsed Develop section sit below the fold.
The bottom bar reading Local service unavailable, with Screen awareness unavailable beside it.
The bottom bar when the local service does not answer.
The bottom bar reading Screen awareness paused.
The bottom bar while screen awareness is paused by screen sharing.