PermissionGuide

Guided permission setup for macOS apps. PermissionGuide opens the right System Settings pane, dims everything but the list, and docks a panel beside it with your app's icon to drag in. When macOS reports the grant, your app comes back to the front.

import PermissionGuide

let permissions = PermissionManager()

if await permissions.request(.fullDiskAccess).isGranted {
    // granted
}

It covers Full Disk Access, Accessibility, Screen Recording, Input Monitoring, Bluetooth, Developer Tools, App Management, system extensions and SMAppService background items. It can also add a Set Up section to your .pkg installer.

Use it with your agent

Paste this into your coding agent:

Add PermissionGuide (https://github.com/fcjr/PermissionGuide) to this app. Read https://raw.githubusercontent.com/fcjr/PermissionGuide/main/llms.txt first, then build a permissions screen for the permissions my app needs, showing each one's status with a Grant button. If you are unsure which permissions we need, ask me.

Add it

.package(url: "https://github.com/fcjr/PermissionGuide.git", from: "0.1.0"),

Requires macOS 14 and a signed .app without the App Sandbox.

Guide · Installer panes · How it works · Examples

Try it

just demo       # build and open PermissionGuideDemo.app
just demo-pkg   # build and open InstallerDemo.pkg

MIT.