# Windsurf Installer

> An unofficial Bash script that installs, updates, and removes Windsurf IDE on Linux. It verifies downloads with SHA256 and adds desktop integration.

A single Bash script that handles the full lifecycle of [Windsurf IDE](https://windsurf.com) on Linux. It can install, update, and uninstall the IDE. It needs no external dependencies beyond standard coreutils.

## Features

- SHA256 verification: The script checks every download against the official checksum before extraction.
- Desktop integration: The script creates a `.desktop` launcher and links the binary to `~/.local/bin`.
- Update-aware: The script detects the installed version and skips the update if it is already current.
- CLI flags: The script supports `--force` (skip prompts), `--quiet` (minimal output), and `--uninstall`.

## Usage

```bash
# 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. The script fetches the latest version from the official Windsurf API.
2. The script downloads the `.tar.gz` archive and verifies it with SHA256.
3. The script extracts the archive to `~/.local/opt/windsurf`.
4. The script 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. This makes it easy to remember and pipe into Bash.