Terminals · WezTerm
WezTerm autocomplete: zsh suggestions in every pane
Last checked 19 November 2026
In short: Termhint adds a zsh autocomplete popup at the cursor in WezTerm on a Mac, in split panes too, without the Accessibility permission. Suggestions come from bundled completions for 3,272 commands plus live values such as your git branches and ssh hosts.
Set up WezTerm autocomplete for zsh
- Download Termhint, move it to Applications and open it. On launch it adds one marked block to
~/.zshrc, backed up first. - Termhint shows macOS's Accessibility prompt at first launch; WezTerm doesn't need it, split panes included, so you can decline it (permissions).
- Open a new tab or pane. Ones that were open before Termhint set up zsh don't have it yet.
- Type
ssh. The popup lists your hosts from~/.ssh/configandknown_hosts, such asprod-web; Tab, the arrows, Esc and Enter go to it only while it is open.
How it finds the cursor, panes included
On every edit zsh asks WezTerm for the cursor cell and the cell size with standard, invisible queries (about a millisecond; keys typed meanwhile are kept). Termhint places the popup in the window by WezTerm's default layout. For a split pane it asks wezterm cli list where the pane starts, again only after a resize or two seconds. No permission is involved.
What else Termhint sets in WezTerm
- Colors: 23 schemes through the shell, and with
termhint colors nativealso in WezTerm's own config, one marked block, backed up first. See terminal colors. - Icons: WezTerm ships the Nerd Font symbols, so prompt icons show without a font change.
- Prompt themes and tab titles.
- Live values: git branches, ssh hosts, Docker containers and Makefile targets, read by Termhint itself.
Limits in WezTerm
- Custom window padding or tab bar settings can shift the popup a little.
- zsh only, Apple silicon, macOS 14 or later. Not inside GNU screen; tmux works.
Not working?
- Open a new tab or pane after installing.
- If the popup sits off in a pane, resize the window once; the pane layout is asked again after a resize.
- 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.
- Esc hides the popup until the line changes.
More fixes: terminal autocomplete not working and troubleshooting. Similar terminals: Ghostty and kitty.
FAQ
Does Termhint need Accessibility in WezTerm?
No. zsh asks WezTerm for the cursor cell and the cell size with standard queries, and Termhint places the popup in the window.
Does the popup work in WezTerm's split panes?
Yes. Termhint asks wezterm cli list where the pane starts, again only after a resize or every two seconds at most.
Can Termhint write colors into wezterm.lua?
termhint colors native also writes the scheme into WezTerm's own config, as one marked block, backed up first and removed byte for byte.
What about Kaku?
Kaku, a WezTerm fork, is supported too, split panes included. There Termhint reads the cursor through Accessibility.