A simple Bash script to install, update, or uninstall the Windsurf IDE on Linux.
- 🚀 Install or update the latest version of Windsurf IDE
- 🔐 Verifies downloads using SHA256 checksums
- 🖥️ Automatically creates desktop integration (icon + launcher)
- 📋 Clean and informative logs: success, errors, and warnings
Make sure the following tools are installed before running the script:
- Core utilities:
curl,tar,grep,sed,mktemp,basename,dirname,cut
Install Windsurf IDE:
curl -fsSL https://fasu.dev/windsurf | bashForce installation without confirmation prompts:
curl -fsSL https://fasu.dev/windsurf | bash -s -- --forceQuiet installation with minimal output:
curl -fsSL https://fasu.dev/windsurf | bash -s -- --quietCombined force and quiet installation:
curl -fsSL https://fasu.dev/windsurf | bash -s -- --force --quietView the install script for more details.
- Fetches the latest Windsurf IDE version from the official API
- Checks for updates if already installed
- Downloads and verifies the
.tar.gzarchive (SHA256) - Extracts and installs to
~/.local/opt/windsurf - Creates:
- A symlink in
~/.local/bin - A desktop entry for GUI access
- A symlink in
To completely remove Windsurf IDE:
curl -fsSL https://fasu.dev/windsurf | bash -s -- --uninstallForce uninstallation without confirmation:
curl -fsSL https://fasu.dev/windsurf | bash -s -- --uninstall --forceThis will delete:
~/.local/opt/windsurf~/.local/bin/windsurf~/.local/share/applications/windsurf.desktop
| Issue | Solution |
|---|---|
| Missing dependencies | Script will notify you. Install missing tools with your package manager (e.g., apt, dnf, yum, pacman) |
| Checksum verification failed | Retry after checking your internet connection |
| Desktop entry missing | Ensure update-desktop-database is installed or check installation dir manually |
We welcome contributions!
- Fork the repo
- Create a feature branch
- Make your changes
- Open a pull request with a clear description
Please follow existing code style and keep your changes focused.
- Windsurf IDE is developed by Windsurf.
- This installer is unofficial and created by @pyyupsk to streamline Linux installation and management.
This installation script for Windsurf IDE is not officially associated with, endorsed by, or affiliated with Windsurf (https://windsurf.com), the original developers of Windsurf IDE. This script is provided as an independent, third-party tool to facilitate installation of the software.
The script is provided "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the script is with you.
By using this installation script, you acknowledge that you are using an unofficial installation method and accept all associated risks. Please visit https://windsurf.com for official downloads and installation methods.