Table of Contents
keyboardmaestro CLI Tool
You can use the keyboardmaestro CLI Tool to trigger or edit macros.
The keyboardmaestro command line tool is included within the Keyboard Maestro.app package, in the Contents/MacOS folder, so if the Keyboard Maestro.app package is installed in the normal location in the /Applications folder, the path to the command will be:
/Applications/Keyboard Maestro.app/Contents/MacOS/keyboardmaestro
You might like to make a link from the /usr/local/bin folder like this:
sudo ln -s '/Applications/Keyboard Maestro.app/Contents/MacOS/keyboardmaestro' /usr/local/bin/keyboardmaestro
Or include an alias to the command like this:
alias keyboardmaestro='/Applications/Keyboard\ Maestro.app/Contents/MacOS/keyboardmaestro'
then:
keyboardmaestro [options...] <macro name/uid>
Like most CLI tools, you can ask for help by passing the argument --help. The arguments are:
| Short | Long | Meaning |
|---|---|---|
| -a | –async | Do not wait for macro to complete |
| -e | –edit | Edit the macro instead of triggering it |
| -h | –help | Show the help message |
| -p | –parameter <value> | Pass value as the %TriggerValue% parameter.\ Use - to read the value from stdin |
| -v | –verbose | Show debugging information |
| -V | –version | Show version number |
This command will edit or trigger a Keyboard Maestro macro as specified.
The macro name can be the name of a unique macro, the UUID of a macro, or the XML of an action to execute.
In edit mode, the macro name can be the name or UUID of a macro, macro group or smart macro.