Cursor Setup Wizard

A streamlined script to set up Cursor on Ubuntu-based systems with ease 🚀

Cursor Setup Wizard is a Bash script designed to simplify the installation, configuration, and even updates to the latest versions of Cursor — sometimes beyond what's available on the official site (see feedback).
Built specifically for Ubuntu-based systems, it addresses long-standing issues not resolved by Cursor itself, automates complex setup steps, and ensures a seamless experience for Linux users.

---

📖 Table of Contents

• ❓ Why Cursor Setup Wizard?
• 📋 Prerequisites
• 🚀 Quick Start
• ⭐ Features
• 🛠️ How It Works
• 🧑‍💻 Contributing
• 🔧 Improving the Script
  • Recommended Extensions
  • Debugging Tips
• 🐞 Troubleshooting
  • No local version found
  • The password was incorrect
  • Cursor Fails to Start
  • Launcher Issues
  • Dependency Errors
  • Gum Version Compatibility
• 📜 License
• ☕ Support This Project
• 💼 Open to Collaborations

---

❓Why Cursor Setup Wizard?

This script was born from the frustration many Linux users faced, including myself, with the tedious and error-prone process of setting up Cursor. These issues, highlighted in issue #1465 from the official Cursor repository, made it clear that an automated solution was needed.

I initially shared a workaround in a gist, and the thoughtful feedback and suggestions in the comments inspired me to refine it into the tool you see here. The collaborative input from the community, including suggestions, feature requests, and shared solutions, was instrumental in shaping this project.

Cursor Setup Wizard ensures you can focus on what truly matters: coding, without the hassle of manual steps.

🌟 I hope this repository proves helpful to others as well. It's an evolution of one of my first contributions, and I look forward to creating even more tools to assist the community. Feedback and improvements are always welcome! 💜

---

📋 Prerequisites

• Supported OS: Ubuntu-based Linux distributions (e.g., Ubuntu, Pop!_OS, Linux Mint, etc).
• Permissions: sudo privileges for dependency installation and system configuration.
• Internet Connection: Required to download Cursor, its components and dependencies.

---

🚀 Quick Start

To get started immediately, run:

bash <(curl -s https://raw.githubusercontent.com/jorcelinojunior/cursor-setup-wizard/main/install.sh)

This command downloads the main script (cursor_setup.sh), places it in ${HOME:-~}/cursor-setup-wizard/, makes it executable, and runs it. It's the fastest way to set up Cursor without hassle.

---

⭐ Features

• All-In-One Installation: Automatically fetch, download, and configure Cursor.
• AppArmor Integration: Applies a basic security profile for added safety.
• Launcher Creation: Generates launchers for both desktop and application menus to provide quick access.
• CLI Command: Adds a cursor command for launching Cursor from the terminal.
• Interactive UI: Provides an enhanced terminal experience using gum.
• Script Editing: Built-in menu option for editing the script with your preferred editor.

---

🛠️ How It Works

When you run the script, you’ll see an interactive menu like this:

• All-in-One: Fully automates the download, setup, and configuration process.
• Reconfigure All: Reuses the existing AppImage for reconfigurations without re-downloading.
• Setup AppArmor Profile: Configures or reapplies AppArmor for enhanced security.
• Add 'cursor' CLI Command: Adds or updates the cursor terminal command.
• Edit This Script: Opens the script in your preferred editor for customization.
• Exit: Closes the wizard.

At each step, the script provides clear prompts, spinners, and detailed logs to keep you informed.

---

🧑‍💻 Contributing

Contributions are always welcome, and I’d love to hear your suggestions or improvements! Even though it’s a simple script, every contribution will be thoughtfully considered.

If you're interested in contributing, here are some areas where your help would be especially valuable:

• Improving the script’s user experience.
• Adding support for new Linux distributions.
• Implementing new features that enhance the script’s functionality.
• Suggesting improvements for error handling or debugging tools.

To get started:

1. Fork the Repository: Use the "Fork" button to create your own copy.
2. Clone Your Fork:

   git clone https://github.com/<your-username>/cursor-setup-wizard.git
   cd cursor-setup-wizard

3. Create a New Branch:

   git checkout -b feature/my-new-feature

4. Make and Test Your Changes: Modify the code, add features, or fix bugs. Run the script locally to ensure everything works as expected.
5. Commit your changes and push them to your fork.:

   git commit -am 'Add some feature'
   git push origin feature/my-new-feature

6. Open a Pull Request: Submit your changes with a clear and descriptive title and explanation of your improvements.

Feel free to reach out if you have any questions. Your contributions make this project better! 😊

---

🔧 Improving the Script

If you're interested in debugging or enhancing the script, here are some resources and tips to help you get started!

Recommended Extensions

To make your development experience smoother, consider using these tools:

• Bash Debug: Debug Bash scripts to inspect stages and diagnose issues.
• ShellCheck: Identify syntax issues and improve script quality.
• shell-format: Format and lint Bash scripts for better readability.

Debugging Tips

This script includes pre-configured settings for debugging in VS Code or other editors. Follow these steps to get started:

1. Install the Bash Debug Extension.
2. Open the Script in Cursor/VSCode:
   • Navigate to the folder where the repository was cloned.
3. Select a Debug Configuration:
   • Use one of the two provided configurations:
     • Debug cursor_setup.sh: Debug the main script.
     • Bash-Debug Current File: Debug the currently open Bash file.
4. Set Breakpoints:
   • Add breakpoints in the script where you want to inspect execution.
5. Start Debugging:
   • Launch the debugger and step through the script interactively.

---

🐞 Troubleshooting

Common Issues and Fixes

Failed to fetch headers from the server

This error occurs when the script cannot retrieve necessary headers from the server. Possible solutions include:

• Ensure your internet connection is stable.
• Check if the VERSION_CHECK_TIMEOUT value (default 5 sec) is sufficient for your connection speed. Increase it if necessary.
• Verify that the DOWNLOAD_URL is correct. If you’ve modified it, ensure it points to a valid resource. The default is: https://downloader.cursor.sh/linux/appImage/x64.

---

No local version found

If you encounter this error, it means the AppImage could not be located. Use All-in-One to fetch it again.

---

The password was incorrect

If you see this message, re-enter your password to proceed.

---

Cursor Fails to Start

Check if AppArmor is active. Reapply its profile via the menu if needed (option Setup AppArmor Profile).

---

Launcher Issues

If the .desktop file is marked as untrusted, ensure gio is installed and D-Bus is running.

---

Dependency Errors

Most of the required dependencies are already included by default in Ubuntu-based systems. The script performs a quick check to ensure everything is ready and installs any missing packages automatically. An active internet connection is needed for this process.

---

Gum Version Compatibility

The script requires gum version 0.14.5. Avoid running sudo apt update while the script is open, as it may upgrade gum to version 0.15.0, which can cause unexpected behavior. Restart the script if you update your system.

---

📜 License

This script is licensed under the MIT License. Feel free to use, modify, and distribute it as needed.

---

☕ Support This Project

If this script has been helpful, consider supporting my work and keeping the magic alive!
Your contributions help maintain and improve tools like this one. 🌟

Thank you for your kindness and support! 💜

---

💼 Open to Collaborations

Are you looking for someone who thrives on tackling challenges and building impactful solutions?

With over 8 years of experience in backend development, Linux automation, scalable systems, and AI-driven solutions,
I enjoy working independently on creative projects that deliver real value.
Passionate about exploring new ideas and technologies, I aim to transform innovative visions into extraordinary realities.
Let’s collaborate and create something exceptional together! ✨

📩 Feel free to send me a message—I’d love to hear from you: 💬