Changelog
What's new in Termhint
Updated 19 November 2026
Every release, newest first. Termhint checks for updates once a day (you can turn that off in Settings → App) and shows these notes before it installs one. Updates are signed and checked before they install.
1.4.1 19 November 2026
Added
- Autocomplete in more terminals: Kiro, Trae, Positron, Wave, Rio, Kaku, cmux, Tern and the terminal of JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm and the others). In Kaku, cmux and Tern the popup works in split panes too. Kiro, Trae and Positron can show icons the way VS Code does; Rio, Kaku and cmux have them built in.
- Branches, tags, remotes, stashes and git aliases as you type a git command (
git checkout,git push origin,git stash pop), ssh hosts from~/.ssh/configandknown_hosts(also afteruser@), and Docker containers and images. Termhint reads them itself: it never runs git, ssh or docker for this. Docker's arrive a moment after the other suggestions. makelists the Makefile's targets, with the text after##as their description and##@ Sectionlines in front of it. A target whose help starts with[prod],[production],[danger]or[caution]shows in red.- The popup also suggests the command itself as you type it:
gioffersgit, with the commands on your PATH, your aliases, functions and shell builtins (the exact name first, then shorter names). Aftersudotoo. A new alias, function or PATH entry counts from the next prompt, a newly installed program once it ran or afterrehash(as for Tab). Turn it off with the Command names switch in Settings → Popup, ortermhint settings set popup.command-names off. - An alias completes like what it stands for: with
alias gco='git checkout',gcolists branches. - The popup learns what you use: commands, subcommands and options you run come first among equal matches, more so the more often and the more lately you used them (
git pushlists the options you use first). Choose what it learns from in Settings → Popup → Learn from: the lines you run (default), only what you pick in the popup, or off, which deletes what it learned (termhint settings set popup.learn runs|picks|off). Only those names are kept, never your arguments, in a file only you can read;termhint uninstall --alldeletes it. - Autocomplete inside tmux, in tmux's own split panes too.
- Terminal and iTerm2 no longer need Accessibility: without it, zsh asks the terminal where the cursor is. Split panes there still need Accessibility.
- Autocomplete in Zed's terminal, off by default: turn on Settings → Terminal → Apps → Autocomplete in Zed. A hidden input method tells Termhint where Zed's cursor is; it passes every key on and never reads what you type.
- Settings → Terminal → Apps lists every supported terminal under "Every supported terminal", each with its icon (the logo of open-source terminals even when they aren't installed, two letters for the rest) and a check when it's on this Mac. Point at one to see how Termhint finds its cursor there.
- The popup now opens in split panes of Ghostty (with Accessibility allowed) and WezTerm. kitty and Rio don't say where a pane is, so there it still needs a pane that fills the window.
Changed
- Menus in Settings now match the window instead of opening macOS's blue menu: the chosen value has a check, choices explain themselves where it helps, and ↑↓, Return and Esc work, with their hints at the bottom. The font menu has a filter and shows each font in itself. In the popup's menus and the look menu at the top right, ↑↓ try each choice on the spot and Esc puts back what was there.
- Point at a popup theme or a color scheme to see it in the preview above before you pick it. Nothing changes until you click.
- About 70 more tools now complete their subcommands and options, such as
warp-cli,devicectl,cursor-agent,fastboot,jshellandx265. Termhint now bundles completions for 3,272 commands. - Commands installed under a version or a second name complete like the command itself:
pip3.14likepip3,gawk-5.4.1likegawk,cpan5.34likecpan, andyarnpkg,bundlerandzstdmtlikeyarn,bundleandzstd. - Clicking the version in the menu-bar panel checks for updates without opening a window when Termhint is up to date: the version briefly reads "Up to date". A window opens only when there is an update to install or the check failed.
- Update windows show versions without build numbers.
1.3.14 18 November 2026
Changed
composer,phpandrailsnow complete their subcommands and options.- About 90 commands whose bundled completions offered nothing of their own (such as
egrep,nslookup,magick,taskandz) now use zsh's own completion or the options in their man page instead. Termhint now bundles completions for 3,200 commands.
Fixed
- The menu-bar panel's header keeps its title on one line, and the version, trial and Update pills no longer wrap.
- In a narrow Settings window, the section bar no longer overlaps the app look menu.
1.3.13 17 November 2026
Fixed
- An activated Python virtual environment (or anything else you put in front of your PATH) now stays first: before, the next prompt put Termhint's Python, Node and other versions ahead of it, so
pythonran Termhint's instead of the environment's.
Security
- Termhint's programs ship without symbol tables or the paths of the Mac that built them.
1.3.12 17 November 2026
The first release of Termhint.
Added
- IDE-style autocomplete for zsh in any macOS terminal: subcommands, options, arguments, package.json scripts, files and folders, for 3,290 commands. See zsh autocomplete.
- Prompt themes, 23 terminal color schemes, terminal icons and tab titles; themes and colors also work in bash. See prompt themes.
- A runtime manager for Node, Python, Ruby, Go, Java and 9 more languages, and Xcode; every download is verified before it installs. See the runtime manager.
- A 7-day free trial, then a license for 1, 3 or 5 Macs (Settings → License).
- Updates inside the app, signed and checked before they install.
termhint uninstall --all: before removing the app, undoes every change Termhint made outside its own folders (shell blocks, PATH links, terminal colors and icon settings) and lists what stays.- Homebrew:
brew install --cask toni1703/termhint/termhint. --selfteston the app checks a build (its bundled specs, scripts, helpers, update settings and signature) without changing anything.- Report… in the menu-bar panel and under an error, and Report a Problem… in the app menu, open a filled-in bug report on GitHub or an email, which you check before sending.