Termhint Get Termhint

Termhint menu bar and Settings window

Updated 19 November 2026All docs

Termhint lives in the menu bar. This page goes through the panel under its icon, the app menu, and each section of the Settings window. Most controls have a settings key that termhint settings reads and changes; each is linked to the settings reference.

The menu-bar icon

A click on Termhint's icon in the menu bar (left or right button) opens the panel. A second click on the icon, Esc, or a click elsewhere closes it. A small dot on the icon means a newer version of Termhint was found.

The menu-bar panel

From top to bottom:

Notes and the locked card

Setup card

The status of the zsh setup, as Settings → Terminal → Apps shows it, with the one thing left to do:

Status Text Button
Autocomplete is on New zsh tabs get suggestions as you type. none
One step left Allow Accessibility, so the popup opens right at the cursor. Allow Accessibility…
Setup needs attention Why ~/.zshrc could not be updated Open Terminal Settings
Autocomplete is off Turn it on for suggestions in every new zsh tab. Turn On

Overview

Four tiles:

Tile Shows Control
Terminal tabs How many zsh tabs are connected to Termhint now, or "None connected" none
Commands How many commands have a bundled completion spec ("… supported"). Point at it to see how many of the commands on this Mac's PATH get completions, from the latest terminal tab none
Accessibility Allowed or Not allowed Allow, while it is not allowed
Open at login On, Off or Needs approval A switch (app.open-at-login)

Customize

One tile for each section of Settings: Popup, Terminal, App, Runtimes, License. A click opens Settings on that section.

Last row

The app menu

While Settings is open, Termhint is in the Dock and has an app menu in the menu bar:

Item What it does
About Termhint macOS's About window, with the version
Check for Updates… Checks now and answers in the update window either way
Report a Problem… The same as Report… in the panel
Settings… (⌘ ,) Opens Settings
Hide Termhint (⌘ H) Hides Termhint's window
Quit Termhint (⌘ Q) Quits Termhint

Quit on the Dock icon only closes Settings: autocomplete keeps running. Closing the window takes Termhint out of the Dock again.

The Settings window

Open it with Settings… in the panel or the app menu (⌘ ,), a tile under Customize, by opening Termhint.app again, or with a click on the Dock icon. It opens by itself on the first launch.

Changes apply at once; there is no Save button. A change made with termhint settings set shows in the window too.

⌘ 1. The popup as it looks now, in a terminal window mock-up with real suggestions, pinned above the controls so each change shows while you scroll. A click on a part of the previewed popup opens that part's settings right there. Drag its bottom-right corner to resize it. More about the popup itself is in Autocomplete.

Pick a look: 12 ready-made popup looks: System, Rose, Rose Dark, Aurora, Lagoon, Graphite, Nord, Dracula, Catppuccin, Tokyo Night, Solarized Light and GitHub Light. Point at one to see it in the preview; a click uses it. A theme sets colors only; the size and font stay. The terminal's own colors are under Terminal → Colors.

Parts

Each part's settings: a button for each part opens the same menu as a click on it in the preview. Parts that are off are here, so you can turn them back on.

Part Control Key
The popup Appearance: System, Light or Dark popup.theme
Background: Blurred (like menus), Solid color or Gradient popup.background
Color, or Colors for a gradient (start and end) popup.background-color, popup.gradient-color
Opacity (solid and gradient backgrounds) popup.background-opacity
Corners popup.corner-radius
Width popup.width
Rows shown popup.rows
Names Font popup.font
Size popup.font-size
Color popup.text-color
Matched letters (their color) popup.match-color
Matched letters bold popup.bold-matches
Descriptions Show popup.descriptions
Line them up: In a column or On the right popup.description-alignment
Color popup.description-color
Selected row Highlight (its color) popup.selection-color
Details Show the details of the selected item: its kind and whole description popup.details
Key hints Show the footer with the position in the list and the keys popup.hints

A color row has a Default button that goes back to the color that follows the system. Under 380 pt wide, the popup's rows show names only; from 680 pt, the details move beside the list.

Icons

One for each kind: Command, Option, Value, Script, File, Folder and Suggestion, each with its icon as the popup draws it.

Commands

Where the popup stays away:

Terminal

⌘ 2. Your prompt, colors and font as your terminals draw them. The pill beside the title shows the setup status (as in the panel's setup card); a click opens Apps. Above every tab but Apps, a terminal preview shows the prompt and colors in use, in the chosen font; a click on anything in it opens its menu right there. The tabs:

Prompt

The parts, glyphs and every option are on Prompt themes.

Colors

More on Terminal colors.

Font

See Terminal icons.

Tab Title

See Tab titles.

Apps

Which terminals need what is on Supported terminals.

App

⌘ 3. How the Settings window and the panel look; the popup keeps its own look under Popup.

Card Control Key
Light or dark System, Light or Dark app.appearance
Pick your colors Rose, Ocean, Violet, Mint, Amber, Graphite or Custom app.colors
Your own colors Accent app.accent
Glow, top left app.glow-lead
Glow, bottom right app.glow-trail
Keep Termhint up to date Check automatically: once a day none

Changing a color under Your own colors switches to Custom. See Updates for what the update check sends.

Runtimes

⌘ 4. Language versions that Termhint installs and switches per project. The pill beside the title shows how many versions are installed, or the install under way.

Details are on Runtimes and Xcode.

License

⌘ 5. Your free trial or license. It stays open while the rest of Settings is locked.

See License.