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:
Header
- Termhint, "Autocomplete for zsh".
- Trial pill: the time left in the free trial (Trial · …). A click opens Settings → License. Not shown once you have a license.
- Locked pill: shown instead when Termhint is locked. A click opens Settings → License.
- Version pill: the version you run. A click checks for updates: a spinner while it checks, then "Up to date" for a moment if nothing is newer, with no window. When a newer version is found, the pill reads Update · and the version, and a click opens the update window. See Updates.
Notes and the locked card
- A note in orange when the app could not start, with the reason.
- When Termhint is locked: why, "Autocomplete and prompt themes are off.", and Buy or Enter Key, which opens Settings → License. See License.
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
- Settings… (⌘ ,): opens Settings.
- Report…: report a problem as a GitHub issue or an email. See Troubleshooting.
- Quit Termhint (⌘ Q): quits Termhint. Autocomplete stops until you open it again.
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.
- Sections: a bar at the top with Popup, Terminal, App, Runtimes and License, also ⌘ 1 to ⌘ 5. Settings opens on the section you used last.
- Look menu: at the top right, the window's mode (System, Light, Dark) and colors (Rose, Ocean, Violet, Mint, Amber, Graphite, Custom), and Customize Colors…, which opens App. ↑ and ↓ preview a choice on the window; Esc puts the old one back. This changes only the Settings window and the panel, never the popup.
- Reset buttons: beside the title, Reset Popup on Popup, Reset App Look on App, and Reset Prompt on Terminal → Prompt while your own prompt is in use.
- Locked: when the trial is over or the license cannot be checked, every section but License is dimmed and does not respond. See License.
Changes apply at once; there is no Save button. A change made with termhint settings set shows in the window too.
Popup
⌘ 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.
Popup themes
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.
- Show (
popup.icons) and Colorful (popup.colorful-icons): icons at all, and icons on a badge in each kind's color. - Change… for a kind: an SF Symbol, an emoji or up to two characters, or your own image. The color well beside it sets its color; Default puts back the icon Termhint comes with. Dangerous items stay red.
Commands
Where the popup stays away:
- Command names switch, "Suggest the command as you type it" (
popup.command-names): as you type the first word, the commands on your PATH, aliases, functions and builtins are suggested. - Learn from (
popup.learn): Commands you run (every line that runs, typed or picked), Popup picks (only rows picked in the popup) or Off (learns nothing and deletes what it learned). The commands, subcommands and options you use rank higher; only their names are kept, never arguments. - Command box and Add (
popup.off-for): commands the popup never opens for, also aftersudo. Type a name, or several separated by commas. The × on a chip removes it.
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
- Pick a prompt: Yours (made here), the ready-made themes, or Shell's Own (Termhint leaves the prompt to your
.zshrc). Key:prompt.theme. - Make it your own: for Yours. Lines (
prompt.lines) with Empty line before (prompt.blank-line-before); Look: Colored text or Blocks (prompt.look), and for blocks, where a block ends: Flat, Arrow, Round or Slanted (prompt.edge). - Parts: every part of the prompt, by line and on the right, as buttons that open the same menu as in the preview. Add Text adds words or a symbol of your own. The order is
prompt.order.
The parts, glyphs and every option are on Prompt themes.
Colors
- Pick a scheme: the color schemes as tiles, with All, Dark or Light and a search field. Point at one to preview it; a click uses it in your terminals (
colors.scheme). A scheme changed by hand shows as Yours. - Use in my terminals: off, each terminal keeps its own colors. Picking a scheme turns it on.
- Beyond the prompt: Color the command while it is typed (
colors.syntax) sets the colors of zsh-syntax-highlighting and zsh-autosuggestions; Color file lists (colors.lists) colorslsand completion lists where nothing else does; Every color opens the window's colors and the 16 colors to change one by one (colors.custom).
More on Terminal colors.
Font
- Draw your terminals in: On this Mac lists the Nerd Fonts with letters you have, plus Each terminal's own. The Nerd Fonts list beside it has a search field and Get to download one.
- At the bottom: how many terminals use the chosen font, Choose Apps… (opens Apps, where each terminal has a Font switch) and Use in Every Terminal.
See Terminal icons.
Tab Title
- Set the tab title (
terminals.tab-title): on, every zsh and bash tab shows the parts below; off, the terminal names its tabs itself. - Between parts (
terminals.tab-title.separator). - Parts: Shown and Not shown, as buttons that open each part's menu. Add Text adds words of your own. The order is
terminals.tab-title.order.
See Tab titles.
Apps
- Setup status: the same four states as the panel, with the reason when
~/.zshrccould not be updated. Turn Off removes the block from~/.zshrc; Turn On adds it (a backup is saved first). Key:terminals.integration. - Your terminal apps: each terminal app on this Mac in a table with four columns: Autocomplete (a check where the popup works), Icons (Nerd Font icons in that app), Font (the font from the Font tab in that app) and Colors (the colors in the app's own settings file, for Ghostty, kitty, WezTerm and Alacritty;
colors.native.<terminal>in the settings reference). The Colors switches need Use in my terminals on, under Colors. Each switch changes that app's own settings; off puts back what was there. Set Up Icons installs a Nerd Font where one is missing and turns icons on wherever Termhint can. A fold below lists every terminal autocomplete works in. - Autocomplete in Zed (
terminals.zed-input): shown when Zed is installed or the switch is on. Off by default. A hidden input method tells Termhint where Zed's cursor is; it never reads what you type. - Access and startup: Accessibility with Allow… (Allowed once granted;
app.accessibilityreports it), Open at login (app.open-at-login), and Open Login Items when macOS needs your approval. - Short name: the name
termhintalso answers to (thby default) and Apply (terminals.short-name). The name is checked as you type; a taken name cannot be applied. See Install.
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.
- Languages: every language in a list; the one picked shows its installed versions (Set as Default, Remove…) and Versions for this Mac, newest first, with Install. For Xcode: Make Default, the Apple Developer account (Sign In…, Sign Out…), the Administrator helper (Turn On…, Turn Off), Finish Setup and Simulators….
- Other Managers: version managers such as nvm or pyenv, and languages installed with Homebrew, each with Replace with Termhint… or Remove with Homebrew…, and Look Again.
Details are on Runtimes and Xcode.
License
⌘ 5. Your free trial or license. It stays open while the rest of Settings is locked.
- Status: the time left in the trial with a progress bar; or Licensed, with the key, how many Macs it covers and when Polar last confirmed it, and Check Now, Manage Macs (Polar's customer portal) and Deactivate This Mac…; or Locked, with the reason.
- Buy a license: one button for each license, which opens Polar's checkout.
- Enter your key: the key field and Activate, and Find My Key in Polar.
See License.