Cursor Setup Wizard

Professional installation and management tool for Cursor AI Editor on Linux

A comprehensive, user-friendly wizard that simplifies the installation, management, and maintenance of Cursor AppImage on Linux systems. Features include version management, automatic updates, backup/restore, and desktop integration.

📚 Documentation: User Manual | Contributing

✨ Features

Core Functionality

🚀 One-Click Installation - Install Cursor AppImage with full desktop integration
📦 Version Management - Install, switch, and manage multiple Cursor versions
🔄 Automatic Updates - Get notified of new versions with one-click download
💾 Backup & Restore - Protect your Cursor configuration and settings
🗑️ Clean Uninstallation - Remove Cursor completely with confirmation

User Experience

🎨 Interactive Menu - Beautiful arrow-key navigation interface
📊 Progress Indicators - Visual feedback for all operations
💬 Desktop Notifications - Get notified of important events
❓ Helpful Error Messages - Troubleshooting steps included
✅ Confirmation Prompts - Safe operations with preview

Security & Quality

🔒 Integrity Verification - SHA256 checksum validation
🛡️ Secure Permissions - Proper file permissions (644/755)
🔐 Input Validation - Protection against path traversal
✅ Shellcheck Compliant - High-quality, tested code

🚀 Quick Start

Prerequisites

Linux distribution (Ubuntu, Debian, Fedora, Arch, or compatible)
Bash 4.0 or higher
FUSE support (for AppImage)
curl (optional, for update checking)

Installation in 3 Steps

Download the latest release

wget https://github.com/easy-cloud-in/cursor-setup-wizard/releases/latest/download/cursor-setup-wizard.zip
unzip cursor-setup-wizard.zip
cd cursor-setup-wizard

Download Cursor AppImage

# Visit cursor.sh and download, or use wget
wget https://downloader.cursor.sh/linux/appImage/x64 -O cursor.AppImage

Run the installer
```
chmod +x cursor-manager.sh
./cursor-manager.sh
```
- Select "Install/Update Cursor" from the menu
- Follow the on-screen instructions

That's it! Cursor is now installed and ready to use. 🎉

Need help? See the User Manual for detailed instructions.

📥 Installation

System Requirements

Required:

Linux (any modern distribution)
Bash 4.0+
FUSE (for AppImage support)

Optional:

curl (for update checking)
notify-send/kdialog/zenity (for notifications)

Install FUSE (if needed)

# Ubuntu/Debian
sudo apt update && sudo apt install fuse3 libfuse2

# Fedora
sudo dnf install fuse3 fuse

# Arch Linux
sudo pacman -S fuse3 fuse2

Download and Install

Option A: From GitHub Releases (Recommended)

# Download wizard
wget https://github.com/easy-cloud-in/cursor-setup-wizard/releases/latest/download/cursor-setup-wizard.zip
unzip cursor-setup-wizard.zip
cd cursor-setup-wizard

# Download Cursor
wget https://downloader.cursor.sh/linux/appImage/x64 -O cursor.AppImage

# Run installer
chmod +x cursor-manager.sh
./cursor-manager.sh

Option B: Clone Repository

git clone https://github.com/easy-cloud-in/cursor-setup-wizard.git
cd cursor-setup-wizard
# Download Cursor AppImage from cursor.sh
./cursor-manager.sh

For detailed installation instructions, see the User Manual.

💻 Usage

Interactive Menu

Launch the wizard:

./cursor-manager.sh

Main menu options:

Install/Update Cursor
Manage Cursor Versions
Backup & Restore Configuration
Check for Updates
Uninstall Cursor
Verify Cursor Installation
View Installation Log
Settings

Command-Line Usage

After installation:

# Launch Cursor
cursor

# Open a file
cursor file.txt

# Open a directory
cursor /path/to/project

# Open current directory
cursor .

Quick Tasks

Install Cursor:

./cursor-manager.sh
# Select "Install/Update Cursor"

Switch Versions:

./cursor-manager.sh
# Select "Manage Cursor Versions" → "Switch Version"

Create Backup:

./cursor-manager.sh
# Select "Backup & Restore Configuration" → "Create Backup"

