Termhint Get Termhint

Terminals · iTerm2

iTerm2 autocomplete: zsh suggestions as you type

Last checked 19 November 2026

In short: iTerm2 has a word autocomplete of its own (Cmd-;) that suggests words already shown in the window. It does not know commands, options or arguments. Termhint adds a zsh autocomplete popup to iTerm2 that does: subcommands, options, arguments, git branches and dynamic suggestions such as your npm run scripts. It needs no permission in iTerm2; only split panes need Accessibility.

Set up iTerm2 autocomplete for zsh

  1. Download Termhint, move it to Applications and open it. On launch it adds one marked block to ~/.zshrc, backed up first.
  2. Termhint shows macOS's Accessibility prompt at first launch. Allow it if you use iTerm2's split panes; for single panes you can decline it. Without it, zsh asks iTerm2 where the cursor is (and its exact cell size) on every edit, and Termhint places the popup in the window (permissions).
  3. Open a new tab. Tabs that were open before Termhint set up zsh don't have it yet.
  4. Type git ch. The popup opens under the cursor; Tab, the arrows, Esc and Enter go to it only while it is open.

iTerm2's own autocomplete

iTerm2's feature page says: "Just type the start of any word that has ever appeared in your window and then Cmd-; will pop open a window with suggestions" (iterm2.com features). It completes words from the screen, on request. Termhint's popup opens as you type and its suggestions come from the command line: Fig's open-source completion specs, zsh's own completion functions and, for commands without either, the options in the command's man page. The two can be used side by side, since iTerm2's opens only on Cmd-;.

If what you want is iTerm2's word completion, you need nothing else. If you want suggestions for git, docker, kubectl or brew subcommands and flags, that is what Termhint adds.

What Termhint adds to iTerm2

Limits in iTerm2

Not working?

More fixes: terminal autocomplete not working and troubleshooting.

Download for Mac All supported terminals