Termhint Get Termhint

Docs

Why does terminal autocomplete need Accessibility permission?

Updated 19 November 2026

In short: to open the popup right under your cursor, Termhint has to know where the cursor is. In editor terminals, JetBrains IDEs, Kaku, cmux, Tern and split panes of Terminal, iTerm2 and Ghostty it reads that from the other app's window through macOS's accessibility API, so those need the Accessibility permission. Terminal, iTerm2, Ghostty, kitty, WezTerm, Alacritty and Rio windows don't: there zsh asks the terminal for the cursor cell. Below is every permission Termhint can ask for, what uses it, what works without it, and how to give it and take it back.

Accessibility

What uses it. Finding the text cursor in another app's window, so the popup opens right under it:

What works without it.

Termhint does not need Screen Recording: window positions and sizes need no permission. Programs Termhint starts (the runtime helper, brew, a login shell, package installs) run as their own responsible process, so they cannot use Termhint's Accessibility permission.

Grant. On its first launch Termhint shows macOS's prompt. Later, use Allow in Settings or in the panel under the menu-bar icon, or go to System Settings → Privacy & Security → Accessibility and turn on Termhint. The app notices the change without a restart. termhint settings get app.accessibility answers granted or not granted.

Revoke. Turn Termhint off in System Settings → Privacy & Security → Accessibility, or remove it from the list with −. From a terminal:

tccutil reset Accessibility dev.termhint.Termhint

Moving the app to the Trash does not remove the entry; remove it there. If the panel still asks after you allowed it, see troubleshooting.

Open at login

What uses it. Termhint as a login item, so autocomplete runs after you log in. Off by default.

Without it. Everything works once you open Termhint yourself. Commands that need the app open it in the background.

Grant. Settings → App, the menu-bar panel, or termhint settings set app.open-at-login on. If the state shows "needs approval", allow Termhint in System Settings → General → Login Items.

Revoke. The same switch, termhint settings set app.open-at-login off, or System Settings → General → Login Items.

Administrator helper (Login Items approval)

What uses it. An optional helper that runs as root, turned on in Settings → Runtimes → Xcode → Administrator helper. With it, two Xcode steps run without a password: Make Default (xcode-select -s) and Finish Setup (Xcode's license and first launch). It talks only to Termhint.app, and each end checks the other's code signature. It accepts only an Xcode directly in /Applications, offers no other commands, and quits a minute after its last request.

Without it. The same two steps ask for your administrator password each time. Nothing else uses the helper.

Grant. Turn it on in Settings → Runtimes → Xcode. macOS then wants it approved: Termhint opens System Settings → General → Login Items, where you allow it.

Revoke. Turn it off in Settings → Runtimes → Xcode, or in System Settings → General → Login Items.

Administrator password

Asked only by the two Xcode steps above, when the administrator helper is off:

From a terminal the prompt is sudo's; from the app it is macOS's administrator dialog. Each step asks once. More on Xcode versions: Termhint and xcodes.

Keychain

Termhint keeps its license record and, if you sign in for Xcode downloads, your Apple developer session in the login keychain (privacy policy). Termhint.app reads its license item without asking; macOS asks if another program wants it. These items stay when the app is deleted.

Files and folders

Termhint asks for no Files and Folders or Full Disk Access permission. The app reads the folder being typed (to list files) and the nearest package.json. If a shell is in a folder macOS protects, such as Desktop, Documents or Downloads, macOS may ask whether Termhint may access it. Without that access the popup lists no files there; everything else works.

Not used

Download for Mac Troubleshooting