reminder
Play audio alerts via ffplay when Codex finishes a task, encounters an error/abort, or needs user help; use in WSL environments with the reminder-tool audio prompts and map events to TASK_FINISHED, ERROR, or NEED_HELP.
When & Why to Use This Skill
This Claude skill provides real-time audio notifications to monitor AI agent activities and task statuses. By leveraging ffplay, it delivers immediate acoustic feedback for successful task completion, execution errors, or instances where the agent requires user intervention. Specifically optimized for WSL (Windows Subsystem for Linux) environments, it enhances the observability of autonomous workflows, allowing developers to stay informed without constantly monitoring the terminal.
Use Cases
- Background Task Monitoring: Receive a 'TASK_FINISHED' audio alert when a long-running autonomous coding or research task completes, enabling efficient multitasking.
- Instant Error Notification: Get immediate acoustic feedback via the 'ERROR' prompt if the agent encounters a failure or aborts a process, reducing downtime during debugging.
- Interactive Workflow Support: Use the 'NEED_HELP' alert to notify the user when the agent is blocked or requires manual input, ensuring timely human-in-the-loop transitions.
| name | reminder |
|---|---|
| description | Play audio alerts via ffplay when Codex finishes a task, encounters an error/abort, or needs user help; use in WSL environments with the reminder-tool audio prompts and map events to TASK_FINISHED, ERROR, or NEED_HELP. |
Reminder
Overview
Use ffplay to play short MP3 alerts for task completion, errors, or help-needed moments. Keep usage optional and non-intrusive.
Workflow
- Determine the event type.
- Task completed successfully ->
TASK_FINISHED - Task failed or aborted ->
ERROR - Waiting for user input or blocked ->
NEED_HELP
- Task completed successfully ->
- Play the matching sound once with
ffplay(avoid repeated alerts for the same event). - If
ffplayis unavailable or playback fails, continue without blocking and optionally mention the missing dependency.
Command usage
Use ffplay with no display and auto-exit:
ffplay -nodisp -autoexit assets/audio/TASK_FINISHED.mp3
ffplay -nodisp -autoexit assets/audio/ERROR.mp3
ffplay -nodisp -autoexit assets/audio/NEED_HELP.mp3
Notes
- Audio files live in
assets/audio/*.mp3; adjust the path if you store them elsewhere. - Audio playback requires WSL audio support and
ffplayin PATH.