Permissions

First launch asks for every permission Twinly uses on one screen with Set up all, and needs at most one restart. Anything you skip can be granted later from the Access screen with Set everything up, which opens the correct System Settings pane for each so you just flip toggles.

When a task needs something you have not granted, Twinly shows its own card first, saying what it needs and why, instead of a surprise macOS pop-up halfway through.

macOS protects sensitive capabilities behind per-app permissions in 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 setup handles both.

Path: System Settings ▸ Privacy & Security ▸ Screen & System Audio Recording ▸ enable Twinly.

• Why: this is how the twin sees the screen while it works in your apps, and how it hears the other side of a phone call (the call's audio comes from Chrome).
• When: asked for at setup or the first time the twin needs the screen. macOS asks you to quit and reopen Twinly once after you turn it on.

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 the twin works an app on screen, it moves your real pointer and types with your keyboard, so leave the Mac alone during those steps. Work in its own background browser does not touch your pointer.

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 texts people the way you actually text them, finds context like what someone asked you last week, and notices when someone texts @twinly.
• When: this is one of the silent ones; macOS never prompts for it. The setup takes you to the pane.

Path: System Settings ▸ Privacy & Security ▸ Automation ▸ Twinly ▸ enable each app it drives.

• Why: sending an iMessage, moving a Mail message, or steering a browser works by letting Twinly control those apps. macOS asks once per app (“Twinly wants to control Messages”).
• When: at setup, or the first time the twin drives each app.

These show a normal system prompt the first time. Approve once and forget; the path is listed in case you want to change one later.