Skip to content
VoiceHotkeyVoiceHotkey Docs

Shell commands

Requirements

Section titled “Requirements”
  • Enable voice commands master switch on (see Voice commands)
  • Trial or Pro (LicenseFeature.shellCommands)
  • Settings → Voice commands → Allow shell commands (allowShellCommands; not on General)
  • Prefer keeping Confirm shell commands enabled

Behavior

Section titled “Behavior”
  1. A shell action may come from a user dictionary entry or from the intent model as a zsh string.
  2. A confirmation dialog runs by default.
  3. ActionExecutor blocks dangerous patterns such as sudo, rm -rf /, curl | sh / curl | bash, wget | sh, and similar.

Local Only Mode

Section titled “Local Only Mode”

Shell runs on-device. If Local Only blocks the intent LLM, cloud intent cannot generate commands — but a shell phrase already stored in your local user dictionary can still match and run (still gated by Allow shell + confirm).

See also

Section titled “See also”