Termhint Get Termhint

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

  1. Download Termhint.dmg and drag Termhint to Applications, or run brew install --cask toni1703/termhint/termhint.
  2. Open Termhint. It adds one marked block to the end of ~/.zshrc. From a terminal, termhint install does the same.
  3. 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.
  4. 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:

CommandWhat it does
termhint installSet up zsh: autocomplete, prompt themes, terminal colors and runtime versions
termhint theme set pureLet Termhint draw the prompt with the pure theme (prompt themes)
termhint colors set tokyo-nightColor your terminals with Tokyo Night
termhint icons setupTurn Nerd Font icons on in every terminal Termhint can (terminal icons)
termhint runtime install node 22Install the newest Node 22 (runtime manager)
termhint settings set popup.font-size 15Make the popup's text bigger
termhint licenseHow the free trial or license stands
termhint help colors setThe help of one command

More on how completion works: zsh autocomplete.

Guides

Uninstall

  1. Settings → License → Deactivate This Mac, so the key can go on another Mac.
  2. 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.
  3. Quit Termhint from the menu bar and move Termhint.app to the Trash. With Homebrew: brew uninstall --cask toni1703/termhint/termhint.
  4. 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.

Download for Mac Troubleshooting