call

/call command

Conversation Mode: a live voice call between the human and a call agent, mediated by voxd. The call agent is a separate, read-only process. It cannot see this session, so you hand it a context snapshot when the call starts, and it hands you a written summary when the call ends. There is no mic:call MCP tool yet -- every verb shells out to the vox call CLI.

Usage

• /call start <topic> -- start a real call about <topic>: real microphone capture, transcribed by ElevenLabs.
• /call start <topic> --script <path> -- dev/test path: scripted turns from a JSON Lines file ({"text": ..., "confidence": ...} per line) instead of the microphone. For demos and CI.
• /call stop -- ask the running call to hang up.

Implementation

start

1. Write the context snapshot yourself. You are the primary session; the call agent starts with nothing but what you give it. In plain prose, cover:

   • the topic (<topic> from $ARGUMENTS) and what the human wants from the call;
   • the current task: what you are working on, the branch, any bead ID;
   • the files that matter, by path;
   • the gist of the recent conversation: decisions made, open questions.

   Before writing it, search with the quarry MCP find tool (a query drawn from the topic) and fold the relevant hits in: what each says, and its source path. Never put the query on a shell command line -- topic text in a shell string can run as a command. Look up external library docs as well if the topic needs them. Keep the snapshot to a briefing -- a page or two, never whole files, never a secret value.

2. Start the call in the background, with the snapshot on stdin through a quoted heredoc so nothing in it is expanded by the shell. The heredoc delimiter is fresh for every call: VOX_CONTEXT_ followed by 8 hex digits you choose at random now -- never a value written in this file -- so no text folded into the snapshot -- a quarry hit, a file excerpt -- can contain the line that ends it early and runs what follows as shell. Check that no line of the snapshot is exactly the delimiter; if one is, pick another. Run this Bash command with run_in_background: true -- vox call start runs for the whole call: