Skip to main content
Control Handless from the command line for automation and scripting.

​
Available Flags

FlagDescription
--toggle-transcriptionToggle recording on/off
--toggle-post-processToggle recording with post-processing
--cancelCancel the current operation
--start-hiddenLaunch without showing the window
--no-trayLaunch without a menu bar icon
--debugEnable verbose debug logging

​
Examples

# Start a transcription from the terminal
handless --toggle-transcription

# Record with post-processing
handless --toggle-post-process

# Cancel current recording
handless --cancel

# Launch in the background
handless --start-hidden --no-tray

# Debug mode
handless --debug
These flags are useful for binding Handless actions to tools like Raycast, Alfred, Hammerspoon, or shell scripts.