diff --git a/README.md b/README.md
index 4a84135..f0ab5ff 100644
--- a/README.md
+++ b/README.md
@@ -155,6 +155,71 @@ The installation script will:
 
 Feel free to submit issues or pull requests for improvements.
 
+## VMware Workstation Installation
+
+### Script: `install-vmware-workstation.sh`
+
+Automated installation script for VMware Workstation on CachyOS. This script:
+- Installs VMware Workstation from the official bundle
+- Builds kernel modules (vmmon, vmnet) with clang/lld to match CachyOS kernel
+- Loads kernel modules and starts services
+- Verifies installation
+
+### Prerequisites
+
+- CachyOS Linux
+- VMware Workstation bundle file (download from VMware website)
+- Root/sudo access
+
+### Usage
+
+```bash
+# Download VMware Workstation bundle from https://www.vmware.com/products/workstation-pro.html
+
+# Make the script executable
+chmod +x install-vmware-workstation.sh
+
+# Run with sudo (auto-detects bundle in ~/Downloads)
+sudo ./install-vmware-workstation.sh
+
+# Or specify bundle path explicitly
+sudo ./install-vmware-workstation.sh /path/to/VMware-Workstation-Full-*.bundle
+```
+
+### What it does
+
+1. Checks for required packages (kernel headers, build tools, clang, lld)
+2. Installs missing dependencies via pacman
+3. Runs VMware Workstation installer
+4. Builds vmmon and vmnet kernel modules using clang (matching CachyOS kernel compiler)
+5. Installs and loads kernel modules
+6. Enables and starts VMware services
+7. Verifies everything is working
+
+### Troubleshooting
+
+If the installation fails:
+
+1. Check kernel headers are installed:
+   ```bash
+   pacman -Q linux-cachyos-headers
+   ```
+
+2. Verify build tools:
+   ```bash
+   pacman -Q base-devel clang lld
+   ```
+
+3. Check VMware service status:
+   ```bash
+   systemctl status vmware
+   ```
+
+4. Verify kernel modules:
+   ```bash
+   lsmod | grep -E "vmmon|vmnet"
+   ```
+
 ## License
 
 MIT License - Feel free to use and modify these scripts.