Docs/Tutorials/Teach it your words
Tutorials

Teach it the words you use

4 min read

You dictate a prompt, and the one word that matters comes out wrong. Your product name, your repository, the library nobody outside your team has heard of. You fix it by hand, and the next time you dictate it happens again.

This walks you through fixing that permanently - about five minutes, once. You need DevThrottle running and a Gateway connected. You do not need an agent running, and you do not need your phone.

  1. Open the Dictionary in the Cockpit

    Open the Cockpit in your browser and choose Dictionary in the left rail. What you are looking at belongs to your Gateway, not to this browser or this machine - which is the whole point. Teach it here and every Director connected to that Gateway gets it, along with transcription of anything you record on your phone.

  2. Add the word under Vocabulary

    Click + add term, type the word the way it should be spelled, and press Enter. It appears as a chip. Add as many as you like before moving on - product names, repository names, the tools you say out loud all day.

    This list nudges speech-to-text toward your words when it hears something close. It is the half that prevents the mistake.

  3. Tell it the wrong spellings you actually saw

    Under Common mistranscriptions, click + add a term to correct and enter the correct spelling. A row appears with a + wrong spelling box beside it. Put in what you really got - if dictation gave you "dev throttle" and "def throttle", add both.

    Use what you have genuinely seen rather than what you imagine it might do. This half is a cleanup pass that runs after transcription, and it only acts on spellings you have listed.

  4. Save

    Click Save. The button goes inactive once there is nothing unsaved, which is how you know it took. If you try to leave the page with unsaved edits it stops you and asks first.

    The Cockpit Dictionary page with seven vocabulary chips including DevThrottle and Kubernetes, and a correction row pairing DevThrottle with the wrong spellings dev throttle and def throttle
    The Cockpit Dictionary page with seven vocabulary chips including DevThrottle and Kubernetes, and a correction row pairing DevThrottle with the wrong spellings dev throttle and def throttle
  5. Say it again

    Go back to a session and dictate a sentence with the word in it. There is nothing to restart and nothing to copy anywhere - the change applies on your very next dictation.

What is worth adding

Start with the words you say most and that are least like ordinary English: your product, your repositories, your framework names. Do not try to fill this in one sitting. The useful habit is to add a word the moment it annoys you - by then you know both the right spelling and the wrong one, which is exactly what the two lists want.

Tip
You do not have to do this by hand. Your agents can reach the dictionary too, so "add Kubernetes to my dictation dictionary" is a single instruction to any connected agent.
Note
DevThrottle also scans your dictations overnight and offers terms it thinks it keeps getting wrong - that is the banner across the top of the page. You can take its suggestions or ignore them; nothing changes until you save.

Next

For what each list does under the hood, how the cleanup pass is deliberately limited, and what happens if the dictionary is unavailable, see Your dictation dictionary. If you have not tried dictating yet, start with Talk to your agents instead of typing.