Set up notifications
Get a sound or a custom action when an agent becomes blocked or finishes, and mute the noise you don't want.
Muxie can notify you when something needs your attention — for example, when an agent becomes blocked or finishes. You configure this under Settings → Notifications.
Choose a sound
notificationSound sets the sound played on a notification:
none— no sound.default— the built-in sound.custom— play a sound file you choose.
When you pick custom, set notificationSoundPath to point at your sound file.
Run a custom command
notificationCommand is a shell command Muxie runs on each notification. The command receives MUXIE_NOTIFY_* environment variables describing the event, so you can route notifications anywhere you like — a desktop tool, a chat webhook, or your own script.
Mute the noise you don’t want
notificationMutePatterns is a list of patterns that suppress both the banner and the sound when a notification matches. Each pattern is either:
- a plain substring, or
- a regular expression written as
/regex/flags.
Tip: Start with broad mute patterns and narrow them as you learn which notifications you actually want.
When notifications fire
Notifications fire on agent state changes, such as an agent becoming blocked or done. See Agent awareness for how Muxie tracks those states.
You can also send a notification yourself with the muxie notify CLI call — useful from a script or a long-running task. See the CLI reference.