# 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
```bash
cargo install aev-audio
```
## Use
Test the ping:
```bash
aev-audio ping
```
From an Aev workspace, keep the watcher running in another terminal:
```bash
aev-audio watch
```
Or point it at a workspace explicitly:
```bash
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:
```text
/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
```bash
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