> ## 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 an app conversation can take screenshots, open apps, click, scroll and type, for work that only exists in an app on your Mac, such as a design app, a desktop client or a settings screen. macOS only.

## Give the app the macOS permissions

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 **Allow Omni on this Mac** sheet appears when you sign in, when your organization turns computer control on, and when an agent needs a permission that is off. Choose **Open System Settings** for each and switch **Omni** on.

![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.

Screen Recording applies only after the app reopens: choose **Reopen Omni** when offered. While a permission is off, the sidebar shows how many are off, linking to [Settings](https://docs.xpander.ai/desktop/settings.md) > **Computer control**. If a permission is on but does not work, remove **Omni** from the Privacy & Security list with the minus button, then choose **Allow again**.

## Allow it for a chat

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

| 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 above every window and is hidden from the agent's 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.

**Stop** on the bar, **Esc** anywhere, or **Control-Option-Escape** ends control at once. After a Stop, the conversation asks again, even with **Always for this chat**. Switching **Computer control** off in [Settings](https://docs.xpander.ai/desktop/settings.md) also works. While an agent is in control, that switch reads **Stop**.

The agent never acts on xpander's own windows and never types into a password field. It asks you to type passwords yourself.

## When the agent asks you something

The bar changes to **Omni has a question**, with options or a **Reply** field and **Send**. A notification shows the same question, and you can answer from it directly.

![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

With **Keep screenshots** on in your organization's policy (the default), the agent's screenshots show in the conversation's activity. Off, the agent still sees them, but they are not kept.

## Limits

* 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 it is not allowed.
* The [audit log](https://docs.xpander.ai/use/agents/audit.md) records where each action landed, never what was typed or seen.


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