Automated maintenance system for the cursor-bin AUR package. This repository automatically monitors Cursor IDE releases and maintains the PKGBUILD for Arch Linux users.

This is not a manual installation guide for Cursor IDE. Instead, it's an automated system that:

• 🔍 Monitors Cursor IDE releases automatically via GitHub Actions
• 📦 Generates proper PKGBUILDs with correct versions, checksums, and dependencies
• 🚀 Publishes updates to the AUR automatically
• ✅ Validates all changes with comprehensive testing (25+ checks)
• 🔧 Maintains the package using modern .deb format (not AppImage)

If you just want to install Cursor IDE on Arch Linux, use your AUR helper:

# Using yay
yay -S cursor-bin

# Using paru  
paru -S cursor-bin

# Using makepkg (manual)
git clone https://aur.archlinux.org/cursor-bin.git
cd cursor-bin
makepkg -si

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Cursor.com    │───▶│  GitHub Actions  │───▶│  AUR Package    │
│   (releases)    │    │  (this repo)     │    │  (cursor-bin)   │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │   Validation     │
                       │   (25+ checks)   │
                       └──────────────────┘

1. 🕐 Scheduled Check: GitHub Actions runs daily (and on manual trigger)
2. 🔍 Version Detection: check.py compares latest Cursor version with AUR
3. 📦 PKGBUILD Update: update_pkgbuild.py generates new PKGBUILD with:
   • Correct version and commit hash
   • Updated download URLs
   • Recalculated SHA512 checksums
   • Dynamic Electron version detection
4. ✅ Validation: 25+ comprehensive checks ensure quality (development branch only)
5. 🚀 AUR Publish: Automatic commit and push to AUR (main branch only)

Branch Behavior:

• Development: Runs steps 1-4, skips AUR publish for safe testing
• Main: Runs steps 1-3 + 5, skips validation for faster production updates

# For local testing (optional)
yay -S act-bin  # GitHub Actions local runner

# 1. Check for updates
python check.py

# 2. Apply updates (if needed)
python update_pkgbuild.py check_output.json

# 3. Validate the result
python validate_pkgbuild.py

# 4. Test locally
makepkg -s

# Test the complete GitHub Actions workflow locally
python test_workflow.py --run

This simulates the entire automated process including:

• Version downgrade simulation
• Complete workflow execution in Docker
• Comprehensive validation
• Result reporting

• main: Production branch - triggers actual AUR updates (no validation step)
• development: Testing branch - runs comprehensive validation + DEBUG mode (no AUR push)

Important: The 25+ validation checks only run automatically on the development branch. This ensures thorough testing before changes reach production.

The system performs 25+ comprehensive checks:

The system automatically detects the correct Electron version by:

1. Extracting VSCode version from Cursor's product.json
2. Downloading VSCode source tarball
3. Parsing package-lock.json for Electron dependencies
4. Updating PKGBUILD with correct electronXX package

Enable verbose logging for troubleshooting:

DEBUG=true python check.py
DEBUG=true python update_pkgbuild.py check_output.json

• Package Issues: Report to AUR cursor-bin page
• Automation Issues: Create issues in this repository

1. Fork this repository
2. Create feature branch from development
3. Test changes with python test_workflow.py --run
4. Submit PR against development branch

To add validation checks, modify validate_pkgbuild.py:

# Add new check in validate_pkgbuild() function
results["checks"].append({
    "check": "your_check_name",
    "status": "pass" or "fail", 
    "message": "Description of what was checked"
})

• GitHub Actions: Check workflow runs for automation status
• AUR Package: Monitor cursor-bin for updates
• Issues: Watch this repository for automation problems

• Cursor IDE Official Site
• AUR cursor-bin Package
• Arch Linux AUR Guidelines

Note: This repository maintains the AUR package automatically. End users should install cursor-bin directly from the AUR, not from this repository.