Termhint Get Termhint

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.

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)

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).

Verified downloads and updates

Report a vulnerability

Report security problems privately, never as a public issue:

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.