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

# Computer control

> On a Mac, an agent can see your screen and use the mouse and keyboard to work in your apps. You allow it once per chat, a bar shows while it is in control, and Stop or Control-Option-Escape ends it at once.

When your organization's [Desktop policy](https://docs.xpander.ai/desktop/admin.md#desktop-policy) allows **Computer control**, an agent in a conversation you started from the app can take screenshots of your screen, open apps, click, scroll and type, the way you would. Use it for work that only exists in an app on your Mac, such as a design app, a desktop client or a settings screen.

Computer control is available on macOS only.

## Give the app the macOS permissions

macOS asks you to allow two permissions for **Omni** in System Settings > Privacy & Security:

| Permission | Why the app needs it |
| - | - |
| **Screen Recording** | Lets an agent see your screen while you allow it to control your Mac. |
| **Accessibility** | Lets an agent use the mouse and keyboard while you allow it. |

The app opens a sheet, **Allow Omni on this Mac**, when you sign in, when your organization turns computer control on, and when an agent needs a permission that is off. For each permission, choose **Open System Settings** and switch **Omni** on. The sheet updates as you do.

![Allow Omni on this Mac sheet with Screen Recording and Accessibility rows, each with Open System Settings, and Not now](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/computer-permissions.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=924a253942e6d8d6ec3d43e37a776d51)

The macOS permissions computer control needs. Shown with sample data.

macOS applies Screen Recording only after the app reopens: choose **Reopen Omni** when the sheet offers it. While a permission is off, the sidebar shows how many Mac permissions are off; click it to open the same rows in [Settings](https://docs.xpander.ai/desktop/settings.md) > **Computer control**.

If a permission is switched on but still does not work, remove **Omni** from the list in Privacy & Security with the minus button, then choose **Allow again**.

## Allow it for a chat

Every conversation asks before an agent takes control the first time. The app asks **Let the agent control your Mac?**:

| Choice | What it means |
| - | - |
| **Not now** | The agent continues without your screen. |
| **Only this session** | Allowed in this conversation until it ends, you press Stop, or you quit the app. |
| **Always for this chat** | Allowed in this conversation from now on, also after the app restarts. |

![Let the agent control your Mac? dialog with Not now, Only this session and Always for this chat](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/computer-consent.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=20b73d4c4c35849f054b208042338ca4)

Each conversation asks before an agent takes control. Shown with sample data.

Allowing one conversation never allows another.

## While the agent is in control

A bar at the top of your screen reads **Omni is controlling your Mac**. It stays on top of every window and is hidden from the agent's own screenshots.

![Dark bar reading Omni is controlling your Mac, Esc to stop, with a Stop button](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/computer-control-bar.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=072bfcba3cddee2026b88b625fa1e9b6)

The bar at the top of the screen while an agent is in control. Shown with sample data.

To end control at once, choose **Stop** on the bar or press **Esc** anywhere; **Control-Option-Escape** works too. After a Stop, the conversation asks again before the agent can take control, even if you chose **Always for this chat**. You can also switch **Computer control** off in [Settings](https://docs.xpander.ai/desktop/settings.md): while an agent is in control, the switch there reads **Stop**.

The agent never acts on xpander's own windows and never types into a password field. When it needs a password, it asks you to type it yourself.

## When the agent asks you something

An agent in control may need a choice or a detail from you. The bar changes to **Omni has a question** and shows the question with its options, or a **Reply** field and **Send**. A notification shows the same question, and you can answer from the notification's buttons or its reply field without switching windows.

![Bar reading Omni has a question, with the question, three option buttons, a Reply field and Send](https://mintcdn.com/xpanderai-099931d1/5kO48nCPjVxjKi_K/images/desktop/computer-control-question.png?fit=max\&auto=format\&n=5kO48nCPjVxjKi_K\&q=85\&s=27b10c0d56dd622cbd4005358bcb26c3)

A question from the agent, on the bar. Shown with sample data.

## Screenshots

The agent works from screenshots of your screen. When your organization's policy has **Keep screenshots** on (the default), the screenshots an agent took show in the conversation's activity, so you can see what it saw. With it off, the agent still sees them, but they are not kept.

## Limits

* An agent can take up to 60 actions a minute on your Mac.
* Your organization can limit computer control to certain apps. An agent that tries another app is told your organization does not allow it.
* The [audit log](https://docs.xpander.ai/use/agents/audit.md) records where each action landed, never what was typed or seen on screen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.