Permissions

Accessibility#

Required. The Accessibility API is how Cursor Crane reads the interface and moves the cursor. Without it, elements cannot be found and no mode works.

It powers Element Mode, Window Mode, Scroll Mode, Adjust Mode, Element Menu Mode, and the accessibilityAPI permission scripts declare in the Script API.

To grant it:

1. Open System Settings.
2. Go to Privacy & Security → Accessibility.
3. Find Cursor Crane and toggle its checkbox.
4. Unlock the pane with the lock icon if the list is not editable.

Use Check Permissions in the app's settings to verify status and read more about how the app uses Accessibility.

Screen Recording#

Optional. Needed only for OCR, because recognizing text means capturing an image of the window first.

It powers Find Mode, the OCR source in Element Mode, and the OCR fallback behind Copy Full Text and Copy OCR in Element Menu Mode.

To grant it:

1. Open System Settings.
2. Go to Privacy & Security → Screen & System Audio Recording.
3. Turn on permission for Cursor Crane.
4. Restart the app if macOS asks.

Without it the rest of the app is unaffected; only OCR features stop working.

Secure input fields#

When a secure input field is active, such as a password field, macOS stops keyboard events from reaching Cursor Crane. This is a system protection, not a setting. The app shows a secure-input status hint so you know why it stopped responding. See Input Mode.

Script permissions#

Scripts declare their own permissions separately: accessibilityAPI, clipboard, keyboard, mouse, and shell. These are internal to Cursor Crane and gate what a script may call, on top of the macOS grants above. See the Script API.

Revoking#

Remove Cursor Crane from both panes to revoke. Full removal is covered in Uninstalling Cursor Crane.

Next#

• Plans and Licensing
• Reference index