twinly. / Docs

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.

PermissionWhy Twinly asksSystem Settings path
ContactsTurns raw numbers into names, so approvals say Text Sarah? instead of a phone number.Privacy & Security ▸ Contacts
CalendarsReads your day and adds events (full access: it writes, not just reads).Privacy & Security ▸ Calendars
RemindersCreates reminders when you ask for one.Privacy & Security ▸ Reminders
MicrophoneRecords your voice-clone prompts and live meeting transcription.Privacy & Security ▸ Microphone
Speech RecognitionOn-device speech-to-text for calls and voice notes.Privacy & Security ▸ Speech Recognition
PhotosPicks the photos you ask it to share (text mom the beach photos).Privacy & Security ▸ Photos
Local NetworkLets 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.