Termhint privacy and security
Updated 19 November 2026All docs
What Termhint reads on your Mac, every connection the app and the termhint command make, what they store and where, and how downloads and updates are verified. The legal policy for purchases and the website is the privacy policy.
Termhint has no analytics, telemetry, crash reporting or advertising code.
What runs locally
Completions are worked out on your Mac and never need the internet.
- zsh sends the command line you are typing, the cursor position and the current folder to Termhint.app on the same Mac, through a pair of named pipes per shell in
$TMPDIR/termhint-<uid>/. Only your user can open that folder (mode 0700, each pipe 0600), and both ends check the owner before they use it. - Command lines can hold secrets. They stay in memory and are never logged, written to a file or sent over the network.
- When the app attaches, zsh also sends the commands on its PATH, its aliases, functions and builtins, to complete the command word. They are kept in memory per shell.
- To complete a line the app reads, on your Mac only: the bundled completion specs, the names in the folder being typed, the nearest
package.json, the Makefile in the folder, the git repository's files (branches, tags, remotes with any password in a URL cut off, stash messages, aliases),~/.ssh/configand the plain host names in~/.ssh/known_hosts, man pages and what your own zsh offers. It asks the local Docker engine, through its Unix socket only, for container and image names. - bash gets prompt themes and colors only; it sends nothing to the app.
What the popup learns
With popup.learn set to runs (the default), when a line runs the app keeps only names it already offers: the command (git, an alias) and the subcommands and options from its spec (git commit -m), with a count and the time of the last use. Never the line, an argument (files, branches, hosts, messages) or the folder. picks learns only rows you pick in the popup; off learns nothing and deletes what was learned. So does termhint uninstall --all. More in autocomplete.
Zed's input method
Zed's input method is off by default. While it is selected it sees every key, as any input method does, and passes each one on unread. It sends only the text cursor's rectangle and Zed's bundle id to Termhint.app, only while Zed has the focus, and keeps and logs nothing.
Network connections
Termhint connects only for the things below, and always over HTTPS.
License checks
| When | To | What is sent |
|---|---|---|
| You enter a license key | Polar, api.polar.sh |
The key, Termhint's Polar organization id, your Mac's model identifier (for example Mac14,2, never its name) and a SHA-256 hash of the hardware UUID with a Termhint-only prefix, which ties the activation to this Mac |
| About every 3 days, and Check Now | Polar, api.polar.sh |
The key, the organization id, the activation id and the same hardware hash |
| Deactivate This Mac… | Polar, api.polar.sh |
The key, the organization id and the activation id |
The hardware UUID itself never leaves the Mac. The requests use a session without cookies, cache or stored credentials, and the app holds no API secret. Polar's answers include the buyer's name and email; Termhint never decodes them, so they are not kept. During the trial Termhint makes no license requests. See license.
Updates
| When | To | What is sent |
|---|---|---|
| Once a day (unless turned off in Settings → App), or when you check by hand | termhint.com/appcast.xml |
An ordinary request from Sparkle: your IP address and the app's name and version. Sparkle's system profile is not turned on |
| You install an update | downloads.termhint.com |
The download request |
See updates.
Runtimes, Xcode and fonts
These run only when you ask: installing a runtime, listing its releases (termhint runtime list-remote or the releases list in Settings → Runtimes), or installing a font. Requests carry the user agent termhint-runtimes/<version>.
| What | To |
|---|---|
| Node | nodejs.org |
| Go | go.dev, dl.google.com and Google's checksum database sum.golang.org |
| Java (Temurin) | api.adoptium.net, GitHub (Adoptium's releases) |
| Python, Ruby, Bun, Erlang, Elixir, Gleam | GitHub (each publisher's releases and attestations, api.github.com) |
| Deno | deno.com, dl.deno.land |
| Zig | ziglang.org |
| .NET SDK | dotnetcli.blob.core.windows.net, builds.dotnet.microsoft.com |
| Dart | storage.googleapis.com |
| Julia | julialang-s3.julialang.org |
| Release lists of Python, Ruby, Bun, Erlang, Elixir and Gleam | index.termhint.com, at most once an hour. Only the list comes from there; checksums and signatures still come from the publisher |
| Checking GitHub attestations and Sigstore bundles | Sigstore's trust root, tuf-repo-cdn.sigstore.dev (cached) |
| Xcode's release list | xcodereleases.com |
| Xcode downloads | Apple (download.developer.apple.com and other *.apple.com hosts), with your Apple developer session |
| Simulator runtimes | Apple's own xcodebuild -downloadPlatform downloads them |
Nerd Fonts (termhint icons install, termhint icons setup, Settings → Terminal → Font) |
GitHub (ryanoasis/nerd-fonts releases) |
- A
GITHUB_TOKENin your environment is sent only tohttps://api.github.com. - Your Apple developer session is sent only to
*.apple.com. You sign in for Xcode downloads on Apple's own page (developer.apple.com) in a window of the app; Termhint never sees your password. - Settings → Runtimes → Other Managers → "Replace with Termhint…" reinstalls your global packages with
npm install -g,gem installandpython3 -m pip install. Those tools connect to their usual registries, as they would if you ran them yourself.
More on runtimes: runtimes and Xcode.
Pages opened in your browser
Buy, Manage Macs and Find My Key in Polar open Polar's checkout or customer portal in your web browser. What you enter there goes to Polar under its own privacy policy.
Problem reports
Report… and Report a Problem… send nothing by themselves. Open on GitHub opens a prefilled issue form in your browser and Email Instead a new mail in your mail app, with Termhint's version, your macOS version and the error (your home folder written as ~). Nothing is filed or sent unless you submit or send it. See report a problem.
What is stored
On disk (~/.config/termhint is $XDG_CONFIG_HOME/termhint when that is set):
| Where | What |
|---|---|
~/Library/Preferences/dev.termhint.Termhint.plist |
Settings: popup look, Settings window state, whether the shell integration is on |
~/.config/termhint/ |
Prompt themes, color schemes, tab title, runtime defaults (tool-versions), the installed shell scripts and the termhint link |
~/.zshrc, ~/.bashrc, the bash login file |
One marked block each, with a backup (.termhint-backup-<date>) made before each change |
| Ghostty, kitty, WezTerm and Alacritty configs; the font settings of VS Code, Cursor, iTerm2 and other terminals | Only after termhint colors native or termhint icons on / setup: a marked block or the setting changed, with a way back (colors native off, icons off) |
~/Library/Application Support/Termhint/Icons/ |
Popup icons you imported |
~/Library/Application Support/Termhint/usage.json |
What the popup learned: command, subcommand and option names with a count and last use. Readable by you only; at most 10,000 uses, older ones fade out |
~/.local/share/termhint/runtimes/ |
Installed runtimes |
~/.cache/termhint/runtimes/ |
Downloads, release lists and Sigstore's trust root |
~/Library/Fonts/ |
Nerd Fonts you installed through Termhint |
$TMPDIR/termhint-<uid>/ |
The pipes to the shells; nothing is written to them but the messages in flight |
In the login keychain, not synced to other Macs:
| Item | What |
|---|---|
"Termhint license" (dev.termhint.Termhint.license) |
The trial's start and, once activated, the key, its Polar ids, the activation id, the Mac limit and the last check. It stays when the app is deleted, so a reinstall does not restart the trial |
dev.termhint.apple-developer-session |
Your Apple developer session, only if you signed in for Xcode downloads |
The license key is entered only in Settings → License, never on the command line, so it is not in your shell history. termhint license shows it masked.
Logs
Termhint writes no log files. The app writes a few lines to macOS's unified log (subsystem Termhint): whether the specs loaded, start-up failures and how many commands get completions. A failed save of what the popup learned is logged under the subsystem dev.termhint. None of them hold a command line.
log show --predicate 'subsystem == "Termhint"' --last 1h
Accessibility
Termhint uses the Accessibility permission only to find the text cursor in another app's window, so the popup opens under it. Programs Termhint starts (the runtime helper, brew, login shells, package installs) run as their own responsible process, so they cannot use Termhint's Accessibility permission. Termhint does not need Screen Recording, Automation or Full Disk Access. Every permission, what works without it and how to revoke it: permissions.
Administrator helper
The administrator helper is optional and off until you turn it on (Settings → Runtimes → Xcode) and approve it in System Settings. It runs as root so that two Xcode steps need no password: Make Default (xcode-select -s) and Finish Setup (Xcode's license and first launch).
- It talks only to Termhint.app, and each end checks the other's code signature.
- It accepts only an Xcode directly in
/Applications, takes no other commands or shell text, and quits a minute after its last request. - Without it, those two steps ask for your administrator password; every argument is quoted and paths with control characters are refused.
Verified downloads and updates
- Runtimes: every download is checked before anything in it runs, against a proof from the publisher: signed checksum files, pinned keys, Developer ID signatures, GitHub attestations or Sigstore bundles, depending on the tool. A missing checksum or signature is a refusal, never a warning. Release lists from
index.termhint.comcount only with a Sigstore bundle from Termhint's own workflow. The helper uses HTTPS only and never follows a redirect down to HTTP. - Nerd Fonts: the publisher provides only SHA-256 sums, so font downloads are checked against those. Fonts are data, not code.
- Xcode: a
.xipmust pass Apple's package signature check, and the Xcode in it must passcodesignfor Apple's team and Gatekeeper. Before Xcode's first launch runs as root, the app is moved into a fresh root-only folder and its signature checked again there. - Updates: Sparkle installs an update only when its EdDSA signature matches the key in the installed app and the new app is signed by the same Developer ID team. Releases are signed with Termhint's Developer ID, use the hardened runtime and are notarized by Apple.
- What reaches the terminal: prompt themes and color schemes are JSON, never executed. Control characters in a folder name, command or text never reach the terminal as escape sequences in the tab title. Version files (
.tool-versions,.nvmrcand others) are read, never run.
Report a vulnerability
Report security problems privately, never as a public issue:
- Report a vulnerability on GitHub (a private form only the maintainer sees), or
- email hello@termhint.com.
Include the Termhint version (in the menu-bar panel's header), your macOS version, what an attacker needs and gains, and the steps to reproduce. Leave real secrets, keys and personal data out of the report.
Privacy policy
The legal privacy policy covers purchases, the website and your rights. Questions: hello@termhint.com.