Compare
zsh-autosuggestions, zsh-autocomplete or a popup at the cursor
Last checked 19 November 2026
In short: zsh-autosuggestions finishes the line you are typing with gray text, mostly from your history. zsh-autocomplete shows zsh's completion list below the line as you type. Termhint is a paid Mac app that shows completions in a native popup at the cursor, from bundled specs for 3,272 commands. They solve different problems, and the free plugins are the better pick in several cases listed below.
Side by side
| zsh-autosuggestions | zsh-autocomplete | Termhint | |
|---|---|---|---|
| What it shows | One gray guess for the rest of the line | A list of completions | A list of completions, each described |
| Where from | Your history, or zsh's completion if you turn that on | zsh's completion functions | Completion specs for 3,272 commands, then zsh's completion functions and man pages; git, ssh, Docker and make values read on your Mac |
| Where it shows | After the cursor, in the terminal text | Below the command line, in the terminal text | A native macOS popup at the cursor, outside the terminal text |
| Keys | → or End accepts | Tab inserts the top match, ↓ selects another | Tab, ↑, ↓, Enter and Esc, only while the popup is open |
| Runs on | zsh anywhere | zsh anywhere | zsh on a Mac with Apple silicon, macOS 14 or later |
| Cost | Free, MIT | Free, MIT | $11.99 once, 7-day trial |
The plugins as their READMEs describe them on 19 November 2026.
What zsh-autosuggestions does well
It "suggests commands as you type based on history and completions". Type ssh pr and, if you ran ssh prod-web -L 5432:localhost:5432 last week, the whole line appears in gray; → takes it. For repeating long lines with their arguments, nothing is quicker. It shows one guess at a time, though, and no description: it tells you what you typed before, not what else the command can do.
Where Termhint is different
- A list, described.
git chshowscheckoutandcherry-pickwith what each does;docker run -lists every option with its meaning. Details of the selected row show below the list. - Values from your Mac. git branches, tags, remotes and stashes, ssh hosts, Docker containers and images, Makefile targets and package.json scripts, including ones you have never typed.
- Command names.
gioffersgit, with the commands on your PATH, your aliases, functions and shell builtins. An alias completes like what it stands for: withalias gco='git checkout',gcolists branches. - Learned ranking. The commands, subcommands and options you use come first among equal matches, more so the more often and the more lately you used them. Only their names are kept, never your arguments, in a file only you can read. Settings → Popup → Learn from chooses between the lines you run, only what you pick in the popup, or off.
- Nothing drawn in the terminal. The popup is its own window, so the line and your scrollback stay as they are.
How it hooks into zsh, and how it compares with zsh's own Tab menu and fzf-tab: zsh autocomplete on the Mac.
Using them together
zsh-autosuggestions: Termhint documents no conflict with it. Termhint binds Tab, ↑, ↓, Enter and Esc, acts on them only while its popup is open, and hands them to whatever they did before the rest of the time. It leaves → and End, the keys that accept a suggestion, alone. Termhint's terminal colors can even set the color of the plugin's gray text so it stays readable on dark backgrounds.
zsh-autocomplete: Termhint's docs don't cover running it alongside. Both show a list of completions as you type and both act on Tab and ↓, so pick one of the two.
When to stay with the plugin
- You mostly re-run long lines. Termhint never keeps your arguments, so it can't bring back
kubectl port-forward svc/api 8080:80from yesterday. zsh-autosuggestions can. - You work in zsh on Linux or on servers. The plugins go wherever zsh goes; Termhint is a Mac app.
- Your terminal isn't supported. Termhint's popup doesn't work in Warp or GNU screen; see which terminals it supports.
- You use bash or fish, or an Intel Mac. Termhint's autocomplete is zsh only, on Apple silicon.
- You want free and open source. Both plugins are MIT-licensed; Termhint is a paid app.
FAQ
What is the difference between zsh-autosuggestions and autocomplete?
zsh-autosuggestions shows one gray guess after the cursor, usually a line from your history, and the right arrow accepts it. Autocomplete shows a list of what fits where you are: subcommands, options, files, branches. One finishes a line you typed before; the other shows what you can type next.
Can I keep zsh-autosuggestions with Termhint?
Termhint documents no conflict with it. Termhint takes Tab, the up and down arrows, Enter and Esc only while its popup is open and leaves the right arrow and End alone, and its terminal colors can set the color of zsh-autosuggestions' gray text.
Should I run zsh-autocomplete and Termhint together?
Termhint's docs don't cover it. Both show a list of completions as you type and both act on Tab and the down arrow, so pick one.
Does Termhint suggest whole lines from my history?
No. It learns which commands, subcommands and options you use and lists them first, but it keeps only their names, never your arguments, so it cannot bring back a full earlier line. zsh-autosuggestions does that.
What it costs
Every feature works for 7 days with no account and no card. After that, a one-time license: $11.99 for 1 Mac, $19.99 for 3, $29.99 for 5, plus VAT or sales tax where it applies (pricing).
Termhint is not affiliated with zsh-autosuggestions or zsh-autocomplete.