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:
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 offTabs 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 uninstallalone also removes the block, but whileterminals.integrationis 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
Deactivate your license (if you bought one), so the key can go on another Mac: see Deactivate your license.
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).
Undo Termhint's changes in a terminal:
termhint uninstall --allQuit 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.
Remove the Accessibility entry: see Accessibility.
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:
~/.cache/termhint~/Library/Application Support/Termhint~/Library/Caches/dev.termhint.Termhint~/Library/HTTPStorages/dev.termhint.Termhint~/Library/Preferences/dev.termhint.Termhint.plist
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:
- Open Settings → License (or run
termhint license open). - 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.