Guides › Installing OpenCode Interrupt on macOS
Installing OpenCode Interrupt on macOS
macOS is fully supported with Homebrew providing all system dependencies. The plugin works identically to Linux with slightly different package commands.
1
Install Homebrew dependencies
brew install sox git cmake curl. These provide mic access (sox), build tools (cmake), and download capabilities (curl).
2
Add the plugin
Add "opencode-interrupt-plugin" to ~/.config/opencode/opencode.json. OpenCode handles the download from npm automatically.
3
Install Whisper
Run bash scripts/install-whisper.sh. The script clones whisper.cpp, builds it, and downloads the base model to ~/.local/bin/.
4
Restart and test
Restart OpenCode. Type /ptt in any session — the mic should activate and you should see a toast notification. Type /ptt again to stop and transcribe.
Tips
• On macOS, grant terminal/OpenCode mic permission in System Settings > Privacy & Security > Microphone when prompted.
• The Homebrew cmake version works fine for building whisper.cpp. Xcode command line tools are not required.
• Set EDGE_TTS_VOICE to en-US-AriaNeural for a natural American English voice.
Troubleshooting
If sox fails with "Invalid audio device", check your default input device in System Settings > Sound > Input. sox uses the system default device.