Skip to content

[voice_commands]

Experimental. Disabled by default. Parses a spoken prefix at the start of the transcript after ASR to select cleanup styles or insert snippets.

[voice_commands]
enabled = false
prefix = "skald"
OptionTypeDefaultDescription
enabledbooleanfalseWhen true, parse voice commands from transcript text.
prefixstring"skald"Required spoken prefix (case-insensitive matching). ASR may split this into two words (Skald); both are recognized.

When enabled, a transcript starting with the prefix can:

  • Select a cleanup style — e.g. skald professional thanks for the update
  • Trigger snippet-only insertion — e.g. skald signature with an empty remainder
  • Route to named snippet aliases configured in snippets/ and command registry

The prefix and command word are stripped from text sent to cleanup and insertion.

Terminal window
# Enable [voice_commands] in config.toml first
skald commands test "skald professional hey john thanks"
skald commands conflicts

skald config validate checks voice command aliases for conflicts with snippets.

  • Requires clear pronunciation of the prefix; noisy environments may mis-trigger.
  • Does not replace compositor shortcuts; it routes after transcription.
  • See snippet and style docs under Related files.