Cursor AI IDE Installer and Updater Script

install_cursor.sh

#!/bin/bash

installCursor() {
    local CURSOR_URL="https://downloader.cursor.sh/linux/appImage/x64"
    local ICON_URL="https://miro.medium.com/v2/resize:fit:700/1*YLg8VpqXaTyRHJoStnMuog.png"
    local APPIMAGE_PATH="/opt/cursor.appimage"
    local ICON_PATH="/opt/cursor.png"
    local DESKTOP_ENTRY_PATH="/usr/share/applications/cursor.desktop"

    echo "Checking for existing Cursor installation..."

    # Detect the user's shell
    local SHELL_NAME=$(basename "$SHELL")
    local RC_FILE=""

    case "$SHELL_NAME" in
        bash)
            RC_FILE="$HOME/.bashrc"
            ;;
        zsh)
            RC_FILE="$HOME/.zshrc"
            ;;
        fish)
            RC_FILE="$HOME/.config/fish/config.fish"
            ;;
        *)
            echo "Unsupported shell: $SHELL_NAME"
            echo "Please manually add the alias to your shell configuration file."
            return 1
            ;;
    esac

    # Notify if updating an existing installation
    if [ -f "$APPIMAGE_PATH" ]; then
        echo "Cursor AI IDE is already installed. Updating existing installation..."
    else
        echo "Performing a fresh installation of Cursor AI IDE..."
    fi

    # Install curl if not installed
    if ! command -v curl &> /dev/null; then
        echo "curl is not installed. Installing..."
        sudo apt-get update
        sudo apt-get install -y curl || { echo "Failed to install curl."; exit 1; }
    fi

    # Download AppImage and Icon
    echo "Downloading Cursor AppImage..."
    curl -L "$CURSOR_URL" -o /tmp/cursor.appimage || { echo "Failed to download AppImage."; exit 1; }

    echo "Downloading Cursor icon..."
    curl -L "$ICON_URL" -o /tmp/cursor.png || { echo "Failed to download icon."; exit 1; }

    # Move to final destination
    echo "Installing Cursor files..."
    sudo mv /tmp/cursor.appimage "$APPIMAGE_PATH"
    sudo chmod +x "$APPIMAGE_PATH"
    sudo mv /tmp/cursor.png "$ICON_PATH"

    # Create a .desktop entry
    echo "Creating .desktop entry..."
    sudo bash -c "cat > $DESKTOP_ENTRY_PATH" <<EOL
[Desktop Entry]
Name=Cursor AI IDE
Exec=$APPIMAGE_PATH --no-sandbox
Icon=$ICON_PATH
Type=Application
Categories=Development;
EOL

    # Add alias to the appropriate RC file
    echo "Adding cursor alias to $RC_FILE..."
    if [ "$SHELL_NAME" = "fish" ]; then
        # Fish shell uses a different syntax for functions
        if ! grep -q "function cursor" "$RC_FILE"; then
            echo "function cursor" >> "$RC_FILE"
            echo "    /opt/cursor.appimage --no-sandbox \$argv > /dev/null 2>&1 & disown" >> "$RC_FILE"
            echo "end" >> "$RC_FILE"
        else
            echo "Alias already exists in $RC_FILE."
        fi
    else
        if ! grep -q "function cursor" "$RC_FILE"; then
            cat >> "$RC_FILE" <<EOL

# Cursor alias
function cursor() {
    /opt/cursor.appimage --no-sandbox "\${@}" > /dev/null 2>&1 & disown
}
EOL
        else
            echo "Alias already exists in $RC_FILE."
        fi
    fi

    # Inform the user to reload the shell
    echo "To apply changes, please restart your terminal or run the following command:"
    echo "    source $RC_FILE"

    echo "Cursor AI IDE installation or update complete. You can find it in your application menu."
}

installCursor

install_cursor_instructions.md

Cursor AI IDE Installer and Updater Script

