All pages

Docs · AI features

Hands-free conversation

Availability: macOS.

Hands-free mode is a voice loop: it listens, submits what you said, waits for the reply, reads it aloud, and re-arms the mic — so a whole back-and-forth costs zero keystrokes. It runs only between an explicit start and stop; nothing listens in the background.

Starting a session

  • ⌃⌘I — toggle a session with your last-used target.
  • View → Hands-Free Conversation — the same toggle as a menu item.
  • Waveform button in the agent composer — the button toggles a session; its menu picks the target and starts against it directly.

Two targets

Target What happens
TRMNLY agent Your speech becomes a user turn in the window's agent sidebar; the reply is the assistant's finished message, spoken aloud
Terminal pane Your speech is pasted into the pane that was focused when the session started and submitted with a real Enter — so it drives whatever CLI agent or REPL runs there (Claude Code, aider, codex…). The "reply" is the new output the pane produced once it settled

Switching targets is one gesture in the button's menu, not a trip to Settings.

The loop, visibly

A floating HUD stays up for the whole session and narrates the phase — listening (mic open, waiting for you to finish a sentence), thinking (submitted, waiting on the answer), speaking (reading the reply; mic closed). The panel never takes keyboard focus away from the terminal.

An utterance ends after a short pause in your speech (about a second of silence); the loop then submits and moves to thinking.

Interrupting

The mode is deliberately half-duplex: the mic is closed while the reply is being spoken, because an open mic would transcribe the app's own voice and feed it back as the next prompt. To barge in, press the hotkey again or use the HUD button — speech stops and the mic re-arms immediately.

Stopping

Press ⌃⌘I again, use the HUD, or pick Stop hands-free from the composer button's menu. Stopping tears the session down completely — mic closed, speech cancelled.

  • Dictation (⌘I) — one-shot speech-to-text into the terminal, without the loop, the submit, or the spoken reply.
  • The "hey trmnly" wake word is a separate, independently toggled agent-voice feature — hands-free mode never listens unless you started a session.