Voice commands¶
Hold the system key and say any of these. Run vupai voice-commands for a
cheat sheet tailored to your config.
| Say | What happens |
|---|---|
| "create 3 panes" | Spin up N auto-named panes, tiled (up to 30; "create 2 shell panes" picks the program) |
| "focus atlas" | Focus the atlas pane (also "switch to / go to") |
| "swap atlas and sage" | Swap two named panes |
| "zoom atlas" / "unzoom" | Maximize a pane / restore the layout |
| "layout tile" / "layout main vertical" | Re-layout the window; the lead word layout is required ("layout grid", "layout even horizontal", …) |
| "close atlas" / "kill atlas" | Close a pane (asks y/n by default) |
| "board" | Open the supervision board (one per session) |
| "open review" | Open a full-window diff review of the session (one per session) |
| "read atlas" / "read all" | Speak a pane's summary aloud (read board for a digest) |
| "clear atlas" / "clear all" | Send a slash command (/clear) to a pane or every agent |
| "everyone, pull main" | Broadcast the message to every named agent |
| "connect to box" / "ssh box" | SSH the focused pane into a configured host |
| "mute" / "unmute" / "stop" | Silence/restore talk-back, or cut off the current read |
| "louder" / "quieter" | Nudge readback volume (tts_volume, macOS say only) |
| "note: fix the retry logic" | Append the text to this repo's task pile (.vupai/tasks.md) |
| "read tasks" / "tasks" | Speak the repo's open tasks aloud |
| "open tasks" | Open a live tasks pane (like the board) showing this repo's pile |
| "triage" / "groom the tasks" | LLM-graded importance/effort for the pile; one confirm popup writes visible [p1, S] tags (conflicts are spoken only) |
| "edit tasks" | Open the pile in your $EDITOR (tmux split) to delete or reword items |
| "open sage" | Summon a squad member by name (squad.toml); no confirm, one live incarnation |
| "open squad" | Open a live squad pane showing the roster and who's up (also "show squad") |
| "atlas, run the tests" | Not a command, so it falls through to name addressing |
No mic at hand? Everything above also works typed: see silent mode.
See it in action¶
See in the status bar (when it changes to yellow) what was said (system key held).
Panes and layout¶
🎙 "create 3 panes" → "focus atlas" → "swap atlas and sage" → "zoom atlas" → "minimize" → "clear all"
Spin up a set of auto-named agent panes, jump between them by name, and
rearrange the window without touching the prefix key. ("close atlas" works
too; it asks y/n first, confirm_destructive)
Talking to agents¶
🎙 "atlas, write me a poem" → "everyone, introduce yourself in one line" → "clear all"
Anything that is not a command is routed as speech-to-pane: it goes to the focused pane, or to the agent you name first, from anywhere. The broadcast word sends one message to every named agent, and "clear …" delivers a slash command instead of text.
Supervising the session¶
🎙 "everyone, write me a poem" → "open board"
The board keeps a one-line summary per agent; "read …" speaks a pane's summary aloud; review shows every uncommitted change in the session, grouped by the pane that made it.
Capturing tasks¶
🎙 "note: the login flow needs retry logic" → "open tasks"
Thoughts land in the repo's task pile without touching a pane: a popup previews the transcription, the tasks pane keeps the pile in view, and triage grades importance and effort in one confirm. It is also possible to open the tasks board via the menu (bottom right on status bar).
Summoning the squad¶
🎙 "open squad" → "close squad" → "open vista" → "vista, who are you?"
A squad member launches pre-briefed in a pane carrying their name
and role on the border; the squad pane shows the whole roster and who's up.
You can configure your own squad at ~/.config/vupai/squad.toml.