Skip to content

Instantly share code, notes, and snippets.

@andrescera

andrescera/Install.md

Last active February 9, 2026 00:13
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save andrescera/13c422a07c50257e44b4f73d7fccb2d5 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save andrescera/13c422a07c50257e44b4f73d7fccb2d5 to your computer and use it in GitHub Desktop.
Download ZIP
Install cursor on Linux, tested on Ubuntu 25.04
Raw
install-cursor-on-linux.sh
#!/usr/bin/env bash
# inspired by https://gitrollup.com/r/install-cursor.sh
set -euo pipefail
# =========================
# Cursor (Patched) Installer
# =========================
INSTALL_DIR="/opt"
APP_DIR_NAME="Cursor-patched"
FINAL_APP_PATH="$INSTALL_DIR/$APP_DIR_NAME"
EXECUTABLE_SYMLINK="/usr/local/bin/cursor"
ICON_NAME="cursor-ai.png"
ICON_PATH="/usr/share/icons/hicolor/512x512/apps/$ICON_NAME"
ICON_URL="https://img.icons8.com/nolan/512/cursor-ai.png"
DESKTOP_ENTRY_NAME="cursor-patched.desktop"
DESKTOP_ENTRY_PATH="/usr/share/applications/$DESKTOP_ENTRY_NAME"
ARCH_DEFAULT="$(uname -m)"
case "$ARCH_DEFAULT" in
x86_64) ARCH="x64" ;;
aarch64|arm64) ARCH="arm64" ;;
*) ARCH="x64" ;;
esac
ARCH="${ARCH:-x64}"
PATCH_MARKETPLACE="${PATCH_MARKETPLACE:-0}"
TEMP_DOWNLOAD_DIR="$(mktemp -d)"
APPIMAGE_PATH="$TEMP_DOWNLOAD_DIR/Cursor.AppImage"
cleanup() { rm -rf "$TEMP_DOWNLOAD_DIR" >/dev/null 2>&1 || true; }
trap cleanup EXIT
require_root() {
if [ "${EUID:-$(id -u)}" -ne 0 ]; then
echo "Please run this script as root (e.g., sudo)." >&2
exit 1
fi
}
ensure_deps() {
echo "--> Ensuring dependencies..." >&2
if command -v apt-get >/dev/null 2>&1; then
apt-get update -y >/dev/null 2>&1 || true
apt-get install -y curl libfuse2 gtk-update-icon-cache >/dev/null 2>&1 || true
fi
command -v curl >/dev/null || { echo "curl is required" >&2; exit 1; }
}
resolve_cursor_appimage() {
local arch="${1:-x64}"
local api_url="https://www.cursor.com/api/download?platform=linux-${arch}&releaseTrack=latest"
local response url version
echo "--> Fetching latest version from API..." >&2
response="$(curl -fsSL "$api_url")"
url="$(printf "%s" "$response" | grep -oP '"downloadUrl"\s*:\s*"\K[^"]+')"
version="$(printf "%s" "$response" | grep -oP '"version"\s*:\s*"\K[^"]+')"
if [ -z "$url" ]; then
echo "Error: could not get download URL from API." >&2
exit 1
fi
echo "--> Found Cursor:" >&2
echo " Version: $version" >&2
echo " URL: $url" >&2
printf '%s\n' "$url"
}
download_appimage() {
local url="$1"
echo "--> Downloading AppImage..." >&2
curl -fL "$url" -o "$APPIMAGE_PATH"
chmod +x "$APPIMAGE_PATH"
}
extract_appimage() {
echo "--> Extracting AppImage to $FINAL_APP_PATH ..." >&2
rm -rf "$FINAL_APP_PATH"
( cd "$TEMP_DOWNLOAD_DIR" && "$APPIMAGE_PATH" --appimage-extract >/dev/null 2>&1 )
mv "$TEMP_DOWNLOAD_DIR/squashfs-root" "$FINAL_APP_PATH"
}
maybe_patch_marketplace() {
local product_json
product_json="$(find "$FINAL_APP_PATH" -type f -path '*/resources/app/product.json' | head -n1 || true)"
if [ -z "$product_json" ]; then
echo " product.json not found. Skipping marketplace patch." >&2
return
fi
if [ "$PATCH_MARKETPLACE" = "1" ]; then
echo "--> Applying legacy VS Code marketplace patch..." >&2
sed -i 's|"serviceUrl": "https://marketplace.cursorapi.com/_apis/public/gallery"|"serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery"|g' "$product_json"
sed -i 's|"itemUrl": "https://marketplace.cursorapi.com/items"|"itemUrl": "https://marketplace.visualstudio.com/items"|g' "$product_json"
sed -i 's|"resourceUrlTemplate": "https://marketplace.cursorapi.com/{publisher}/{name}/{version}/{path}"|"resourceUrlTemplate": "https://{publisher}.vscode-unpkg.net/{publisher}/{name}/{version}/{path}"|g' "$product_json"
else
echo " Skipping marketplace patch (PATCH_MARKETPLACE=0)." >&2
fi
}
install_icon_and_launcher() {
echo "--> Installing icon and launcher..." >&2
mkdir -p "$(dirname "$ICON_PATH")"
curl -fsSL "$ICON_URL" -o "$ICON_PATH" || true
gtk-update-icon-cache /usr/share/icons/hicolor >/dev/null 2>&1 || true
ln -sf "$FINAL_APP_PATH/AppRun" "$EXECUTABLE_SYMLINK"
cat > "$DESKTOP_ENTRY_PATH" <<EOL
[Desktop Entry]
Name=Cursor (Patched)
Comment=The AI-first Code Editor
Icon=$ICON_NAME
StartupWMClass=Cursor
Exec=$EXECUTABLE_SYMLINK %U
Type=Application
Categories=Development;IDE;
Terminal=false
EOL
}
main() {
require_root
ensure_deps
echo "--> Target architecture: ${ARCH}" >&2
url="$(resolve_cursor_appimage "$ARCH")"
download_appimage "$url"
extract_appimage
maybe_patch_marketplace
install_icon_and_launcher
echo "Installation complete. Run 'cursor' or find it in your app menu." >&2
}
main "$@"
Raw
Install.md

Cursor Patched Installer

This script provides a system-wide installer for Cursor, the AI-first code editor.
It was originally inspired by install-cursor.sh, but as Cursor's release page and API changed, the original script no longer works reliably.
We adapted and improved the script to ensure it stays functional with the latest Cursor releases.

Improvements Over the Original Script

  • Uses official Cursor API (https://www.cursor.com/api/download?platform=linux-x64&releaseTrack=latest) for reliable version fetching.
  • No HTML scraping — direct JSON API response with version, commit SHA, and download URL.
  • Robust error handling with proper exit codes and sanity checks.
  • Architecture detection (x86_64 → x64, aarch64 → arm64).
  • System-wide installation to /opt/Cursor-patched.
  • Symlink in PATH at /usr/local/bin/cursor for easy launching.
  • Desktop entry + icon installation for menu integration.
  • Optional legacy VS Code marketplace patch (disabled by default).
  • Removed wget dependency — only requires curl.

Quick Install

Run directly from the gist:

curl -sSL https://gist.githubusercontent.com/andrescera/13c422a07c50257e44b4f73d7fccb2d5/raw/install-cursor-on-linux.sh | sudo bash

This will:

  • Detect your architecture (x64 or arm64).
  • Fetch the latest Cursor AppImage URL from the official API.
  • Extract and install Cursor under /opt/Cursor-patched.
  • Create a symlink /usr/local/bin/cursor.
  • Install a system-wide icon and .desktop launcher.

Usage

After installation, launch Cursor:

  • From your application menu → Cursor (Patched)
  • Or run directly in the terminal:
cursor

Optional Settings

  • Force architecture (if detection fails):

    ARCH=arm64 curl -sSL https://gist.githubusercontent.com/andrescera/13c422a07c50257e44b4f73d7fccb2d5/raw/install-cursor-on-linux.sh | sudo bash

  • Enable VS Code Marketplace patch (not guaranteed to work on latest builds):

    PATCH_MARKETPLACE=1 curl -sSL https://gist.githubusercontent.com/andrescera/13c422a07c50257e44b4f73d7fccb2d5/raw/install-cursor-on-linux.sh | sudo bash

Notes

  • Requires curl, libfuse2, and gtk-update-icon-cache (installed automatically on Debian/Ubuntu).
  • Uses official Cursor API which should remain stable across releases.

License

This installer is provided as-is, without warranty.
Inspired by install-cursor.sh and improved for reliability with current Cursor releases.

@Romstar
Copy link

Romstar commented Jan 5, 2026 

  url="$(printf "%s" "$html" \
    | grep -oE "https://downloads\.cursor\.com/[^\"']+/linux/${arch}/[^\"']+\.AppImage" \
    | head -n1 || true)"

    | grep -oE "https://api2\.cursor\.sh/updates/download/golden/linux-${arch}/cursor/[^\"']+" \
    | head -n1 || true)"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment