Guides › How to Install Walkie-Talkie Mode on OpenCode

How to Install Walkie-Talkie Mode on OpenCode

Walkie-talkie mode lets you redirect the AI mid-response by typing /ptt, speaking your correction, and typing /ptt again. This guide covers installation on any platform.

1
Install sox
OpenCode uses sox for microphone access. Install it: sudo apt install sox (Linux), brew install sox (macOS).
2
Add the plugin
Add "opencode-interrupt-plugin" to the plugin array in your opencode.json (project root or ~/.config/opencode/opencode.json).
3
Install Whisper
Run bash scripts/install-whisper.sh from the plugin repo. This clones whisper.cpp, builds it, and downloads the base model (~140MB).
4
Restart OpenCode
Kill your session and run opencode again. The plugin loads automatically. Type /ptt in any session to test recording.
Tips
• Set MODEL=small environment variable before the install script for better accuracy with non-native accents.
• Type /ptt a second time to stop recording and send the transcript automatically.
• The free tier works immediately — no license key needed.

Troubleshooting

If /ptt does nothing, check that sox is installed (which sox) and that the plugin appears in opencode plugin list. Check logs at ~/.local/share/opencode/log/.

Ready to try it?

Get started free →