Install and sign in
Could not reach on first run
Could not reach on first run
Check the address (for example
chat.xpander.ai, or your company’s), your network, and your VPN for a self-hosted xpander, then choose Try again.Sign-in finished in the browser but the app did not open
Sign-in finished in the browser but the app did not open
The app is not registered for sign-in links yet, usually because it was never opened from Applications. Paste the code the browser shows into the app under Sign-in code and choose Continue. The code works once and expires after a minute. If it expired, choose Open the browser again.
The browser says Omni Desktop is not available
The browser says Omni Desktop is not available
Your organization’s Desktop policy is off for you. Ask an admin to turn it on.
macOS permissions
The keychain asks for access
The keychain asks for access
The app keeps your session in the macOS keychain. If macOS asks to allow xpander.ai Safe Storage, enter your Mac password and choose Always Allow.
Voice input records nothing
Voice input records nothing
macOS asks once whether Omni may use the microphone. If you chose Don’t Allow, open System Settings > Privacy & Security > Microphone, turn Omni on and restart the app.
Computer control cannot see the screen or click
Computer control cannot see the screen or click
In Settings > Computer control, check that Screen Recording and Accessibility both read on. Screen Recording takes effect only after Reopen Omni. If a permission is on in System Settings but off in the app, remove Omni (
xpander.ai) from that list in Privacy & Security with the minus button, then choose Allow again. See Computer control.Connection
The status says Mac offline
The status says Mac offline
Check your network and the address in Settings. The app retries on its own. See When the app cannot reconnect.
The status says Mac turned off or Mac removed
The status says Mac turned off or Mac removed
An admin turned Omni Desktop off for you or revoked this computer, or it was forgotten in Settings. After a revoke, sign in again to register the computer as a new device.
What agents can do
An agent says a folder is not trusted
An agent says a folder is not trusted
Trust it in Settings or the composer with the access the agent needs, or answer the agent’s request. Outside what your organization allows means your policy does not allow it.
An agent cannot write a file or run a command
An agent cannot write a file or run a command
Check the folder’s access (Read and write is needed to change files), whether your policy is read only or has the shell off, and your switches in Settings > Shell & files. The computer strip shows Shell on when commands are allowed. If you chose Not now at Run a command? or Write a file?, ask the agent to try again.
The agent does not use my browser or my computer
The agent does not use my browser or my computer
- The ability may be Not allowed by your organization, or off in your own Settings > Shell & files. See Your switches.
- Prefer this Mac’s browser or Prefer this Mac’s files and apps may be off, so agents start in the cloud. Ask the agent to use this computer, or turn the switch back on.
- You may have chosen Not now in this conversation. Ask the agent to try again, and allow it when the app asks.

