Voice mode
Talk to an agent pane over a real-time voice call, configure voice preferences, and review call history.


In this guide
Voice mode opens a spoken conversation with a supported agent or worker pane. It uses OpenAI's Realtime API for audio, on AgentGrid's key, so there is no API key to set up. The call stays attached to the pane you were already using.
Before the first call
Voice calls are part of AgentGrid Pro and the free trial. Use Settings -> Call to choose:
- The realtime voice.
- Playback speed from 0.25x to 1.5x.
- The language used for the opening greeting.
Settings save automatically.
Starting a call
Click the Phone / Call button in a supported pane header. AgentGrid loads the pane's latest transcript as context, then the overlay connects and begins streaming captions and audio. If transcript loading fails, the call doesn't start and AgentGrid shows the error.
On Free, the call button opens a prompt to upgrade or start a trial.
Each call can run for up to 10 minutes, then wraps up on its own. There are also hourly and daily limits on calls.
Only one call can be active across AgentGrid at a time. Other call buttons remain unavailable until the current call ends.
Start from a supported pane's Call action. AgentGrid allows one active call at a time and keeps completed call transcripts and summaries.
Diagram by AgentGridControls
The overlay includes rolling captions, a mic-level waveform, mute, and hang up. Copy transcript copies the captions so far.
| Control | Action |
|---|---|
| CmdMCtrlM | Toggle mute. |
| EscEsc | End the call. |
These work when the call overlay has focus, or nothing in the window does. CmdMCtrlM needs an active call, and does not start one.
Push-to-talk dictation
Push-to-talk is a separate in-app dictation shortcut. AgentGrid must be the focused application for it to fire. Dictation is a Pro feature that runs on AgentGrid dictation, with no API key to add.
- Hold Cmd;Ctrl; to speak and release to transcribe into the focused input, without sending. In a text box your words appear as you speak; in a terminal the text is typed when you release.
- Record any other binding, or clear it, under Settings -> Shortcuts.
Your own Deepgram or OpenAI key isn't used on any plan. On Free, push-to-talk and microphone buttons show an upgrade prompt.
Push-to-talk is suppressed while a realtime call is active so two microphone paths do not compete.
Dictation records from your system's default input unless you pick another under Settings → Dictation → Microphone. The choice applies to push-to-talk, the composer microphone, note dictation and voice calls. If the chosen microphone is unplugged, they use the system default.
Composer controls
In a desktop worker, GUI team lead or Coordinator composer, click the microphone to dictate with Pro. While it listens, a live waveform of your mic level sits next to the timer, flat in silence, and your words appear in the composer as you speak. If live transcription fails, AgentGrid transcribes the recording when you stop instead. Stop inserts the transcript without sending; Stop and send inserts it and submits once if sending is still allowed. In shell mode, submitting runs the command.
Cancel or EscEsc discards the recording or pending transcription. An error offers Dismiss; record again to try again. Clips are not kept for retry. At 10 minutes, dictation stops and inserts without sending, with a warning one minute before. Dictation cannot start during a voice call.
Call history and handoff
AgentGrid stores completed call transcripts and summaries. Click the history button in a pane's header, or choose Call history from the workspace explorer's filter menu, to review calls by pane, read the transcript and summary, or reveal the underlying call log in the file manager.
When a call ends, AgentGrid generates a structured wrap-up. For a terminal-backed master session, that wrap-up is staged into the originating pane so the typed conversation can continue with the decisions and next actions from the call.
Related
- Coding harnesses - supported runtimes and capability differences.
- Mobile app - the mobile companion can connect to a paired desktop.
- Keyboard shortcuts - current default bindings.