Soundtrack

Nimbus can play audio cues to signal task progress — useful when you step away from the terminal.

Enable

In ~/.nimbus/config.toml:

[local]
sound = true

Audio cues

Each cue is a short tone generated in pure Python (no external audio files):

Event	Sound	Description
Task started	Two-note sequence	440 Hz (0.12s) → 550 Hz (0.15s)
Verification passed	Single tone	523 Hz (0.4s) at low volume
Task complete	Three-note sequence	440 Hz → 550 Hz → 660 Hz (ascending)
Task failed	Low tone	220 Hz (0.3s) at low volume

How audio is generated

Sounds are synthesized at runtime using Python's wave module — no audio files are bundled with the package. The synthesizer generates a WAV in memory and plays it via afplay (macOS) or aplay (Linux) in a background thread.

Suppress for one task

nimbus run "fix the login bug" --no-sound

The --no-sound flag suppresses audio for a single run without changing your config.

Troubleshooting

If you hear nothing with sound = true:

• macOS — ensure afplay is available (it's bundled with macOS, should always work)
• Linux — ensure aplay is installed: sudo apt install alsa-utils
• Check your system volume and that the terminal process has audio output permissions