# Granting permissions

Agents only reach for a capability when a task needs it — and they can only use what you've granted. Foxora groups capabilities into ones it can request right in the app, and ones only your operating system can hand out. You manage all of them in one place.

## The Permissions panel

Open Settings (⌘, / Ctrl+,) → Permissions. Each capability shows what it’s for, a live status dot where one is available, and an action that fits how that capability is granted on your system. Capabilities that don’t apply to your OS simply read “No setup needed.”

## Capabilities Foxora can request

These are requested right inside the app. Click Allow and your OS shows its own prompt; once granted, the status dot turns green and the row reads Allowed. If you previously denied one, the button becomes Open Settings so you can reverse it.

- Microphone — voice chat with your agent.
- Camera — tasks that need to see your camera.
- Notifications — agent updates and task completions.

> The prompt comes from your OSFoxora never fakes a permission. Clicking Allow simply triggers the real system prompt — the decision is always yours, made through your operating system.

## Capabilities your OS manages

Some capabilities are too powerful for an app to request — your OS reserves them for its own settings. Foxora can’t prompt for these, so instead it deep-links you straight to the exact pane with an Open Settings button, and explains why the agent would want it.

- Screen Recording — the computer agent sees your screen to act on it.
- Accessibility (control) — control mouse & keyboard so the agent can act for you.
- Automation — drive other apps to complete cross-app tasks.
- Full Disk Access — read & write files anywhere on your machine.

## It differs by operating system

The same capability is a different beast on each platform, so Foxora only shows what actually gates on your system:

- 01macOSThe strictest. Screen Recording, Accessibility, Automation, Input Monitoring, and Full Disk Access are all macOS privacy gates — Foxora deep-links each one to System Settings → Privacy & Security.
- 02WindowsMicrophone, Camera, and Notifications are requestable in-app and also link to Settings → Privacy. Screen capture and app control need no separate gate, so those rows read “No setup needed.”
- 03LinuxScreen Recording on Wayland is granted through a desktop portal; the mac-specific control gates don’t apply and show as no setup needed.

> Grant only what you're comfortable withYou never have to grant everything up front. Leave a capability off, and the first task that needs it will tell you — then you can grant it here in seconds. Approving an individual action is separate; see approving agent actions.
