aev-audio

aev-audio is the minimal completion-sound plugin for Aev from Trevor Knott / Knott Dynamics. It watches Aev's existing local event journal and writes one terminal bell when assistant output completes.

It has no third-party dependencies, audio assets, daemon framework, network service, or changes to the Aev crate.

Package

• Crate and binary: aev-audio
• Plugin ID: aev-audio
• Plugin entrypoint: aev_plugin_init
• Protocol: aev.plugin.v1
• Repository: https://github.com/Tknott95/AevAudio

Install

cargo install aev-audio

Use

Test the ping:

aev-audio ping

From an Aev workspace, keep the watcher running in another terminal:

aev-audio watch

Or point it at a workspace explicitly:

aev-audio watch --workspace /path/to/project

The watcher starts at the end of .aev/journal.jsonl, so old completions do not ring. Use --from-start to process existing events or --once to exit after the first new completion.

The sound is the standard terminal bell (BEL, byte 0x07). It is dependency-free and portable, but the terminal or desktop must have audible bells enabled.

Aev Registration

The current Aev plugin board validates plugin descriptors but does not launch plugin code. Register the contract with:

/plugins add aev-audio git https://github.com/Tknott95/AevAudio.git aev_plugin_init notification,audio,completion,journal-watch
/plugins validate all

Run aev-audio watch separately until Aev gains dynamic plugin lifecycle hooks.

Manifest

aev-audio manifest

The library exports aev_plugin_init as a C ABI symbol and returns the aev.plugin.v1 manifest.

Privacy

aev-audio reads only .aev/journal.jsonl. It does not read assistant content, contact a network service, or write project files.

License

MIT