Check for Updates:

./cursor-manager.sh
# Select "Check for Updates"

For detailed usage instructions, see the User Manual.

🚀 Automated Release System

This project uses an automated release system that creates GitHub releases on every push to main.

Quick Commands

Push with release:

git commit -m "feat: new feature"
git push origin main

Push without release:

./git-push-no-version.sh

Check status:

./check-release-status.sh

Commit Message Format

Use Conventional Commits to control versioning:

feat: - New feature (minor version bump: 2.0.0 → 2.1.0)
fix: - Bug fix (patch version bump: 2.0.0 → 2.0.1)
BREAKING: - Breaking change (major version bump: 2.0.0 → 3.0.0)
docs: - Documentation (no version bump)
chore: - Maintenance (no version bump)

What Happens Automatically

✅ Version tag created based on commits
✅ CHANGELOG.md updated
✅ ZIP package built
✅ GitHub release created with release notes

For more details, see Release System Documentation.

📚 Documentation

User Documentation

User Manual - Complete guide for end users
- Installation guide
- Feature explanations
- Configuration options
- Troubleshooting
- FAQ

Developer Documentation

Contributing Guide - How to contribute
- Code style guidelines
- Testing requirements
- Pull request process
- Development setup
Final Summary - Release system documentation
- Automated release workflow
- Versioning rules
- Helper scripts

🔧 Troubleshooting

Quick Fixes

"No AppImage files found"

# Download Cursor AppImage
wget https://downloader.cursor.sh/linux/appImage/x64 -O cursor.AppImage

"Failed to mount AppImage" (FUSE Error)

# Install FUSE
sudo apt install fuse3 libfuse2  # Ubuntu/Debian
sudo dnf install fuse3 fuse      # Fedora
sudo pacman -S fuse3 fuse2       # Arch

# Fix permissions
sudo usermod -a -G fuse $USER
# Log out and back in

"cursor: command not found"

# Refresh shell
source ~/.bashrc  # or ~/.zshrc

# Or restart terminal

Desktop entry not showing

# Update database
update-desktop-database ~/.local/share/applications
# Or log out and back in

More Help

Check logs: less cursor-setup.log
Run verification: Select "Verify Cursor Installation" from menu
Full troubleshooting guide: User Manual - Troubleshooting
GitHub Issues: Report a bug
Email: support@easy-cloud.in

🤝 Contributing

We welcome contributions! See the Contributing Guide for details.

Quick Start

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

Development

# Clone and setup
git clone https://github.com/easy-cloud-in/cursor-setup-wizard.git
cd cursor-setup-wizard

# Check code quality
shellcheck scripts/*.sh

# Run tests (if available)
bash -n cursor-manager.sh

For detailed guidelines, see CONTRIBUTING.md.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author & Contact

Author: SAKAR.SR
Company: Easy-Cloud
Website: www.easy-cloud.in
GitHub: github.com/easy-cloud-in

Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Email: support@easy-cloud.in

🙏 Acknowledgments

Cursor Team - For creating an amazing AI-first code editor
AppImage Community - For the AppImage format and tools
Linux Community - For testing and feedback
Contributors - Everyone who has contributed to this project

📊 Project Info

Version: 2.0.0
License: MIT
Platform: Linux
Shell: Bash 4.0+
Status: Active Development

Roadmap

v2.0.0 (Current)

✅ Interactive menu system
✅ Version management
✅ Automatic updates
✅ Backup/restore
✅ Desktop notifications

v2.1.0 (Planned)

🔄 Automatic update installation
🔄 Cloud backup support
🔄 Scheduled backups
🔄 Plugin system

Made with ❤️ by SAKAR.SR | Easy-Cloud

Website • GitHub • Documentation • Issues

⭐ If you find this project useful, please consider giving it a star on GitHub!

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
.github		.github
docs		docs
scripts		scripts
.git-hooks-config		.git-hooks-config
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
cursor-manager.sh		cursor-manager.sh
cursor-setup.conf		cursor-setup.conf

License

Easy-Cloud-in/cursor-setup-wizard

Folders and files

Latest commit

History

Repository files navigation