feat: improve IDE setup with SIP-aware permission handling

- Add proactive permission checking for VSCode product.json editing
- Provide clear SIP protection error messages and manual setup instructions
- Improve JetBrains setup log message formatting for better readability
- Add comprehensive IDE setup documentation

This enables VSCode and JetBrains IDE configuration to work properly
on macOS systems with System Integrity Protection (SIP) enabled.

Author: agrasth

general/ide/README.md

@@ -0,0 +1,88 @@
+# JFrog CLI IDE Configuration
+
+Automates JFrog Artifactory repository configuration for IDEs.
+
+## Features
+
+- **VSCode**: Configures extension gallery to use JFrog Artifactory
+- **JetBrains**: Configures plugin repositories for all JetBrains IDEs  
+- **Cross-platform**: Windows, macOS, Linux support
+- **Automatic backup**: Creates backups before modifications
+- **Auto-detection**: Finds IDE installations automatically
+
+## Commands
+
+### VSCode
+```bash
+# Configure VSCode extensions repository
+jf vscode config --repo=<REPO_KEY> --artifactory-url=<URL>
+
+# Install VSCode extension from repository
+jf vscode install --publisher=<PUBLISHER> --extension-name=<EXTENSION_NAME> --repo=<REPO_KEY> [--version=<VERSION>] [--artifactory-url=<URL>]
+
+# Examples
+jf vscode config --repo=vscode-extensions --artifactory-url=https://myartifactory.com/
+sudo jf vscode config --repo=vscode-extensions --artifactory-url=https://myartifactory.com/  # macOS/Linux
+
+# Install specific extension
+jf vscode install --publisher=microsoft --extension-name=vscode-python --repo=vscode-extensions
+jf vscode install --publisher=ms-python --extension-name=python --version=2023.12.0 --repo=vscode-extensions
+```
+
+### JetBrains
+```bash
+# Configure JetBrains plugin repository  
+jf jetbrains config --repo=<REPO_KEY> --artifactory-url=<URL>
+
+# Examples
+jf jetbrains config --repo=jetbrains-plugins --artifactory-url=https://myartifactory.com/
+```
+
+## How It Works
+
+### VSCode
+**Configuration:**
+1. Detects VSCode installation (`product.json` location)
+2. Creates backup in `~/.jfrog/backup/ide/vscode/`
+3. Modifies `extensionsGallery.serviceUrl` using:
+   - **macOS/Linux**: `sed` command
+   - **Windows**: PowerShell regex replacement
+4. Preserves all other VSCode configuration
+
+**Extension Installation:**
+1. Validates extension exists in Artifactory repository
+2. Downloads extension package (.vsix) from JFrog Artifactory 
+3. Installs extension using VSCode CLI (`code --install-extension`)
+4. Supports specific version installation or latest version
+5. Cross-platform support (Windows/macOS/Linux)
+
+### JetBrains  
+1. Scans for JetBrains IDE configurations
+2. Creates backups in `~/.jfrog/backup/ide/jetbrains/`
+3. Updates `idea.properties` files with repository URLs
+4. Supports all JetBrains IDEs (IntelliJ, PyCharm, WebStorm, etc.)
+
+## Platform Requirements
+
+- **macOS**: Requires `sudo` for system-installed IDEs
+- **Windows**: Requires "Run as Administrator" 
+- **Linux**: Requires `sudo` for system-installed IDEs
+
+## File Locations
+
+### VSCode
+- **macOS**: `/Applications/Visual Studio Code.app/Contents/Resources/app/product.json`
+- **Windows**: `%LOCALAPPDATA%\Programs\Microsoft VS Code\resources\app\product.json`
+- **Linux**: `/usr/share/code/resources/app/product.json`
+
+### JetBrains
+- **macOS**: `~/Library/Application Support/JetBrains/`
+- **Windows**: `%APPDATA%\JetBrains\`  
+- **Linux**: `~/.config/JetBrains/`
+
+## Backup & Recovery
+
+- Automatic backups created before modifications
+- Located in `~/.jfrog/backup/ide/`
+- Automatic restore on failure
+- Manual restore: copy backup file back to original location 

general/ide/jetbrains/jetbrains.go

@@ -61,29 +61,29 @@ func NewJetbrainsCommand(repoKey, artifactoryURL string) *JetbrainsCommand {
 
 // Run executes the JetBrains configuration command
 func (jc *JetbrainsCommand) Run() error {
-	log.Info("Configuring JetBrains IDEs to use JFrog Artifactory plugins repository...")
-
-	// Get the Artifactory URL if not provided
-	if jc.artifactoryURL == "" {
-		serverDetails, err := config.GetDefaultServerConf()
-		if err != nil {
-			return errorutils.CheckError(fmt.Errorf("failed to get default server configuration: %w", err))
-		}
-		if serverDetails == nil {
-			return errorutils.CheckError(fmt.Errorf("no default server configuration found. Please configure JFrog CLI or provide --artifactory-url"))
+	log.Info("Configuring JetBrains IDEs plugin repository...")
+
+	var repoURL string
+	if jc.repoKey == "" {
+		repoURL = jc.artifactoryURL
+	} else {
+		if jc.artifactoryURL == "" {
+			serverDetails, err := config.GetDefaultServerConf()
+			if err != nil {
+				return errorutils.CheckError(fmt.Errorf("failed to get default server configuration: %w", err))
+			}
+			if serverDetails == nil {
+				return errorutils.CheckError(fmt.Errorf("no default server configuration found. Please configure JFrog CLI or provide --artifactory-url"))
+			}
+			jc.artifactoryURL = serverDetails.GetUrl()
 		}
-		jc.artifactoryURL = serverDetails.GetUrl()
+		repoURL = jc.buildRepositoryURL()
 	}
 
-	// Build the complete repository URL
-	repoURL := jc.buildRepositoryURL()
-
-	// Validate repository connection
 	if err := jc.validateRepository(repoURL); err != nil {
 		return errorutils.CheckError(fmt.Errorf("repository validation failed: %w", err))
 	}
 
-	// Auto-detect JetBrains IDE installations
 	if err := jc.detectJetBrainsIDEs(); err != nil {
 		return errorutils.CheckError(fmt.Errorf("failed to detect JetBrains IDEs: %w\n\nManual setup instructions:\n%s", err, jc.getManualSetupInstructions(repoURL)))
 	}
@@ -94,54 +94,50 @@ func (jc *JetbrainsCommand) Run() error {
 
 	log.Info(fmt.Sprintf("Found %d JetBrains IDE installation(s):", len(jc.detectedIDEs)))
 	for _, ide := range jc.detectedIDEs {
-		log.Info(fmt.Sprintf("  • %s %s", ide.Name, ide.Version))
+		log.Info(fmt.Sprintf("  %s %s", ide.Name, ide.Version))
 	}
 
-	// Create backups and modify each IDE
 	modifiedCount := 0
 	for _, ide := range jc.detectedIDEs {
-		log.Info(fmt.Sprintf("\nConfiguring %s %s...", ide.Name, ide.Version))
+		log.Info(fmt.Sprintf("Configuring %s %s...", ide.Name, ide.Version))
 
-		// Create backup
 		if err := jc.createBackup(ide); err != nil {
 			log.Warn(fmt.Sprintf("Failed to create backup for %s: %v", ide.Name, err))
 			continue
 		}
 
-		// Modify properties file
 		if err := jc.modifyPropertiesFile(ide, repoURL); err != nil {
 			log.Error(fmt.Sprintf("Failed to configure %s: %v", ide.Name, err))
-			// Attempt to restore backup
 			if restoreErr := jc.restoreBackup(ide); restoreErr != nil {
 				log.Error(fmt.Sprintf("Failed to restore backup for %s: %v", ide.Name, restoreErr))
 			}
 			continue
 		}
 
 		modifiedCount++
-		log.Info(fmt.Sprintf("✅ %s %s configured successfully", ide.Name, ide.Version))
+		log.Info(fmt.Sprintf("%s %s configured successfully", ide.Name, ide.Version))
 	}
 
 	if modifiedCount == 0 {
 		return errorutils.CheckError(fmt.Errorf("failed to configure any JetBrains IDEs\n\nManual setup instructions:\n%s", jc.getManualSetupInstructions(repoURL)))
 	}
 
-	log.Info(fmt.Sprintf("\n✅ Successfully configured %d out of %d JetBrains IDE(s)!", modifiedCount, len(jc.detectedIDEs)))
+	log.Info(fmt.Sprintf("Successfully configured %d out of %d JetBrains IDE(s)", modifiedCount, len(jc.detectedIDEs)))
 	log.Info("Repository URL:", repoURL)
-	log.Info("\nPlease restart your JetBrains IDEs for the changes to take effect.")
+	log.Info("Please restart your JetBrains IDEs to apply changes")
 
 	return nil
 }
 
 // buildRepositoryURL constructs the complete repository URL
 func (jc *JetbrainsCommand) buildRepositoryURL() string {
 	baseURL := strings.TrimSuffix(jc.artifactoryURL, "/")
-	return fmt.Sprintf("%s/artifactory/api/jetbrains/%s", baseURL, jc.repoKey)
+	return fmt.Sprintf("%s/artifactory/%s", baseURL, jc.repoKey)
 }
 
 // validateRepository checks if the repository is accessible
 func (jc *JetbrainsCommand) validateRepository(repoURL string) error {
-	log.Info("Validating repository connection...")
+	log.Info("Validating repository...")
 
 	client := &http.Client{Timeout: 10 * time.Second}
 	resp, err := client.Get(repoURL)
@@ -151,13 +147,13 @@ func (jc *JetbrainsCommand) validateRepository(repoURL string) error {
 	defer resp.Body.Close()
 
 	if resp.StatusCode == 404 {
-		return fmt.Errorf("repository not found (404). Please verify the repository key '%s' exists and has anonymous read access", jc.repoKey)
+		return fmt.Errorf("repository not found (404). Please verify the repository key '%s' exists", jc.repoKey)
 	}
-	if resp.StatusCode >= 400 {
+	if resp.StatusCode >= 400 && resp.StatusCode != 401 {
 		return fmt.Errorf("repository returned status %d. Please verify the repository is accessible", resp.StatusCode)
 	}
 
-	log.Info("✅ Repository validation successful")
+	log.Info("Repository validation successful")
 	return nil
 }
 
@@ -273,7 +269,7 @@ func (jc *JetbrainsCommand) createBackup(ide IDEInstallation) error {
 	}
 
 	jc.backupPaths[ide.PropertiesPath] = backupPath
-	log.Info(fmt.Sprintf("  ✅ Backup created at: %s", backupPath))
+	log.Info(fmt.Sprintf("	Backup created at: %s", backupPath))
 	return nil
 }
 
@@ -302,7 +298,7 @@ func (jc *JetbrainsCommand) restoreBackup(ide IDEInstallation) error {
 		return fmt.Errorf("failed to restore backup: %w", err)
 	}
 
-	log.Info(fmt.Sprintf("  ✅ Backup restored for %s", ide.Name))
+	log.Info(fmt.Sprintf("	Backup restored for %s", ide.Name))
 	return nil
 }