Termhint Get Termhint

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

  1. Download Termhint, move it to Applications and open it. On launch it adds one marked block to ~/.zshrc, backed up first.
  2. Termhint shows macOS's Accessibility prompt at first launch; kitty doesn't need it, so you can decline it (permissions).
  3. Open a new kitty tab. Tabs that were open before Termhint set up zsh don't have it yet.
  4. Type make in 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

Limits in kitty

Not working?

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.

Download for Mac All supported terminals