Description:

This script installs or updates the Cursor AI IDE on Linux systems. It downloads the AppImage, sets up an application menu entry, and adds a shell alias (cursor) for easy usage. The script supports multiple shells (bash, zsh, fish) and gracefully handles updates.

Features:

• Downloads and installs the Cursor AI IDE AppImage and icon.
• Adds a .desktop entry for the system's application menu.
• Configures an alias for quick access (cursor).
• Automatically detects the user's shell and modifies the appropriate configuration file.
• Allows overwriting the existing installation for updates.

Prerequisites:

• Some users have reported crashes due to compatibility issues with other versions of libfuse. To prevent this, ensure you have libfuse2 installed by running:

  sudo apt install libfuse2

Instructions:

1. Copy the script into a file, e.g., install_cursor.sh.

   curl https://gist.githubusercontent.com/Kinyugo/9845e18998744ff54b8f0cde3bb37182/raw/a9425582958c14f80acea08e51c49b1bf63840c7/install_cursor.sh

   or

   wget https://gist.githubusercontent.com/Kinyugo/9845e18998744ff54b8f0cde3bb37182/raw/a9425582958c14f80acea08e51c49b1bf63840c7/install_cursor.sh

2. Make the script executable:

   chmod +x install_cursor.sh

3. The automatic download feature is no longer working because Cursor has changed their download URL.

   1. Go to the cursor-ai-downloads repository and copy the latest Cursor download link.
   2. Replace the CURSOR_URL variable inside the installCursor function with the new link.

4. Run the script

   ./install_cursor.sh

5. Restart your terminal or run the following command:

   source /path/to/terminal/config

Thanks man

@SamuelWakoli welcome

curl https://gist.githubusercontent.com/Kinyugo/9845e18998744ff54b8f0cde3bb37182/raw/install_cursor.sh | sh

cursor

Thank you for this!!

it for macOS, not win?

@morisono This is for Linux. Windows and Macs don't need this, they have full installers.

thanks so much, @Kinyugo.
Just a suggestion to add installing fuse2.(also note other versions of fuse are crushing the system on Ubuntu 24, but fuse2 is fine)

super helpful, if anyone needs to create a system service to update on boot, also though it was helpful:
https://gist.github.com/wayum999/3c142d6f3f5ad25efcf4cb835a8e85a6

I have gotten the cursor IDe in my apps but its not opening i dont know why

I have gotten the cursor IDe in my apps but its not opening i dont know why

@maddy30445r I faced some permission issues with cursor.appimage....try checking if it has execute permissions

@tzvaita was the fuse2 crash occurring only when using cursor?

It got fixed when I downloaded the appimage file from official site and then run it separately with libfuse after giving chmod +x permission I had to run using --no-sandbox

…

On Thu, Feb 20, 2025, 1:49 AM Kinyugo ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ @tzvaita <https://github.com/tzvaita> was the fuse2 crash occurring only when using cursor? — Reply to this email directly, view it on GitHub <https://gist.github.com/Kinyugo/9845e18998744ff54b8f0cde3bb37182#gistcomment-5446074> or unsubscribe <https://github.com/notifications/unsubscribe-auth/AUPDLDCMQHVR2BSRSGQP2XT2QTRMJBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDUOJ2WLJDOMFWWLO3UNBZGKYLEL5YGC4TUNFRWS4DBNZ2F6YLDORUXM2LUPGBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTGNJVG4ZDQMJVU52HE2LHM5SXFJTDOJSWC5DF> . You are receiving this email because you commented on the thread. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .

@maddy30445r i had similar issues when trying to install via the older instructions available elsewhere, and I also had to remove everything that did including the folder in your /opt or elsewhere, as well as removing the .desktop file you might have created and the icon. Once you remove all that and you no longer see it in your list of applications, try running the install script in this post again, and it should work nicely.

