№ 03 · Projects · maintained

Windsurf Installer

Unofficial Bash script to install, update, and remove Windsurf IDE on Linux with SHA256 verification and desktop integration.

Created
Stack
BashLinuxCLIShell
Source
pyyupsk/windsurf-installer

A single Bash script that handles the full lifecycle of Windsurf IDE on Linux — install, update, and uninstall — with no external dependencies beyond standard coreutils.

Features

  • SHA256 verification — every download is checked against the official checksum before extraction
  • Desktop integration — creates a .desktop launcher and symlinks the binary to ~/.local/bin
  • Update-aware — detects the currently installed version and skips if already up to date
  • CLI flags — supports --force (skip prompts), --quiet (minimal output), and --uninstall

Usage

# Install or update
curl -fsSL https://fasu.dev/windsurf | bash

# Force install without prompts
curl -fsSL https://fasu.dev/windsurf | bash -s -- --force

# Uninstall
curl -fsSL https://fasu.dev/windsurf | bash -s -- --uninstall

How it works

  1. Fetches the latest version from the official Windsurf API
  2. Downloads and verifies the .tar.gz archive via SHA256
  3. Extracts to ~/.local/opt/windsurf
  4. Creates a symlink in ~/.local/bin and a .desktop entry for GUI access

The short install URL fasu.dev/windsurf redirects to the raw script on GitHub, making it easy to remember and pipe into bash.