All pages
Docs · AI features
Dictation
Availability: macOS.
Dictation types what you say into the focused terminal pane. It's raw speech-to-text — no command grammar, no agent, no auto-submit: the transcript is inserted as literal text at the prompt, and you press Return yourself.
Starting and stopping
Three ways in, all landing in the same capture:
- ⌘I — toggle. Press to start, press again to stop and insert.
- View → Dictate into Terminal — the same toggle as a menu item.
- Mic button (right-sidebar header) — supports two gestures:
- Quick tap — latches recording on; tap again (or ⌘I) to stop and insert.
- Press-and-hold — push-to-talk; release to insert.
While recording, a small floating HUD shows the live partial transcript and your input level. The HUD never steals keyboard focus from the terminal.
Where the text lands
The target pane is captured when you start — so the text is inserted where you were looking even if focus drifts (to the HUD, another window) while you speak.
Text is delivered when recording stops, not streamed live: the recognizer keeps revising the whole utterance as it hears more, and a terminal can't cleanly retract characters that were already typed. The HUD's live transcript is your feedback in the meantime.
Permissions and privacy
Dictation uses Apple's speech recognition and needs the standard Microphone and Speech Recognition permissions the first time you use it (shared with the agent's voice input). On the Mac, TRMNLY does not force on-device recognition, so macOS may send the audio to Apple to transcribe, as it does for system dictation. The agent's optional Whisper mode sends audio to OpenAI (or the endpoint you set) instead. Nothing listens until you start a recording, and the mic closes the moment you stop.
Related voice features
- Hands-free conversation — a full voice loop with the agent or a CLI tool in a pane: listen, submit, speak the reply, re-arm (⌃⌘I).
- Agent voice input — the mic in the agent composer transcribes into the agent's text box instead of the terminal, understands the "agent, …" command grammar, and can optionally listen for the "hey trmnly" wake word.