Permissions

Last updated October 12, 2026

macOS asks you to approve each of these individually, in its own system dialog, the first time UnIdle actually needs it — never all at once, and never before you've turned on the feature that needs it. This page lists every one UnIdle can ask for, why, and exactly what stops working if you decline. None of them let UnIdle read your screen, your terminal contents, your code, or anything you type outside of the two specific shortcuts below.

Accessibility

Used by several features

Three separate things depend on this one system permission:

Without it: the two global shortcuts only work while UnIdle's own popover has focus, Mouse Motion silently does nothing, and Lock-and-leave may not work at all depending on your macOS version. Grant it any time from Settings — UnIdle re-checks and turns everything back on immediately, no restart needed.

Powers: ⌥⌘L Lock-and-leave, ⌘⌃A toggle Always-on, Mouse Motion keep-awake

Notifications

Powers UnIdle's alerts: a project "needs permission" (with the command), "has a question" (with the question), or "finished" (with Claude's own one-line summary). Without this permission, or if you disconnect UnIdle from Claude Code in Settings → General, UnIdle still knows an agent is running — it just can't tell you what it's doing.

Without it: the alert toggles in Settings still exist, but nothing ever actually shows on screen — UnIdle already flags this directly in Settings when it detects notifications aren't authorized.

Powers: needs-permission alerts, question alerts, task-finished alerts

Local Network

Pro, opt-in

Only requested if you turn on "Push to my phone." The alert itself — title, message, the "needs permission"/"finished" text — always goes over the internet, through the public ntfy.sh relay (see the privacy policy); that part never touches your local network. Local Network is for something narrower: when an alert includes Approve/Deny buttons, tapping one sends your phone straight to your Mac's address on the same Wi-Fi, reaching a small local server UnIdle runs — no round trip through the internet for that tap.

Without it: push-to-phone notifications keep arriving exactly the same, since the alert itself never depended on this permission — only the Approve/Deny buttons stop working, since your phone can no longer reach your Mac to deliver the tap.

Powers: Approve/Deny buttons on push-to-phone alerts

One-time password for the helper

Pro, opt-in

Not a macOS "permission" in the System Settings sense — macOS's standard "install a new helper tool" prompt, shown only if you set up "Prevent sleep on lid-close (battery)." The helper can do one thing: switch lid-close sleep off while an agent is working, and back on after. It only accepts requests from UnIdle, and turns sleep back on by itself if UnIdle quits. Asked once, at setup; never again after. "Restore all sleep settings" removes it, no password.

Without it: closing the lid on battery sleeps your Mac immediately, same as it always did — every other feature on this page works independently of this one.

Powers: Prevent sleep on lid-close (battery)

Questions

hello@unidle.app — or see the Privacy Policy for what data (if any) ever leaves your Mac.