Skip to Content
DocumentationDictate with MacWhisper

Dictate with MacWhisper

Susi has no microphone of its own. It works with dictation tools such as MacWhisper, which type or paste what you say into the focused field. The prompt editor and the ⌘K field both take dictation.

Dictate a prompt

Open Susi with ⌘⇧Space and dictate. The text goes in at the caret or replaces the selection, like anything you type.

Right after ⌘↵, the next time you open Susi, the whole prompt you sent is selected. Dictating then starts a new prompt; press → first to add to the old one.

Say an action

  1. Select what to change, or nothing for the whole prompt.
  2. Press ⌘K.
  3. Say the action’s name or one of its aliases: “Shorten”, “make shorter”, “fix grammar”.

When the dictated phrase is pasted into the field and it is exactly the name or an alias of an action, the action runs at once, with no Enter. Case, punctuation and accents do not matter, so “Make shorter.” runs Shorten. The shipped aliases include Russian phrases too: «Сделай короче» runs the same action.

Typing never runs an action by itself, and neither does a tool that enters dictation as typed keystrokes rather than a paste. Press Enter then: the action you named is at the top of the list.

Say what you want

Any other phrase becomes an instruction in your own words, marked Instruction. It is the first row when no action matches it well and it is a sentence of three words or more, or when nothing matches at all: press Enter to send it to the model with your selection.

“Turn this into a checklist for the agent.”

The model answers in the language of your text, whatever language you speak the instruction in. Actions and instructions →

Teach Susi your phrases

The phrases that run an action are its aliases in rules.json. Add the way you naturally say it, and dictating that phrase runs the action. Add your own actions →

The dictionary

⌘L shows a third section, Dictionary: the terms in dictionary.json, each with the spoken form and the spelling you want, such as Mac Whisper → MacWhisper. In this release the list is for reference. Susi does not replace terms in dictated text, because dictation tools already correct spelling themselves. Enter on a term opens dictionary.json in your text editor. Library and files →