Termhint Get Termhint

Uninstall Termhint from your Mac

Updated 19 November 2026All docs

How to turn autocomplete off for a while, and how to remove Termhint completely. Run termhint uninstall --all before you move the app to the Trash: the termhint command lives inside Termhint.app.

Turn autocomplete off

To stop the popup in every new tab but keep Termhint:

  1. In Settings → Terminal → Apps, click Turn Off. Termhint removes its block from ~/.zshrc (backed up first) and does not add it back. From a terminal:

    termhint settings set terminals.integration off
    
  2. Tabs that were open keep the setup until they are closed. To stop the popup there too, quit Termhint from the menu bar.

Turn On in the same place, or the button in the menu-bar panel, adds the block again.

To keep the popup away from some commands only, add them under Settings → Popup → Commands (popup.off-for). See Autocomplete.

Note: termhint uninstall alone also removes the block, but while terminals.integration is on, Termhint.app adds it back at its next launch. Use the switch or the command above to keep it off.

termhint uninstall

termhint uninstall            # zsh
termhint uninstall bash       # bash

It removes Termhint's marked block from the rc file (backed up first), the script and the compiled theme. For zsh this includes the --instant block at the top of ~/.zshrc; for bash, the block in ~/.bashrc and in the login file. Open tabs keep it until they are closed. Your settings and everything else stay.

termhint uninstall --all

termhint uninstall --all

It undoes every change Termhint made outside its own folders, so run it before you remove the app. It prints one line per step: what it did, "nothing to do", or "failed:" and why. A failed step does not stop the others, and makes the exit status 1. The steps, in order:

Step What it does
terminal colors Takes the colors out of Ghostty's, kitty's, WezTerm's and Alacritty's own config files (backed up first), as termhint colors native off all does
terminal icons and fonts Puts back the icon and font settings Termhint changed in a terminal, only in those it changed
zsh Removes the zsh blocks from ~/.zshrc (with the --instant one, backed up first) and the script
bash Removes the bash block from ~/.bashrc and the login file (backed up first) and the script
PATH links Removes the termhint and short-name links from ~/.config/termhint/shell/bin
terminals.integration Turns it off, so Termhint.app does not add the zsh block back, also at its next launch
terminals.zed-input Turns it off: Zed's input method is turned off and its link removed from ~/Library/Input Methods
learned ranking Deletes what the popup learned (popup.learn)

At the end it lists what stays and what is left to do by hand (below).

Remove Termhint completely

  1. Deactivate your license (if you bought one), so the key can go on another Mac: see Deactivate your license.

  2. Turn off what you turned on, if you use them: the administrator helper (Settings → Runtimes → Xcode → Administrator helper → Turn Off), the Apple Developer session (Settings → Runtimes → Xcode → Sign Out…) and Open at login (Settings → Terminal → Apps).

  3. Undo Termhint's changes in a terminal:

    termhint uninstall --all
    
  4. Quit and remove the app. Quit Termhint from the menu bar (Quit Termhint) and move Termhint.app to the Trash. If you installed it with Homebrew, see Homebrew instead.

  5. Remove the Accessibility entry: see Accessibility.

  6. Delete what stays, if you want it gone: see What stays on your Mac.

Homebrew

Run termhint uninstall --all first; the cask reminds you of it too. Then:

brew uninstall --cask toni1703/termhint/termhint

Homebrew quits Termhint and removes Termhint.app. With --zap, it also deletes these:

brew uninstall --zap --cask toni1703/termhint/termhint

Accessibility

Removing the app does not remove its Accessibility entry. In System Settings → Privacy & Security → Accessibility, select Termhint and click −. From a terminal:

tccutil reset Accessibility dev.termhint.Termhint

More on Permissions.

Deactivate your license

An activated Mac takes one of the places of your license key. To free it:

  1. Open Settings → License (or run termhint license open).
  2. Click Deactivate This Mac…, then Deactivate.

Termhint locks on this Mac until a key is entered again. If the Mac is already gone, remove it later in Polar's customer portal (Manage Macs in Settings → License on another Mac). See License.

What stays on your Mac

termhint uninstall --all and removing the app leave these, for you to delete if you want:

What Where
Settings, your themes, color schemes, tab title, runtime defaults ~/.config/termhint
Runtimes installed with Termhint ~/.local/share/termhint
Downloads and caches ~/.cache/termhint
Popup icons you imported ~/Library/Application Support/Termhint
App preferences ~/Library/Preferences/dev.termhint.Termhint.plist
Nerd Fonts Termhint installed ~/Library/Fonts (remove one with termhint icons remove <font> before the app goes, or in Font Book)
Backups of your rc files and terminal configs Next to each file, for example ~/.zshrc.termhint-backup-<time>
The trial and license record The login keychain ("Termhint license"); kept so a reinstall keeps the trial's start
The Apple Developer session, if you signed in The login keychain; remove it first with Sign Out…
Xcodes installed through Termhint /Applications

If you set XDG_CONFIG_HOME, XDG_DATA_HOME or XDG_CACHE_HOME, the first three folders are under those instead. brew uninstall --zap deletes the folders listed under Homebrew.