Terminals
Terminal autocomplete on Mac: 22 supported terminals and tmux
Last checked 19 November 2026
In short: Termhint adds an IDE-style autocomplete popup to zsh in 22 Mac terminals and editors, and inside tmux in any of them. Terminal, iTerm2, Ghostty, kitty, WezTerm, Alacritty, Rio and Zed need no permission (split panes in Terminal, iTerm2 and Ghostty need Accessibility); the editors, Kaku, cmux, Tern and a few others need Accessibility to find the cursor. Zed's is off until you turn it on. Warp and GNU screen are not supported.
Terminal autocomplete on Mac, terminal by terminal
| Terminal | Accessibility | Split panes and notes | Icons (Nerd Font) |
|---|---|---|---|
| Terminal (Terminal.app) | Not needed | With Accessibility | Font left alone; Material icons show with a Nerd Font installed |
| iTerm2 | Not needed | With Accessibility | Set as its non-ASCII font |
| Ghostty | Not needed | With Accessibility | Built in |
| WezTerm | Not needed | Yes | Built in |
| kitty | Not needed | No: only a pane that fills the window | Built in |
| Rio | Not needed | No: only a pane that fills the window | Built in |
| Alacritty | Not needed | Has no splits; layout not yet tested | Switches to the Nerd Font build of its font |
| Kaku | Needed | Yes | Built in |
| cmux | Needed | Yes | Built in |
| Tern | Needed | Yes; the popup can sit one cell left of the word | Not set by Termhint |
| VS Code (Insiders too), VSCodium | Needed | Set editor.accessibilitySupport to off | Added to its terminal font list |
| Cursor, Windsurf | Needed | As VS Code | Added to its terminal font list |
| Kiro, Trae, Positron | Needed | As VS Code | Added to its terminal font list |
| JetBrains IDEs: IntelliJ IDEA, PyCharm, WebStorm, GoLand, CLion, Rider, RubyMine, PhpStorm, DataGrip, RustRover | Needed | Terminal tool window; the popup can sit one cell left of the word | Not set by Termhint |
| Zed (Zed Preview too) | Not needed: turn on Settings → Terminal → Apps → Autocomplete in Zed | Off by default; a hidden input method finds the cursor | Not set by Termhint |
| Hyper | Needed | As VS Code | Added to its font list |
| Tabby | Needed | As VS Code | Set as its fallback font |
| Wave | Needed | As VS Code | Not set by Termhint |
| tmux, in any of the above | As the terminal it runs in | Yes, tmux's own split panes | Not handled yet: the prompt may use standard symbols |
| Warp | n/a | Not supported: its own command editor bypasses zsh's line editor | Not supported |
| GNU screen | n/a | Not supported inside screen | n/a |
From Termhint's troubleshooting, permissions and terminal icons docs. In Termhint, Settings → Terminal → Apps → "Every supported terminal" shows the 22 supported apps in this list with a check for the ones on your Mac; point at one to see how Termhint finds its cursor there.
Why some terminals need Accessibility
The popup has to open right under the text cursor, and macOS terminals report it in different ways:
- Terminal, iTerm2, Ghostty, kitty, WezTerm, Alacritty and Rio: on every edit zsh asks the terminal for the cursor cell with standard, invisible queries, and Termhint places the popup in the window, whose frame is public. No permission. A split pane also needs to know where the pane is: Terminal, iTerm2 and Ghostty tell macOS's accessibility API, WezTerm tells
wezterm cli list, kitty and Rio don't tell at all. - VS Code and its forks, Hyper, Tabby and Wave: Termhint turns on Electron's accessibility tree in that app and reads the cursor from it.
- Kaku and JetBrains IDEs: their accessibility text gives the cursor. cmux and Tern combine Accessibility with the cursor cell.
- Zed: its terminal is in no accessibility tree, so Termhint's own input method, hidden from the input menu, tells it where the cursor is. It passes every key on and never reads what you type.
- tmux: zsh asks for the pane's cursor, and tmux says where the pane sits.
- Other apps are tried with Accessibility first, then the cursor cell.
Termhint never needs Screen Recording.
What you get in each terminal
- Completions for 3,272 commands, the command names on your PATH, and live values Termhint reads itself without running git, ssh or docker: git branches, tags, remotes and stashes, ssh hosts, Docker containers and images and Makefile targets.
- Colors. 23 color schemes. By default the shell tells its terminal the colors when it starts, so no terminal's settings change. For Ghostty, kitty, WezTerm and Alacritty,
termhint colors nativealso writes the scheme into the terminal's own config. Not inside tmux. See terminal colors. - Tab titles. zsh sets the title before each prompt with a standard escape sequence. Not inside tmux. See tab titles.
- Prompt themes. Drawn by the shell. See prompt themes.
- Icons.
termhint iconslists each terminal and whether it shows Nerd Font icons;termhint icons setupturns them on where Termhint can. Elsewhere the prompt uses standard symbols.
Not supported: Warp and GNU screen
Typing in Warp goes to its own command editor rather than zsh's line editor, which is where Termhint's popup works. Warp has its own completions; Termhint vs Warp compares the two. Inside GNU screen the popup, colors and tab titles don't work; use tmux instead.
Not working?
Start with the panel under Termhint's menu-bar icon: it shows the one step left, if any, and the terminal tabs connected. Then see terminal autocomplete not working and troubleshooting. Autocomplete is zsh only and needs Apple silicon and macOS 14 or later.