// troubleshooting guide · keyboard maestro
Keyboard Maestro Execute Shell Script Command Not Found
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 15, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · keyboard-maestro/shell-script-command-not-found2 FIXES
// quick answer
The Execute Shell Script action runs in non-interactive bash with an empty default PATH, so installed commands are not found. Set PATH inside the script.
Most likely fix: Set PATH in the action
How to fix it
// try these in order, the most common fix is first
FIX 1Set PATH in the action
- 01Add export PATH=/opt/homebrew/bin:/usr/local/bin:$PATH at the top of the script
Did this fix it?FIX 2Use full paths
- 01Call commands by absolute path such as /opt/homebrew/bin/jq
Did this fix it?
Symptoms
A script that works in Terminal fails in a macro with command not found.
Why it happens
- C-01Empty default PATH
- C-02Non-interactive shell does not load your profile
// this guide also covers
- keyboard maestro shell script path
- keyboard maestro command not found
Still not working?
If Keyboard Maestro keeps failing, you're not alone. See every Keyboard Maestro problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All audio, video & device problems guides →
AutoHotkey Hotkeys Not Working on Non-English Keyboard Layouts (AutoHotkey)
TextExpander Keyboard Not Expanding on iPhone (TextExpander)
PowerToys Keyboard Manager Not Working (Microsoft PowerToys)
Other Keyboard Maestro errors
- Keyboard Maestro Macros Not Firing
- Keyboard Maestro Not Working After macOS Update
- Keyboard Maestro Typed String Trigger Not Working
- Keyboard Maestro Secure Input Blocking Macros
- Keyboard Maestro Engine Not Launching at Login
- Keyboard Maestro Click at Found Image Not Working
- Keyboard Maestro Actions Not Working on macOS Tahoe
- Keyboard Maestro Macros Not Saving