The dictionary
The dictionary holds two kinds of entry. Vocabulary tells a Whisper model which spelling to prefer when it hears something close — a colleague's name, a product, Kubernetes. Replacements rewrite what was heard into what you want typed, on every model. Parakeet and Cohere do not take vocabulary hints yet, so on those the replacement is the tool. Everything lives on your Mac and works offline.
Why a dictionary at all
A general speech model has never heard of your product, your teammates or the function you named yesterday, so it writes the nearest real words it knows: “coober netties” for Kubernetes, “use effect” for useEffect. Apple Dictation has no way to fix this and gets it wrong the same way forever. FreeFlow's dictionary is the fix people most often say changed their mind about dictation: teach it a word once and it stops being a word you go back and correct.
Vocabulary entries
Open Dictionary in FreeFlow's window and add the word as you want it spelled. From then on, when a take contains something the model heard as close to it, the entry wins. Vocabulary guides the Whisper models; Parakeet does not take vocabulary hints yet (the Dictionary page says so under the field), so for the default Parakeet V3 add the word as a replacement instead — heard-as on the left, your spelling on the right — which rewrites exactly on every model. Entries built around punctuation — C++, .NET, gmail.com — match too (fixed in 1.5.0). Capitalisation is yours: enter iPhone and it stays iPhone.
- Names — colleagues, clients, your own if the model keeps mangling it.
- Products and brands — especially ones spelled unlike they sound.
- Code — identifiers, commands, flags:
kubectl,useEffect,--dry-run,PostgreSQL. - Jargon — the twenty terms your field uses that general English does not.
Replacements
A replacement is a pair: what you say, and what gets typed. “my email” → your address; “sign off” → “Best regards, Priya”; “shrug” → ¯\_(ツ)_/¯. They run after transcription and before formatting, so the text that reaches a mode's Apple Intelligence prompt already has the replacement in it.
What it is not
It does not read your screen, your files or your project to guess words — some dictation tools do, and the trade is that they have to look at everything you have open. FreeFlow's list is only what you put in it, which is also why it works with the network off and why nothing about your vocabulary ever leaves the Mac. For a whole project's identifiers, spend five minutes adding them; the list is a plain file in your data folder and travels with your backups.
Questions people ask
Does the dictionary need the network?
No. It is a local list applied on your Mac after transcription, and it works with Wi-Fi off.
Can an entry contain punctuation or symbols?
Yes — C++, .NET, gmail.com and the like all match since 1.5.0.
Does vocabulary work with Parakeet?
Not yet — vocabulary hints guide the Whisper models. On Parakeet (the default) add the word as a replacement, heard-as → spelling, which rewrites exactly and works on every model.
Is there a limit?
No practical one. People with a few hundred identifiers in it notice no delay.
Can I share it between my Macs?
The dictionary is a file in FreeFlow's data folder (Settings → General → Data folder). Copy it, or keep the folder in a synced location.