Guides › Installing OpenCode Interrupt on Linux

Installing OpenCode Interrupt on Linux

Linux is the primary platform for OpenCode and the interrupt plugin. Everything works out of the box with minimal setup. This guide covers all major distributions.

1
Install system dependencies
Ubuntu/Debian: sudo apt install sox git cmake build-essential curl. Arch: sudo pacman -S sox git cmake base-devel curl. Fedora: sudo dnf install sox git cmake gcc-c++ curl.
2
Add the plugin
Add "opencode-interrupt-plugin" to your opencode.json. OpenCode downloads the npm package automatically — no npm install needed.
3
Install Whisper
Run bash scripts/install-whisper.sh from the plugin directory. This compiles whisper.cpp from source. On Arch, ensure base-devel is installed first.
4
Start OpenCode
Launch opencode. The plugin loads automatically. Type /ptt in any session to test the walkie-talkie.
Tips
• On Ubuntu, pulseaudio/pipewire should be running for sox mic access. Test with rec test.wav from the command line.
• If you use i3wm, the /ptt command is a typing-based toggle — no keybinding configuration needed.
• For Fedora, you may need to install pipewire-utils for sox compatibility.

Troubleshooting

If sox cannot access the mic, check your audio group membership: groups $USER | grep audio. If missing, add yourself: sudo usermod -a -G audio $USER and log out/in.

Ready to try it?

Get started free →