Usage
How to use it
Every mode below runs the same loop described in How it works: RECORD → STT → LLM → TTS → PLAYBACK. What changes between modes is how the loop starts, whether it repeats, and who is talking to whom. For a quick printable reference of all functionality see Quicksheet (PDF).
Conversation modeTalk with a single agent, with the full set of in-session keyboard shortcuts.
Debate modeTwo agents talk to each other; join in and redirect at any time.
Read modeRead a file or stdin aloud, phrase by phrase, with an agent voice.
Background modeRun with no terminal, driven by global shortcuts from any application.
PTT / Live modesPush-to-talk (the default) vs. always-listening LIVE mode, and how to configure each.
Single run modeGet one response and exit - built for scripts and automation.
CLI: STT / TTSUse vtmate as a scriptable speech-to-text or text-to-speech tool.