Signal
A VS Code extension that plays a sound when an OpenCode prompt finishes.
Install
Install the packaged extension from this folder with:
code --install-extension opencode-signal-0.1.4.vsix
Reload VS Code after installation if it is already running.
How It Works
The extension listens to OpenCode's local server event stream and watches for a session becoming idle or entering an error state. It also handles completions when the watcher missed the initial busy event.
- OpenCode's official VS Code integration is detected automatically through
_EXTENSION_OPENCODE_PORT.
- Use Signal: Open Watched Terminal if you start OpenCode manually.
- A server on port
4096 is watched by default. Change signal.defaultPorts if needed.
- Use Signal: Test Sound to verify audio playback.
- If Kilo Code is installed, Signal disables Kilo Code's separate attention sound so only Signal's sound plays.
For a manually started OpenCode process, use a fixed port so the extension can connect:
opencode --port 4096
Settings
signal.enabled: enable or disable sounds.signal.defaultPorts: ports to discover automatically.signal.soundFile: optional custom sound path.signal.showNotification: also show a VS Code notification.
In Settings, the Sound File description includes a Browse for a sound file action that opens the native file picker and saves the selected path.
The included sound.wav is bundled and used by default. A custom soundFile overrides it.
Development
npm install
npm test
Press F5 in VS Code to launch an Extension Development Host.
Publish Updates
Set VSCE_PAT in the OpenCode terminal using a Marketplace PAT with Marketplace > Manage permission, then run:
npm run release:patch
Use npm version minor --no-git-tag-version && npm run publish or npm version major --no-git-tag-version && npm run publish when appropriate. To only create a local package, run npm run package:vsix.
