Docs
Termhint docs: install, first commands, uninstall
Updated 19 November 2026
How to install Termhint, the first commands to try, and how to remove it. Termhint is a menu-bar app for macOS 14 or later on Apple silicon. Autocomplete works in zsh; bash gets prompt themes and terminal colors.
Install
- Download Termhint.dmg and drag Termhint to Applications, or run
brew install --cask toni1703/termhint/termhint. - Open Termhint. It adds one marked block to the end of
~/.zshrc. From a terminal,termhint installdoes the same. - In an editor terminal (VS Code, Cursor, Windsurf, Kiro, Hyper, Tabby and others), a JetBrains IDE, Kaku, cmux, Tern, or split panes in Terminal, iTerm2 or Ghostty, allow Termhint in System Settings → Privacy & Security → Accessibility. Terminal, iTerm2, Ghostty, kitty, WezTerm, Alacritty and Rio do not need it otherwise. In Zed, turn on Settings → Terminal → Apps → Autocomplete in Zed. See permissions.
- Open a new terminal tab. Tabs that were open before need a new one.
To see the popup on its own, without Accessibility, the shell or a terminal, run demo mode:
open -n /Applications/Termhint.app --args --demo
First commands
termhint help lists every command. A few to start with:
| Command | What it does |
|---|---|
termhint install | Set up zsh: autocomplete, prompt themes, terminal colors and runtime versions |
termhint theme set pure | Let Termhint draw the prompt with the pure theme (prompt themes) |
termhint colors set tokyo-night | Color your terminals with Tokyo Night |
termhint icons setup | Turn Nerd Font icons on in every terminal Termhint can (terminal icons) |
termhint runtime install node 22 | Install the newest Node 22 (runtime manager) |
termhint settings set popup.font-size 15 | Make the popup's text bigger |
termhint license | How the free trial or license stands |
termhint help colors set | The help of one command |
More on how completion works: zsh autocomplete.
Guides
- Autocomplete not working: the popup does not show in Terminal, iTerm2, Ghostty or VS Code, and the fix for each.
- Troubleshooting: the popup does not show, icons are boxes, the prompt did not change, license, updates, refused runtime installs.
- Permissions: what each macOS permission is for, what works without it, how to grant and revoke it.
- Terminal icons: why Nerd Font icons show as boxes and the font setting each terminal needs.
- Privacy: what leaves your Mac and what does not.
- Changelog: what changed in each version.
Uninstall
- Settings → License → Deactivate This Mac, so the key can go on another Mac.
- In a terminal, run
termhint uninstall --all. It undoes every change Termhint made outside its own folders (the zsh and bash blocks, the links on PATH, terminal colors, icon and font settings), turns Autocomplete in Zed off (removing its input method), deletes what the popup learned, and prints what stays. - Quit Termhint from the menu bar and move Termhint.app to the Trash. With Homebrew:
brew uninstall --cask toni1703/termhint/termhint. - Remove Termhint from System Settings → Privacy & Security → Accessibility.
The full list of what stays (your themes, installed runtimes, fonts, keychain items) is in troubleshooting.
Report a problem
Use Report… under an error in Settings, the last row of the menu-bar panel, or Report a Problem… in the app menu. It opens a prefilled public GitHub issue or an email to hello@termhint.com. You can also open an issue directly. Security problems go to Report a vulnerability, never to a public issue.