| name | attention-please |
| description | Play an alert sound and speak "Project NAME needs your attention." Use at the end of a run or whenever Codex needs user input or confirmation; derive the project name from the git remote (origin) with fallback to the repo folder or an override. |
Attention Please
Overview
Play a short audible alert and a spoken prompt indicating which project needs attention. Use this as the final step after completing work or right before asking the user for input. This skill is repo-agnostic and can be used in any repository.
Workflow
- Run from inside the target repo so the script can read the git remote.
- Execute
scripts/attention-please.sh. - Continue with your response to the user.
Project name resolution
- Primary:
git remote get-url originand extract the repo name. - Remote override: set
ATTENTION_PLEASE_REMOTE. - Fallback: repo folder name.
- Override: set
ATTENTION_PLEASE_PROJECT.
Sound and speech
- Sound: macOS
afplaywith/System/Library/Sounds/Ping.aiffby default. - Override sound: set
ATTENTION_PLEASE_SOUND. - Disable sound: set
ATTENTION_PLEASE_NO_SOUND=1. - Speech: macOS
say; if unavailable, the message prints to stdout. - Disable speech: set
ATTENTION_PLEASE_NO_SAY=1. - Voice: set
ATTENTION_PLEASE_SAY_VOICE. - Rate: set
ATTENTION_PLEASE_SAY_RATE.
Message override
- Override the full phrase with
ATTENTION_PLEASE_MESSAGE.
Example
ATTENTION_PLEASE_PROJECT="quiz-juice" ATTENTION_PLEASE_SAY_VOICE="Samantha" scripts/attention-please.sh