Terminals · Zed
Zed terminal autocomplete: a zsh popup in Zed
Last checked 19 November 2026
In short: Termhint adds its zsh autocomplete popup to Zed's terminal panel, with completions for 3,272 commands, your git branches, ssh hosts and Makefile targets. It is off by default: turn on Autocomplete in Zed in Termhint's Settings → Terminal → Apps. No Accessibility permission is involved.
Set up autocomplete in Zed
- Download Termhint, move it to Applications and open it. On launch it adds one marked block to
~/.zshrc, backed up first. - In Termhint, open Settings → Terminal → Apps and turn on Autocomplete in Zed. From a terminal:
termhint settings set terminals.zed-input on. - Open a new terminal in Zed. Terminals that were open before Termhint set up zsh don't have it yet.
- Type
git checkout. The popup lists your branches, such asmainandfeature/login; Tab, the arrows, Esc and Enter go to it only while it is open.
How it works: a hidden input method
Zed draws its terminal itself and puts it in no accessibility tree, so macOS can't say where the cursor is. Turning the switch on adds a link in ~/Library/Input Methods to an input method inside Termhint.app and selects it. It is hidden from the input menu, so your keyboard layout stays. While a Zed text view has the focus, it tells Termhint where Zed's text cursor is; that is all it sends.
- While it is selected it sees every key in every app, as any input method does, and passes each one on unread.
- It sends only the cursor's rectangle and Zed's app identifier, only to Termhint.app, only while Zed has the focus. It keeps and logs nothing.
- The input method itself asks for no permission. Termhint's Accessibility prompt at first launch is not needed for Zed (permissions).
What you get in Zed
- Suggestions for subcommands, options, arguments, files and folders, and the command name itself:
gioffersgit. - Live values read by Termhint itself: git branches, tags and remotes, ssh hosts, Docker containers and images and Makefile targets.
- Prompt themes, drawn by the shell.
Limits in Zed
- Off until you turn it on.
- zsh only, Apple silicon, macOS 14 or later. Not inside GNU screen.
Not working?
- Check that Autocomplete in Zed is on. Termhint relinks the input method at launch after an update or a move; if the popup does not show, turn the switch off and on.
- Open a new terminal in Zed after installing.
- The panel under Termhint's menu-bar icon shows whether autocomplete is on and the terminal tabs connected.
- To remove it by hand:
termhint settings set terminals.zed-input off, or delete~/Library/Input Methods/TermhintInput.appand log out.
More fixes: terminal autocomplete not working and troubleshooting. Using VS Code or Cursor too? See VS Code and Cursor.
FAQ
Why is autocomplete off in Zed by default?
Zed's terminal is in no accessibility tree, so Termhint finds its cursor through a small input method of its own. An input method is something you should choose to add, so it stays off until you turn on Autocomplete in Zed.
Does the input method read what I type?
No. It passes every key on unread and sends only the text cursor's rectangle and Zed's app identifier to Termhint, only while Zed has the focus. It keeps and logs nothing.
Does it change my keyboard layout?
No. It is hidden from the input menu and your keyboard layout stays as it is.
Does it work in Zed Preview?
Yes, Zed and Zed Preview both.
How do I remove it?
Turn the switch off, or run termhint settings set terminals.zed-input off. termhint uninstall --all removes it too.