Docs · 04
Permissions
A twin that texts, calls, and works your Mac for you needs real access. Here is every permission, what it actually unlocks, the exact System Settings path, and the one-click way to grant them all at once.
01The fast way: Set everything up
Open Twinly's Access tab and click Set everything up. Twinly requests every permission it needs in one guided pass and opens the correct System Settings pane for each, so you just flip toggles. This is the recommended path; the rest of this page explains each grant if you want to understand or change one individually.
To confirm you are fully set, open the Showcase tab. Its readiness panel runs live checks and tells you exactly what is missing.
02How macOS permissions work
macOS protects sensitive capabilities behind per-app permissions (the system Apple calls Privacy & Security). Some show a prompt the first time Twinly needs them; a few are silent panes you must visit yourself, where the app can only point you to the right place. The one-click setup handles both.
Paths below are for current macOS. On older versions the pane names are close enough to find (System Settings was System Preferences; Screen & System Audio Recording was Screen Recording).
03Screen & System Audio Recording
Path: System Settings ▸ Privacy & Security ▸ Screen & System Audio Recording ▸ enable Twinly.
- Why: this is how the twin sees the screen while it works your Mac, and how it captures audio for phone calls. Your cloned voice is captured from the system output during a call, so calls literally cannot speak without it.
- When: Twinly triggers the system prompt the first time it needs the screen; flip the toggle, then approve the quit-and-reopen dialog once.
04Accessibility
Path: System Settings ▸ Privacy & Security ▸ Accessibility ▸ enable Twinly.
- Why: clicking, typing, pressing shortcuts, reading on-screen controls, and arranging windows all go through the macOS accessibility system. Without it, the twin can look but cannot touch.
- When: prompted on first use; you can also add it manually with the + button in that pane.
05Full Disk Access
Path: System Settings ▸ Privacy & Security ▸ Full Disk Access ▸ + ▸ select Twinly (or drag the app in) ▸ enable.
- Why: your Messages history lives in a protected place on disk. Full Disk Access lets the twin read your real threads so it can text people the way you actually text them, and find context like what someone asked you last week.
- When: this is one of the silent ones, macOS never prompts for it. Open the pane and add Twinly yourself, or let the one-click setup take you there.
06Automation (controlling other apps)
Path: System Settings ▸ Privacy & Security ▸ Automation ▸ Twinly ▸ enable each app it drives.
- Why: sending an iMessage, moving a Mail message, or steering Safari works by letting Twinly control those apps. macOS asks per target app (Twinly wants to control Messages), so expect a small burst of prompts the first week.
- When: prompted the first time the twin drives each app.
07The ones with a simple prompt
These all show a normal system prompt the first time the twin needs them. Approve once and forget; the path is listed in case you want to flip one later.
| Permission | Why Twinly asks | System Settings path |
|---|---|---|
| Contacts | Turns raw numbers into names, so approvals say Text Sarah? instead of a phone number. | Privacy & Security ▸ Contacts |
| Calendars | Reads your day and adds events (full access: it writes, not just reads). | Privacy & Security ▸ Calendars |
| Reminders | Creates reminders when you ask for one. | Privacy & Security ▸ Reminders |
| Microphone | Records your voice-clone prompts and live meeting transcription. | Privacy & Security ▸ Microphone |
| Speech Recognition | On-device speech-to-text for calls and voice notes. | Privacy & Security ▸ Speech Recognition |
| Photos | Picks the photos you ask it to share (text mom the beach photos). | Privacy & Security ▸ Photos |
| Local Network | Lets the iPhone companion app find and pair with your Mac. | Privacy & Security ▸ Local Network |
08Notifications
Path: System Settings ▸ Notifications ▸ Twinly ▸ Allow notifications, banner style.
Approvals arrive as real notifications with the draft quoted in the banner (Text Sarah? · On my way). If notifications are off you can still approve from the app or the island, but the hands-off flow is the whole point.