@maddy30445r the script should be doing all that, apart from the libfuse part. Not sure why it didn't work for you.

Thank you for this!!

Thank you for providing this!

let me make it simple for everyone!

curl https://gist.githubusercontent.com/Kinyugo/9845e18998744ff54b8f0cde3bb37182/raw/6d795fba682ab40da2b20a04ffc6bcae62863caa/install_cursor.sh | bash

@szeyu sudo is not needed

curl https://gist.githubusercontent.com/Kinyugo/9845e18998744ff54b8f0cde3bb37182/raw/6d795fba682ab40da2b20a04ffc6bcae62863caa/install_cursor.sh | bash

@Kinyugo thanks man this's amazing! saved me tons of time

@szeyu sudo is not needed

curl https://gist.githubusercontent.com/Kinyugo/9845e18998744ff54b8f0cde3bb37182/raw/6d795fba682ab40da2b20a04ffc6bcae62863caa/install_cursor.sh | bash

ok I also updated mine thanks

Thank you @Kinyugo but this script didn't help me much
After running the script, it has just installed the version 0.45 of cursor while the v.48 is already out. I don't know what went wrong, I need some help to upgrade my Cursor.

Hiya @odilson-dev -- it's not the script that's not working, it's something with the Cursor "latest" link (https://downloader.cursor.sh/linux/appImage/x64). For some reason, even though newer versions have been released, this link consistently pulls down 0.45.

This repo keeps an up-to-date list of the latest Cursor releases. If you replace the CURSOR_URL var in this script with the latest Linux link (or whatever version you'd like) in the script, you'll be in business.

In my fork of this script, I've added a prompt to replace the default URL with another for ease of use, with a fallback to the existing "latest" URL if none is provided.

Some fixes — see my fork.

If nececessary, please run the command below.

curl https://gist.githubusercontent.com/markruler/2820bd05d613c61dac906814a4e282b7/raw/install_cursor.sh | sh
# source ~/.bashrc
# cursor

I only changed two lines in the script.

+ local response=$(curl -s "https://www.cursor.com/api/download?platform=linux-x64&releaseTrack=stable")
+ local CURSOR_URL=$(echo "$response" | jq -r '.downloadUrl')
- local CURSOR_URL="https://downloader.cursor.sh/linux/appImage/x64"

@markruler thanks

Some fixes — see my fork.

If nececessary, please run the command below.

curl https://gist.githubusercontent.com/markruler/2820bd05d613c61dac906814a4e282b7/raw/install_cursor.sh | sh
# source ~/.bashrc
# cursor

I only changed two lines in the script.

+ local response=$(curl -s "https://www.cursor.com/api/download?platform=linux-x64&releaseTrack=stable")
+ local CURSOR_URL=$(echo "$response" | jq -r '.downloadUrl')
- local CURSOR_URL="https://downloader.cursor.sh/linux/appImage/x64"

Hi @markruler,

The help and effort is very much appreciated, thank you so much!

I must also say that linking or making a commands that would run a code from your repo and putting it in this repo (which is not mine and I do not know a person who owns it) is not nice in one perspective, and not secure for the end user from other perspective. Many people will not check for the code they would run by using the command you have posted.

The correct way would be to fork a repo, make a change, create pull request to the original repo, and make a post once the code is merged.

I have nothing against you, I just want to point out the concern about security and author's feelings.

Hope you understand.

Hiya @odilson-dev -- it's not the script that's not working, it's something with the Cursor "latest" link (https://downloader.cursor.sh/linux/appImage/x64). For some reason, even though newer versions have been released, this link consistently pulls down 0.45.

This repo keeps an up-to-date list of the latest Cursor releases. If you replace the CURSOR_URL var in this script with the latest Linux link (or whatever version you'd like) in the script, you'll be in business.

In my fork of this script, I've added a prompt to replace the default URL with another for ease of use, with a fallback to the existing "latest" URL if none is provided.

Thank you @gaswirth