DEV Community

Cover image for Termhint: autocomplete, prompts, colors and runtimes for every Mac terminal
I T
I T

Posted on

Termhint: autocomplete, prompts, colors and runtimes for every Mac terminal

My terminal setup used to be a pile of tools: Fig for autocomplete, oh-my-zsh and Powerlevel10k for the prompt, nvm, pyenv and rbenv for runtimes, plus a color scheme and a Nerd Font set up by hand in every terminal. Then Kiro CLI 3.0 (formerly Fig and Amazon Q) removed autocomplete, and I decided to build one native Mac app that does all of it: Termhint.

Termhint autocomplete in a terminal

Autocomplete in every terminal

  • A dropdown at your text cursor with subcommands, flags and arguments, each with a description
  • npm run, yarn, pnpm and bun list your package.json scripts first
  • Paths that actually exist: cd offers folders, tsc offers .ts files first
  • 3,290 commands have specs: Fig's 1,475 open-source specs plus generated ones. Anything else falls back to zsh's own completions, then to the man page's options
  • Works in Terminal, iTerm2, Ghostty, kitty, WezTerm, Alacritty, VS Code, Cursor, Windsurf, Hyper and Tabby (zsh). Warp isn't supported, because its own editor bypasses zsh's line editor

Customize everything

  • Prompt builder: a live preview of your terminal. Click any part of the prompt to show or hide it, move it, or change its color, style or line
  • Prompt themes (robbyrussell, agnoster, pure, lean, starship) without oh-my-zsh, Powerlevel10k or Starship installed. Themes are JSON files that are never executed, and zsh needs no extra process per prompt
  • 23 terminal color schemes, applied to the terminal itself, plus your own colors
  • Fonts and icons: Termhint installs a Nerd Font and turns it on in each terminal, so icons show instead of boxes
  • Tab titles: choose what each tab shows
  • The popup itself: each kind of suggestion gets your choice of icon and color (any SF Symbol, an emoji or your own image)
  • The app: light or dark, six color themes or your own accent

One runtime manager

Install and switch versions of Node, Python, Ruby, Go, Java, Bun, Deno, Zig, Erlang, Elixir, Gleam, .NET, Dart and Julia, plus Xcode. Each folder gets the version it asks for, and every download is checked against its publisher's signature before it installs. It replaces nvm, pyenv, rbenv and friends.

All of it from the shell too

termhint theme set pure
termhint colors list
termhint runtime
Enter fullscreen mode Exit fullscreen mode

How the autocomplete works

A small zsh hook sends each line edit to the app, which finds the cursor and draws a non-activating panel there:

  • Terminal and iTerm2: through the Accessibility API
  • VS Code and other xterm.js terminals: through xterm cursor queries
  • Ghostty, kitty, WezTerm and Alacritty: zsh asks the terminal for the cursor cell and the cell size, so no Accessibility permission is needed

Tab, the arrows, Esc and Enter go to the popup only while it's open, and return to the shell if the app quits.

Privacy

Completions are worked out on your Mac. No tracking, no account, works offline. Notarized by Apple, with signed updates.

Try it

macOS 14 or later on Apple silicon. Free for 7 days with no account and no card, then $11.99 one-time.

brew install --cask toni1703/termhint/termhint
Enter fullscreen mode Exit fullscreen mode

Or download it from termhint.com.

Bugs and feature requests go to termhint-issues on GitHub. I'd love feedback: what would make you drop your current setup?

Top comments (0)