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

> ## Agent Instructions
> Ve is a desktop browser for macOS. Steps on these pages are carried out inside Ve itself, not on a website, and there is no web version.
> Settings paths are written as `Settings > Section`.

# Grant macOS permissions

> Give Ve the macOS privacy access a tool needs, and read what each status actually means.

Ve asks macOS for nothing at startup. You grant what a tool needs when it needs
it, from Settings.

There is a second, shorter list under `Settings > Shortcuts` covering the three
permissions the Fn key needs. The list below is the full one.

## Finding the list

Click your profile in the sidebar, then **Settings**, then **Privacy**. The list
sits at the end of that page under **Developer permissions**.

Use it when something you run from Ve, such as a command line tool or an
automation script, needs macOS privacy access. Those tools inherit whatever Ve
itself has been granted.

## What each permission covers

| Permission       | Covers                                                                            |
| ---------------- | --------------------------------------------------------------------------------- |
| Microphone       | Voice input, transcription, audio recording, and the sox, ffmpeg and Whisper CLIs |
| Camera           | Webcam capture and camera-driven local test apps                                  |
| Screen Recording | Screenshot, visual automation and UI inspection tools                             |
| Accessibility    | Keystroke injection, window control and UI automation tools                       |
| Full Disk Access | Projects, worktrees or symlinked files that touch macOS-protected folders         |
| Automation       | Apple Events for scripts that control other local apps                            |
| Local Network    | Discovery and access for development servers on your network                      |
| USB Devices      | Hardware debugging and device tools that talk to USB devices                      |
| Bluetooth        | Bluetooth device tools and local hardware experiments                             |

## Reading the status

Each row carries a status pill. It says **Checking** while Ve resolves it, then
settles on one of these.

| Status            | Means                            |
| ----------------- | -------------------------------- |
| Granted           | Ve confirmed the access is on    |
| Denied            | Ve confirmed the access is off   |
| Check in Settings | Ve could not determine the state |

<Note>
  **Check in Settings** is not a way of saying no. It means Ve has no
  trustworthy signal for that permission, so it declines to guess. Ve never
  shows a grant it has not confirmed.
</Note>

Where the signal comes from decides how many rows can ever say Granted.

| Permission                      | Status source                                                  |
| ------------------------------- | -------------------------------------------------------------- |
| Camera, Microphone              | The browser's own permission state, which is real on this page |
| Accessibility, Screen Recording | Ve asks macOS directly                                         |
| Everything else                 | No source, so the row stays on Check in Settings               |

Microphone has a macOS check behind it as well, used when the browser cannot
answer. An undecided browser permission reads as Check in Settings rather than
as a grant.

## What the button does

| Permission                                      | Button        | What happens                                                                                                                         |
| ----------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Microphone                                      | Request       | macOS asks you the first time. If you refused before, Ve opens the Microphone pane. If you already said yes, the button does nothing |
| Accessibility                                   | Request       | macOS shows its own trust prompt, which carries an Open System Settings button                                                       |
| Screen Recording                                | Open Settings | macOS asks the first time, otherwise Ve opens the Screen Recording pane                                                              |
| Camera, Full Disk Access, Automation, Bluetooth | Open Settings | Opens that exact pane in System Settings                                                                                             |
| Local Network, USB Devices                      | Open Settings | Opens Privacy and Security, because macOS offers no direct link to these two                                                         |

<Warning>
  macOS never lets an app grant itself Accessibility. The Request button can
  only put the prompt in front of you. You flip the switch in System Settings.
</Warning>

## Keeping the list current

Flip something in System Settings and come back to Ve, and the statuses
re-resolve on their own. **Refresh** at the top of the section does the same
thing on demand.

## Related

* [Manage your account and workspace](/account)
* [Chat with Ve](/chat)
* [Bring your data across](/import)