Configuration¶
vupai reads ~/.config/vupai/config.toml. vupai setup writes it on first run,
pre-filled with every key at its default and an inline comment explaining it, so
the file itself is the reference. It's left untouched if one already exists, and
vupai config --init tops it up with any keys a newer version added without
disturbing your edits. Editing is optional; open the file to see them all.
Applying changes. The daemon reads its config once at startup, so a change
takes effect only after it respawns. The interactive commands (vupai setup,
vupai keys, vupai mic) apply their change automatically: if a daemon is
running, they reload it for you. But edits you make by hand to
config.toml or hosts.toml are not watched, so run vupai reload to pick
them up (or vupai --reload to reload and attach in one step).
The keys most people touch:
| Key | What it does |
|---|---|
hotkey / command_hotkey |
The dictation and system push-to-talk keys (pynput names; each a list, so you can bind several). |
pane_command |
Default program for voice-created panes (e.g. claude). |
broadcast_word |
Leading word that injects to every named agent (default everyone). |
board_summarizer_cmd |
Command that summarizes panes for the board and read (see Supervision board). |
[programs] / [aliases] / [macros] / [slash_commands] |
Spoken-token tables: program names, pane-name aliases, phrase macros, and slash verbs. |