Age Of Opencode

Age of Empires II sound effects for OpenCode. Wololo your way through coding sessions.

This is an OpenCode port of the original age-of-claude plugin for Claude Code, structured after opencode-warcraft-notifications and event-matched with opencode-notifier.

What it does

Plays a different Age of Empires II sound effect on each key OpenCode lifecycle event:

Event	Sound
Client connected	Game startup / Claude startup sound
Session started	Game startup sound
Permission prompt	Priest "Wololo" (you are being converted to approve)
Question tool invoked	"I need food" / "Gold please" / "Give me some stone" (the agent needs input)
Assistant response complete	Random villager work / "yes" / satisfaction sound
Subagent complete	Villager "ready" training complete sound
Plan exit	"Yes!" / "Aww yeah!" / "Attack them now!"
User message	Silence (minimal interruption)
User cancelled	"Get out!" / "No!" / "I'm weak, please don't kill me"
Session error	Random soldier death sound / crowd wailing

46 authentic AoE II .wav files are bundled in data/sounds/.

Requirements

• OpenCode (Bun-based runtime)
• A working audio backend on your platform:
  • macOS: afplay (built-in)
  • Linux: paplay, aplay, or ffplay (one of)
  • Windows: PowerShell (built-in) — partial support, your mileage may vary

Installation

From npm

Add the package name to your OpenCode config:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["age-of-opencode"]
}

Restart OpenCode. Done.

From a local checkout

Clone the repository into your OpenCode plugin directory. OpenCode auto-loads files placed directly in ~/.config/opencode/plugin/ (singular) globally, or in .opencode/plugin/ per-project.

git clone https://github.com/Stijnvandenbroek/age-of-opencode.git ~/.config/opencode/plugin/age-of-opencode

Then add a tiny loader file so OpenCode picks up the plugin from its subdirectory:

~/.config/opencode/plugin/age-of-opencode-loader.ts

export { AgeOfOpencodePlugin } from './age-of-opencode/index.ts';

Restart OpenCode and you should hear the startup sound on your next session.

Note: the directory is plugin (singular), not plugins. OpenCode only scans the singular directory for auto-loaded plugin files. If your plugin is silent, double-check the path and look for a service=plugin path=...age-of-opencode-loader.ts loading plugin line in the latest log file under ~/.local/share/opencode/log/.

Configuration

The plugin reads a couple of environment variables — no config file is required.

Variable	Effect
AGE_OF_OPENCODE_DISABLE	Set to 1 to silence the plugin without uninstalling it.
AGE_OF_OPENCODE_VOLUME	Float between 0.0 and 1.0. Default 0.3. Currently honored on macOS via afplay -v.
AGE_OF_OPENCODE_DEBUG	Set to 1 to enable debug logging to the OpenCode log file.

Example:

AGE_OF_OPENCODE_VOLUME=0.5 opencode

Supported events

This plugin handles the following OpenCode events (matching those in opencode-notifier):

SDK Event	Plugin Event	When it fires
client_connected	client_connected	Shortly after plugin startup
session.created	session_started	New top-level session created
permission.asked	permission	Permission prompt shown
tool.execute.before (question)	question	Question tool invoked
session.idle	complete / subagent_complete	Assistant response complete
tool.execute.before (plan_exit)	plan_exit	Plan ready for review
message.updated (role=user)	user_message	User sends a message
session.error (MessageAbortedError)	user_cancelled	User cancelled the session
session.error (other)	error	Session encountered an error

Note: session.idle from the SDK maps to complete for top-level sessions and subagent_complete for subagent sessions, with a 350ms debounce.

How it works

OpenCode loads the plugin at startup and the plugin subscribes to SDK events via the standard event hook, plus the permission.ask and tool.execute.before hooks. When an event fires, the plugin picks a matching sound at random from a thematic pool and plays it using your platform's audio player (afplay on macOS, paplay/aplay on Linux). Playback uses await and will block the event handler briefly, but sounds are short (under 5 seconds) so the impact is minimal. Missing audio binaries result in silence — no errors are thrown.

Project structure

.
├── index.ts                # re-exports the plugin
├── src/
│   └── plugin.ts           # main plugin: event handler + sound dispatch
└── data/
    └── sounds/             # 46 bundled AoE II .wav files

Acknowledgments

• Original Claude Code plugin: kylesnowschwartz/age-of-claude
• OpenCode plugin pattern reference: pantheon-org/opencode-warcraft-notifications
• Event reference: mohak34/opencode-notifier
• Sound effects from Age of Empires II by Ensemble Studios / Microsoft.

License

MIT — see LICENSE.

The bundled .wav files originate from Age of Empires II (Ensemble Studios / Microsoft) and are included for personal, non-commercial use only.