status

Plugin Status

Run a health check on the notif-sound plugin and report the results.

Run ALL of these checks:

1. Check scripts are executable:

ls -la "${CLAUDE_PLUGIN_ROOT}/scripts/play-sound.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/gui-server.sh" 2>/dev/null

1. Check sound files exist:

ls -1 "${CLAUDE_PLUGIN_ROOT}/sounds/" 2>/dev/null | grep -E '\.(mp3|wav)$' || echo "NO_SOUNDS"

1. Check audio player is available:

if [ "$(uname -s)" = "Darwin" ]; then
  command -v afplay && echo "PLAYER_OK" || echo "PLAYER_MISSING"
elif command -v paplay 2>/dev/null; then
  echo "PLAYER_OK (paplay)"
elif command -v aplay 2>/dev/null; then
  echo "PLAYER_OK (aplay)"
else
  echo "PLAYER_MISSING"
fi

1. Check python is available (python3, python, or py):

PYTHON_FOUND=false
for cmd in python3 python py; do
  if command -v "$cmd" &>/dev/null; then
    "$cmd" --version
    PYTHON_FOUND=true
    break
  fi
done
[ "$PYTHON_FOUND" = false ] && echo "PYTHON_MISSING"

1. Read current config:

cat "${CLAUDE_PLUGIN_DATA}/config.json" 2>/dev/null || echo '{"volume": 4} (default, no config file yet)'

1. Check if GUI server is running:

curl -s http://localhost:6998/api/status 2>/dev/null && echo "GUI_RUNNING" || echo "GUI_STOPPED"

1. Check the platform:

uname -s

1. Present a clear status report to the user:

   Plugin Status

   • Scripts: whether play-sound.sh and gui-server.sh are executable (fix with chmod +x if not)
   • Sounds: count of .mp3/.wav files found (suggest /notif-sound:add if none)
   • Audio player: which player was detected (afplay/paplay/aplay) or missing
   • Python 3: installed or missing
   • Volume: current setting (1-10). If on Windows (uname starts with MINGW or MSYS), show "(not supported — system volume only)"
   • GUI: running or stopped
   • Overall: "All good" if everything passes, or list what needs fixing

   Use checkmarks for passing checks and X marks for failures. If everything passes, confirm the plugin is fully operational.