Desktop Connectors
Desktop Connectors run on each person's own computer, inside the Optima desktop app, using that person's own access. They let the AI work with local files, folders and tools.
They are installed on the Gateway like any other Connector, but their tools run on the person's computer, not on the Gateway.
Setting Them Up
To make a Desktop Connector available to people:
- On the Gateway, install the Connector from the marketplace. See Installing a Connector.
- Give it to people. Grant it to the Assistants that need it, and on each one turn on Connectors that run on the person's device, under Also allow. Without an Assistant, people chatting with a model directly can use it too.
- On each computer, the person installs the Connector runtime once, from Settings → Connectors in the desktop app — or when the app first offers it. See Using Tools.
Desktop Connectors do not appear in web or mobile chat, to the API, or in Scheduled Tasks: none of them has a computer to run on. Optima Chat on a desktop without the runtime does not offer them either.
The Desktop Connectors
The following Desktop Connectors are available:
| Connector | What it does |
|---|---|
| Workspace Read | Lists folders, finds files and reads them |
| Workspace Write | Writes files and runs shell commands. Grant with care |
| Local Git | Inspects and changes git repositories |
| SQLite | Finds and queries SQLite databases |
| Archives | Lists and extracts zip and tar archives |
| System Diagnostics | Reports CPU, memory, disks, battery and network health |
These need no credentials. A Desktop Connector can carry a key — for example, for a local service. In that case you add it on the Gateway as for any Connector, and Optima will hand it to the person's computer only for the moment a tool runs.
Safeguards
Desktop tools act with the person's own access to their computer, so Optima Chat keeps them in check:
- A Workspace — the folder a conversation works in. Tools that say which files they use will ask before touching anything outside it.
- Read before write — a tool may only change an existing file the AI has read in that conversation, so it cannot overwrite work it has not seen.
- Permission prompts — an Assistant can be set to ask before a tool runs. On the Assistant's Tools tab, tick The assistant must ask permission to use this connector, or ask before specific tools such as Write file.
- Tool activity — the desktop app keeps a record of every tool call, in Settings → Tool activity.
See Using Tools for what people see.
Warning
A Workspace is a safeguard, not a lock. A tool that runs shell commands, such as those in Workspace Write, can reach anything the person can. Grant it only to Assistants that need it, and consider making them ask first.
Environment Variables
Desktop tools see only a small set of the computer's environment variables. Each person can allow more in Settings → Connectors → Environment variables for tools — by default SSH_AUTH_SOCK, so that git can use their SSH agent. The Gateway's own list does not apply to desktops.