Termhint Get Termhint

Terminals · Terminal

Autocomplete in Mac Terminal: a zsh popup in Apple's Terminal

Last checked 19 November 2026

In short: Apple's Terminal runs zsh, which completes on Tab with a list under the line. Termhint adds an IDE-style popup that opens as you type: subcommands, options, arguments, files, git branches and more, from bundled completions for 3,272 commands. In Terminal it needs no permission; only split panes need Accessibility.

Set up autocomplete in Terminal

  1. Download Termhint, move it to Applications and open it. On launch it adds one marked block to ~/.zshrc, backed up first.
  2. Open a new Terminal window or tab. Tabs that were open before Termhint set up zsh don't have it yet.
  3. Type git ch. The popup opens under the cursor with checkout among the matches; Tab, the arrows, Esc and Enter go to it only while it is open.
  4. Termhint shows macOS's Accessibility prompt at first launch. Allow it if you split Terminal's windows; for single panes you can decline it (permissions).

How Termhint finds the cursor in Terminal

Without Accessibility, on every edit zsh asks Terminal where the cursor is, with standard queries you don't see. Termhint places the popup in the window by Terminal's layout, so title, tab and tool bars of any height are fine. A split pane is the one case it can't place this way; with Accessibility allowed, macOS gives the cursor directly, split panes included.

What you get in Terminal

Limits in Terminal

Not working?

More fixes: terminal autocomplete not working and troubleshooting. Prefer iTerm2? See iTerm2 autocomplete.

FAQ

Does Mac Terminal have autocomplete?

zsh in Terminal completes when you press Tab, as a list under the line. It has no popup that opens as you type. Termhint adds one.

Does Termhint need the Accessibility permission in Terminal?

No, except for split panes. Without it, zsh asks Terminal where the cursor is on every edit and Termhint places the popup in the window. With Accessibility allowed, macOS gives the cursor directly and the popup works in split panes too.

Do prompt icons show in Terminal?

Terminal keeps its own font. Termhint installs a Nerd Font and switches the prompt's icons to Material icons, which macOS draws in Terminal from the installed font. An icon without a Material twin, such as a Powerline edge, needs a Nerd Font as Terminal's profile font.

Does it work inside tmux in Terminal?

Yes, in tmux's split panes too. Inside GNU screen it does not.

Download for Mac All supported terminals