opencode-rts-sounds

RTS sound effects plugin for OpenCode. Plays iconic voice lines from StarCraft, Warcraft III, and Command & Conquer: Red Alert when things happen in your coding session.

Install

Add opencode-rts-sounds to the plugin array in your OpenCode config file.

The config file is at ~/.config/opencode/opencode.json (global) or opencode.json (project-level).

{
  "plugin": ["opencode-rts-sounds"]
}

OpenCode installs npm plugins automatically at startup. No other steps needed.

From source

git clone https://github.com/spartandingo/opencode-rts-sounds.git
cp -r opencode-rts-sounds/index.js opencode-rts-sounds/themes ~/.config/opencode/plugins/

Themes

Six built-in themes are available:

Set theme via config file

Create ~/.config/opencode/sounds/config.json:

{
  "theme": "protoss-zealot"
}

Set theme via environment variable

export OPENCODE_RTS_THEME=redalert-soviet

The environment variable overrides the config file.

Switch theme with slash command

Use the /rts-theme command inside OpenCode:

/rts-theme warcraft-orc

Run /rts-theme without an argument to see available themes.

Switch theme via AI

Ask the AI to switch themes naturally — it has access to an rts_set_theme tool:

switch to the red alert soviet theme

Both methods take effect immediately without restarting OpenCode.

Mute / Unmute

Toggle with slash command

Use the /mute command inside OpenCode to toggle sounds on or off:

/mute

A toast notification confirms the new state. When unmuting, a confirmation sound plays.

Toggle via AI

Ask the AI naturally — it has access to an rts_mute_toggle tool:

mute the sounds

Mute state persists across sessions (stored in ~/.config/opencode/sounds/config.json).

Events

StarCraft (Terran)

StarCraft (Protoss Zealot)

Warcraft III (Human / Orc)

Red Alert 3 (Allied / Soviet)

Custom Themes

Create your own theme by adding a JSON file to ~/.config/opencode/sounds/themes/.

Example: custom theme with downloadable sounds

Create ~/.config/opencode/sounds/themes/my-theme.json:

{
  "name": "my-theme",
  "label": "My Custom Theme",
  "soundPacks": {
    "my-sounds": {
      "url": "https://example.com/sounds.zip",
      "files": {
        "path/inside/zip/ready.wav": "ready.wav",
        "path/inside/zip/done.wav": "done.wav",
        "path/inside/zip/error.wav": "error.wav",
        "path/inside/zip/waiting.wav": "waiting.wav"
      }
    }
  },
  "eventSounds": {
    "session.created": ["ready.wav"],
    "session.idle": ["done.wav"],
    "session.compacted": ["error.wav"],
    "session.error": ["error.wav"],
    "permission.asked": ["waiting.wav"]
  }
}

Example: custom theme with local sound files

If you already have sound files, skip soundPacks and place your .wav files directly in ~/.config/opencode/sounds/<theme-name>/:

{
  "name": "my-local-theme",
  "label": "My Local Theme",
  "eventSounds": {
    "session.created": ["startup.wav"],
    "session.idle": ["complete.wav"],
    "session.compacted": ["warning.wav"],
    "session.error": ["error.wav"],
    "permission.asked": ["question.wav"]
  }
}

Then place your files in ~/.config/opencode/sounds/my-local-theme/.

Theme format reference

Custom themes with the same name as a built-in theme will override it.

How it works

Sound files are downloaded automatically on first run from The Sounds Resource and cached in ~/.config/opencode/sounds/<theme-name>/. No sound files are distributed with this package. Switching themes downloads a new set of sounds.

Audio playback uses child_process.spawn with platform-native commands -- no additional dependencies required.

Platform support

Migrating from opencode-starcraft

Replace opencode-starcraft with opencode-rts-sounds in your config. The StarCraft theme is the default, so it works identically out of the box.

Credits

• Sound files from their respective games via The Sounds Resource
• StarCraft is a trademark of Blizzard Entertainment, Inc.
• Warcraft is a trademark of Blizzard Entertainment, Inc.
• Command & Conquer is a trademark of Electronic Arts Inc.
• Sounds are downloaded on demand and not distributed with this package

License

MIT