Terminals · kitty
kitty autocomplete: a zsh popup in kitty on Mac
Last checked 19 November 2026
In short: Termhint adds a zsh autocomplete popup at the cursor in kitty, without the Accessibility permission. It shows in a kitty window or pane that fills the window; kitty doesn't say where a split pane sits. tmux's own split panes work.
Set up kitty 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; kitty doesn't need it, so you can decline it (permissions).
- Open a new kitty tab. Tabs that were open before Termhint set up zsh don't have it yet.
- Type
makein a project with a Makefile. The popup lists its targets with the text after##as their description; Tab, the arrows, Esc and Enter go to it only while it is open.
How it finds the cursor in kitty
On every edit zsh asks kitty 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 kitty's default layout. That needs no permission, and it is also why a split pane is out of reach: kitty reports where the cursor is in the pane, not where the pane is in the window.
Want splits with the popup? Run tmux in kitty: tmux says where each of its panes sits, so the popup follows you between them.
What else Termhint sets in kitty
- Colors: 23 schemes through the shell, and with
termhint colors nativealso in kitty's own config, one marked block, backed up first and removed byte for byte. See terminal colors. - Icons: kitty 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. Bundled completions cover 3,272 commands.
Limits in kitty
- Only in a pane that fills the window.
- 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.
Not working?
- No popup: check that the kitty window isn't split. kitty needs no Accessibility, so that is not the cause.
- Open a new tab after installing.
- 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. Need split panes without tmux? WezTerm has them without a permission, Ghostty with Accessibility.
FAQ
Does Termhint need Accessibility in kitty?
No. zsh asks kitty for the cursor cell and the cell size with standard queries, and Termhint places the popup in the window.
Why no popup in kitty's split windows?
kitty does not say where a pane sits in the window, so Termhint shows the popup only in a pane that fills the window. Inside tmux, tmux says where its panes sit, so tmux's split panes work in kitty.
Do Nerd Font icons show in kitty?
Yes. kitty ships the Nerd Font symbols, so prompt icons show without a font change.
What about Rio?
Rio works the same way: no Accessibility, icons built in, and the popup only in a pane that fills the window.