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
- Download Termhint, move it to Applications and open it. On launch it adds one marked block to
~/.zshrc, backed up first. - Open a new Terminal window or tab. Tabs that were open before Termhint set up zsh don't have it yet.
- Type
git ch. The popup opens under the cursor withcheckoutamong the matches; Tab, the arrows, Esc and Enter go to it only while it is open. - 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
- Commands as you type them:
gioffersgit, with the programs on your PATH, your aliases, functions and builtins. - Makefile targets:
makelists the targets with their##help (Makefile targets). - Learned order: the commands and options you use come first among equal matches. Only their names are kept, never your arguments.
- Colors through the shell when a tab starts; Terminal's own profiles are not changed (terminal colors).
- Icons:
termhint icons on terminalinstalls a Nerd Font and uses Material icons, which Terminal draws without changing its font. - Prompt themes and tab titles, drawn by the shell.
- Live values:
git checkoutlists your branches such asmainandfeature/login;sshlists hosts likeprod-webfrom~/.ssh/config; Docker commands list containers and images such asapiandpostgres. Termhint reads them itself and never runs git, ssh or docker for this. See Git autocomplete, ssh hosts and Docker.
Limits in Terminal
- Split panes need Accessibility.
- A custom margin setting can shift the popup a little without Accessibility.
- zsh only: bash gets prompt themes and colors, not the popup. Not inside GNU screen; tmux works.
- Apple silicon and macOS 14 or later.
Not working?
- The panel under Termhint's menu-bar icon shows whether autocomplete is on, the one step left if it is not, and the terminal tabs connected.
- Open a new tab after installing; old tabs don't have the zsh block.
- In a split pane, allow Accessibility. If Termhint shows as on and the panel still asks for it, remove it with − and allow it again.
- Esc hides the popup until the line changes.
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.