← back to Exo
feat: uninstall button (#1077)
d85b5d378181b9f2234376387878ac30456bfe3c · 2026-01-09 19:49:08 +0500 · Sami Khan
## Motivation
https://github.com/exo-explore/exo/issues/1075
## Changes
- Added in-app "Uninstall" option under Advanced menu that cleanly
removes all system components
- Added NetworkSetupHelper.uninstall() to remove LaunchDaemon, scripts,
logs, and restore network settings
- Added LaunchAtLoginHelper.disable() to unregister from login items
- Created standalone uninstall-exo.sh script for users who already
deleted the app
- Added uninstall documentation to README
<img width="386" height="577" alt="image"
src="https://github.com/user-attachments/assets/6bbcd18a-992a-409d-8791-ed5e13bbcfe0"
/>
<img width="372" height="432" alt="image"
src="https://github.com/user-attachments/assets/ee76b45d-c111-4807-ab28-3f2f20e01140"
/>
## Why It Works
The in-app uninstaller runs a privileged shell script (via AppleScript)
to launchctl bootout the daemon, remove files, and restore the
"Automatic" network location. The standalone script provides the same
cleanup for users who already deleted the app.
## Test Plan
### Manual Testing
Hardware: MacBook Pro
- Built and ran app, verified LaunchDaemon and network location were
created
- Used in-app Uninstall, verified all components removed and network
restored to Automatic
- Rebuilt app, quit normally, ran sudo ./uninstall-exo.sh, verified same
cleanup
### Automated Testing
N/A
---------
Co-authored-by: Evan <evanev7@gmail.com>
Files touched
M .gitignoreM README.mdM app/EXO/EXO/ContentView.swiftM app/EXO/EXO/EXOApp.swiftM app/EXO/EXO/Services/NetworkSetupHelper.swiftA app/EXO/uninstall-exo.sh
Diff
commit d85b5d378181b9f2234376387878ac30456bfe3c
Author: Sami Khan <98742866+samiamjidkhan@users.noreply.github.com>
Date: Fri Jan 9 19:49:08 2026 +0500
feat: uninstall button (#1077)
## Motivation
https://github.com/exo-explore/exo/issues/1075
## Changes
- Added in-app "Uninstall" option under Advanced menu that cleanly
removes all system components
- Added NetworkSetupHelper.uninstall() to remove LaunchDaemon, scripts,
logs, and restore network settings
- Added LaunchAtLoginHelper.disable() to unregister from login items
- Created standalone uninstall-exo.sh script for users who already
deleted the app
- Added uninstall documentation to README
<img width="386" height="577" alt="image"
src="https://github.com/user-attachments/assets/6bbcd18a-992a-409d-8791-ed5e13bbcfe0"
/>
<img width="372" height="432" alt="image"
src="https://github.com/user-attachments/assets/ee76b45d-c111-4807-ab28-3f2f20e01140"
/>
## Why It Works
The in-app uninstaller runs a privileged shell script (via AppleScript)
to launchctl bootout the daemon, remove files, and restore the
"Automatic" network location. The standalone script provides the same
cleanup for users who already deleted the app.
## Test Plan
### Manual Testing
Hardware: MacBook Pro
- Built and ran app, verified LaunchDaemon and network location were
created
- Used in-app Uninstall, verified all components removed and network
restored to Automatic
- Rebuilt app, quit normally, ran sudo ./uninstall-exo.sh, verified same
cleanup
### Automated Testing
N/A
---------
Co-authored-by: Evan <evanev7@gmail.com>
---
.gitignore | 1 +
README.md | 18 +++
app/EXO/EXO/ContentView.swift | 216 +++++++++++++++++++-------
app/EXO/EXO/EXOApp.swift | 18 +++
app/EXO/EXO/Services/NetworkSetupHelper.swift | 60 ++++++-
app/EXO/uninstall-exo.sh | 154 ++++++++++++++++++
6 files changed, 407 insertions(+), 60 deletions(-)
diff --git a/.gitignore b/.gitignore
index e25968ee..a4231085 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,6 +16,7 @@ digest.txt
*.xcuserdatad/
**/.DS_Store
app/EXO/build/
+dist/
# rust
diff --git a/README.md b/README.md
index cad0ff2f..913e0181 100644
--- a/README.md
+++ b/README.md
@@ -166,6 +166,24 @@ Download the latest build here: [EXO-latest.dmg](https://assets.exolabs.net/EXO-
The app will ask for permission to modify system settings and install a new Network profile. Improvements to this are being worked on.
+#### Uninstalling the macOS App
+
+The recommended way to uninstall is through the app itself: click the menu bar icon → Advanced → Uninstall. This cleanly removes all system components.
+
+If you've already deleted the app, you can run the standalone uninstaller script:
+
+```bash
+sudo ./app/EXO/uninstall-exo.sh
+```
+
+This removes:
+- Network setup LaunchDaemon
+- Network configuration script
+- Log files
+- The "exo" network location
+
+**Note:** You'll need to manually remove EXO from Login Items in System Settings → General → Login Items.
+
---
### Enabling RDMA on macOS
diff --git a/app/EXO/EXO/ContentView.swift b/app/EXO/EXO/ContentView.swift
index d9904c91..8524669d 100644
--- a/app/EXO/EXO/ContentView.swift
+++ b/app/EXO/EXO/ContentView.swift
@@ -18,10 +18,11 @@ struct ContentView: View {
@State private var deletingInstanceIDs: Set<String> = []
@State private var showAllNodes = false
@State private var showAllInstances = false
+ @State private var showAdvanced = false
@State private var showDebugInfo = false
@State private var bugReportInFlight = false
@State private var bugReportMessage: String?
- @State private var showAdvancedOptions = false
+ @State private var uninstallInProgress = false
@State private var pendingNamespace: String = ""
var body: some View {
@@ -255,13 +256,7 @@ struct ContentView: View {
Divider()
.padding(.vertical, 4)
}
- controlButton(title: "Check for Updates") {
- updater.checkForUpdates()
- }
- .padding(.bottom, 8)
- advancedOptionsSection
- .padding(.bottom, 8)
- debugSection
+ advancedSection
.padding(.bottom, 8)
controlButton(title: "Quit", tint: .secondary) {
controller.stop()
@@ -270,6 +265,54 @@ struct ContentView: View {
}
}
+ private var advancedSection: some View {
+ VStack(alignment: .leading, spacing: 6) {
+ HStack {
+ Text("Advanced")
+ .font(.caption)
+ .foregroundColor(.secondary)
+ Spacer()
+ collapseButton(isExpanded: $showAdvanced)
+ }
+ .animation(nil, value: showAdvanced)
+ if showAdvanced {
+ VStack(alignment: .leading, spacing: 8) {
+ VStack(alignment: .leading, spacing: 4) {
+ Text("Cluster Namespace")
+ .font(.caption2)
+ .foregroundColor(.secondary)
+ HStack {
+ TextField("optional", text: $pendingNamespace)
+ .textFieldStyle(.roundedBorder)
+ .font(.caption2)
+ .onAppear {
+ pendingNamespace = controller.customNamespace
+ }
+ Button("Save & Restart") {
+ controller.customNamespace = pendingNamespace
+ if controller.status == .running || controller.status == .starting {
+ controller.restart()
+ }
+ }
+ .font(.caption2)
+ .disabled(pendingNamespace == controller.customNamespace)
+ }
+ }
+ HoverButton(title: "Check for Updates", small: true) {
+ updater.checkForUpdates()
+ }
+ debugSection
+ HoverButton(title: "Uninstall", tint: .red, small: true) {
+ showUninstallConfirmationAlert()
+ }
+ .disabled(uninstallInProgress)
+ }
+ .transition(.opacity)
+ }
+ }
+ .animation(.easeInOut(duration: 0.25), value: showAdvanced)
+ }
+
private func controlButton(title: String, tint: Color = .primary, action: @escaping () -> Void)
-> some View
{
@@ -396,57 +439,16 @@ struct ContentView: View {
}
}
- private var advancedOptionsSection: some View {
- VStack(alignment: .leading, spacing: 6) {
- HStack {
- Text("Advanced Options")
- .font(.caption)
- .foregroundColor(.secondary)
- Spacer()
- collapseButton(isExpanded: $showAdvancedOptions)
- }
- .animation(nil, value: showAdvancedOptions)
- if showAdvancedOptions {
- VStack(alignment: .leading, spacing: 8) {
- VStack(alignment: .leading, spacing: 4) {
- Text("Cluster Namespace")
- .font(.caption2)
- .foregroundColor(.secondary)
- HStack {
- TextField("optional", text: $pendingNamespace)
- .textFieldStyle(.roundedBorder)
- .font(.caption2)
- .onAppear {
- pendingNamespace = controller.customNamespace
- }
- Button("Save & Restart") {
- controller.customNamespace = pendingNamespace
- if controller.status == .running || controller.status == .starting {
- controller.restart()
- }
- }
- .font(.caption2)
- .disabled(pendingNamespace == controller.customNamespace)
- }
-
- }
- }
- .transition(.opacity)
- }
- }
- .animation(.easeInOut(duration: 0.25), value: showAdvancedOptions)
- }
-
private var debugSection: some View {
- VStack(alignment: .leading, spacing: 6) {
- HStack {
- Text("Debug Info")
- .font(.caption)
- .foregroundColor(.secondary)
- Spacer()
- collapseButton(isExpanded: $showDebugInfo)
+ VStack(alignment: .leading, spacing: 4) {
+ HoverButton(
+ title: "Debug Info",
+ tint: .primary,
+ trailingSystemImage: showDebugInfo ? "chevron.up" : "chevron.down",
+ small: true
+ ) {
+ showDebugInfo.toggle()
}
- .animation(nil, value: showDebugInfo)
if showDebugInfo {
VStack(alignment: .leading, spacing: 4) {
Text("Version: \(buildTag)")
@@ -463,6 +465,7 @@ struct ContentView: View {
sendBugReportButton
.padding(.top, 6)
}
+ .padding(.leading, 8)
.transition(.opacity)
}
}
@@ -604,6 +607,88 @@ struct ContentView: View {
bugReportInFlight = false
}
+ private func showUninstallConfirmationAlert() {
+ let alert = NSAlert()
+ alert.messageText = "Uninstall EXO"
+ alert.informativeText = """
+ This will remove EXO and all its system components:
+
+ • Network configuration daemon
+ • Launch at login registration
+ • EXO network location
+
+ The app will be moved to Trash.
+ """
+ alert.alertStyle = .warning
+ alert.addButton(withTitle: "Uninstall")
+ alert.addButton(withTitle: "Cancel")
+
+ // Style the Uninstall button as destructive
+ if let uninstallButton = alert.buttons.first {
+ uninstallButton.hasDestructiveAction = true
+ }
+
+ let response = alert.runModal()
+ if response == .alertFirstButtonReturn {
+ performUninstall()
+ }
+ }
+
+ private func performUninstall() {
+ uninstallInProgress = true
+
+ // Stop EXO process first
+ controller.cancelPendingLaunch()
+ controller.stop()
+ stateService.stopPolling()
+
+ // Run the privileged uninstall on a background thread
+ // Using .utility QoS to avoid priority inversion with NSAppleScript's subprocess
+ DispatchQueue.global(qos: .utility).async {
+ do {
+ // Remove network setup daemon and components (requires admin privileges)
+ try NetworkSetupHelper.uninstall()
+
+ DispatchQueue.main.async {
+ // Unregister from launch at login
+ LaunchAtLoginHelper.disable()
+
+ // Move app to trash
+ self.moveAppToTrash()
+
+ // Quit the app
+ DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
+ NSApplication.shared.terminate(nil)
+ }
+ }
+ } catch {
+ DispatchQueue.main.async {
+ self.showErrorAlert(message: error.localizedDescription)
+ self.uninstallInProgress = false
+ }
+ }
+ }
+ }
+
+ private func showErrorAlert(message: String) {
+ let alert = NSAlert()
+ alert.messageText = "Uninstall Failed"
+ alert.informativeText = message
+ alert.alertStyle = .critical
+ alert.addButton(withTitle: "OK")
+ alert.runModal()
+ }
+
+ private func moveAppToTrash() {
+ guard let appURL = Bundle.main.bundleURL as URL? else { return }
+ do {
+ try FileManager.default.trashItem(at: appURL, resultingItemURL: nil)
+ } catch {
+ // If we can't trash the app, that's OK - user can do it manually
+ // The important system components have already been cleaned up
+ }
+ }
+
private var buildTag: String {
Bundle.main.infoDictionary?["EXOBuildTag"] as? String ?? "unknown"
}
@@ -617,14 +702,27 @@ private struct HoverButton: View {
let title: String
let tint: Color
let trailingSystemImage: String?
+ let small: Bool
let action: () -> Void
+ init(
+ title: String, tint: Color = .primary, trailingSystemImage: String? = nil,
+ small: Bool = false, action: @escaping () -> Void
+ ) {
+ self.title = title
+ self.tint = tint
+ self.trailingSystemImage = trailingSystemImage
+ self.small = small
+ self.action = action
+ }
+
@State private var isHovering = false
var body: some View {
Button(action: action) {
HStack {
Text(title)
+ .font(small ? .caption : nil)
Spacer()
if let systemName = trailingSystemImage {
Image(systemName: systemName)
@@ -632,8 +730,8 @@ private struct HoverButton: View {
}
}
.frame(maxWidth: .infinity, alignment: .leading)
- .padding(.vertical, 6)
- .padding(.horizontal, 8)
+ .padding(.vertical, small ? 4 : 6)
+ .padding(.horizontal, small ? 6 : 8)
.background(
RoundedRectangle(cornerRadius: 6)
.fill(
diff --git a/app/EXO/EXO/EXOApp.swift b/app/EXO/EXO/EXOApp.swift
index 82bb5c7b..e52edafe 100644
--- a/app/EXO/EXO/EXOApp.swift
+++ b/app/EXO/EXO/EXOApp.swift
@@ -132,6 +132,24 @@ struct EXOApp: App {
}
}
+/// Helper for managing EXO's launch-at-login registration
+enum LaunchAtLoginHelper {
+ private static let logger = Logger(subsystem: "io.exo.EXO", category: "LaunchAtLogin")
+
+ /// Unregisters EXO from launching at login
+ static func disable() {
+ guard SMAppService.mainApp.status == .enabled else { return }
+ do {
+ try SMAppService.mainApp.unregister()
+ logger.info("Unregistered EXO from launch at login")
+ } catch {
+ logger.error(
+ "Failed to unregister EXO from launch at login: \(error.localizedDescription, privacy: .public)"
+ )
+ }
+ }
+}
+
final class SparkleUpdater: NSObject, ObservableObject {
private let controller: SPUStandardUpdaterController
private let delegateProxy: ExoUpdaterDelegate
diff --git a/app/EXO/EXO/Services/NetworkSetupHelper.swift b/app/EXO/EXO/Services/NetworkSetupHelper.swift
index c73e744b..4e706ac3 100644
--- a/app/EXO/EXO/Services/NetworkSetupHelper.swift
+++ b/app/EXO/EXO/Services/NetworkSetupHelper.swift
@@ -63,7 +63,8 @@ enum NetworkSetupHelper {
"""
static func ensureLaunchDaemonInstalled() {
- Task.detached {
+ // Use .utility priority to match NSAppleScript's internal QoS and avoid priority inversion
+ Task.detached(priority: .utility) {
do {
if daemonAlreadyInstalled() {
return
@@ -78,6 +79,63 @@ enum NetworkSetupHelper {
}
}
+ /// Removes all EXO network setup components from the system.
+ /// This includes the LaunchDaemon, scripts, logs, and network location.
+ /// Requires admin privileges.
+ static func uninstall() throws {
+ let uninstallScript = makeUninstallScript()
+ try runShellAsAdmin(uninstallScript)
+ logger.info("EXO network setup components removed successfully")
+ }
+
+ /// Checks if there are any EXO network components installed that need cleanup
+ static func hasInstalledComponents() -> Bool {
+ let manager = FileManager.default
+ let scriptExists = manager.fileExists(atPath: scriptDestination)
+ let plistExists = manager.fileExists(atPath: plistDestination)
+ return scriptExists || plistExists
+ }
+
+ private static func makeUninstallScript() -> String {
+ """
+ set -euo pipefail
+
+ LABEL="\(daemonLabel)"
+ SCRIPT_DEST="\(scriptDestination)"
+ PLIST_DEST="\(plistDestination)"
+ LOG_OUT="/var/log/\(daemonLabel).log"
+ LOG_ERR="/var/log/\(daemonLabel).err.log"
+
+ # Unload the LaunchDaemon if running
+ launchctl bootout system/"$LABEL" 2>/dev/null || true
+
+ # Remove LaunchDaemon plist
+ rm -f "$PLIST_DEST"
+
+ # Remove the script and parent directory if empty
+ rm -f "$SCRIPT_DEST"
+ rmdir "$(dirname "$SCRIPT_DEST")" 2>/dev/null || true
+
+ # Remove log files
+ rm -f "$LOG_OUT" "$LOG_ERR"
+
+ # Switch back to Automatic network location
+ networksetup -switchtolocation Automatic 2>/dev/null || true
+
+ # Delete the exo network location if it exists
+ networksetup -listlocations | grep -q '^exo$' && {
+ networksetup -deletelocation exo 2>/dev/null || true
+ } || true
+
+ # Re-enable Thunderbolt Bridge if it exists
+ networksetup -listnetworkservices | grep -q "Thunderbolt Bridge" && {
+ networksetup -setnetworkserviceenabled "Thunderbolt Bridge" on 2>/dev/null || true
+ } || true
+
+ echo "EXO network components removed successfully"
+ """
+ }
+
private static func daemonAlreadyInstalled() -> Bool {
let manager = FileManager.default
let scriptExists = manager.fileExists(atPath: scriptDestination)
diff --git a/app/EXO/uninstall-exo.sh b/app/EXO/uninstall-exo.sh
new file mode 100755
index 00000000..7cc60925
--- /dev/null
+++ b/app/EXO/uninstall-exo.sh
@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+#
+# EXO Uninstaller Script
+#
+# This script removes all EXO system components that persist after deleting the app.
+# Run with: sudo ./uninstall-exo.sh
+#
+# Components removed:
+# - LaunchDaemon: /Library/LaunchDaemons/io.exo.networksetup.plist
+# - Network script: /Library/Application Support/EXO/
+# - Log files: /var/log/io.exo.networksetup.*
+# - Network location: "exo"
+# - Launch at login registration
+#
+
+set -euo pipefail
+
+LABEL="io.exo.networksetup"
+SCRIPT_DEST="/Library/Application Support/EXO/disable_bridge_enable_dhcp.sh"
+PLIST_DEST="/Library/LaunchDaemons/io.exo.networksetup.plist"
+LOG_OUT="/var/log/${LABEL}.log"
+LOG_ERR="/var/log/${LABEL}.err.log"
+APP_BUNDLE_ID="io.exo.EXO"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo_info() {
+ echo -e "${GREEN}[INFO]${NC} $1"
+}
+
+echo_warn() {
+ echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+echo_error() {
+ echo -e "${RED}[ERROR]${NC} $1"
+}
+
+# Check if running as root
+if [[ $EUID -ne 0 ]]; then
+ echo_error "This script must be run as root (use sudo)"
+ exit 1
+fi
+
+echo ""
+echo "========================================"
+echo " EXO Uninstaller"
+echo "========================================"
+echo ""
+
+# Unload the LaunchDaemon if running
+echo_info "Stopping network setup daemon..."
+if launchctl list | grep -q "$LABEL"; then
+ launchctl bootout system/"$LABEL" 2>/dev/null || true
+ echo_info "Daemon stopped"
+else
+ echo_warn "Daemon was not running"
+fi
+
+# Remove LaunchDaemon plist
+if [[ -f "$PLIST_DEST" ]]; then
+ rm -f "$PLIST_DEST"
+ echo_info "Removed LaunchDaemon plist"
+else
+ echo_warn "LaunchDaemon plist not found (already removed?)"
+fi
+
+# Remove the script and parent directory
+if [[ -f "$SCRIPT_DEST" ]]; then
+ rm -f "$SCRIPT_DEST"
+ echo_info "Removed network setup script"
+else
+ echo_warn "Network setup script not found (already removed?)"
+fi
+
+# Remove EXO directory if empty
+if [[ -d "/Library/Application Support/EXO" ]]; then
+ rmdir "/Library/Application Support/EXO" 2>/dev/null && \
+ echo_info "Removed EXO support directory" || \
+ echo_warn "EXO support directory not empty, leaving in place"
+fi
+
+# Remove log files
+if [[ -f "$LOG_OUT" ]] || [[ -f "$LOG_ERR" ]]; then
+ rm -f "$LOG_OUT" "$LOG_ERR"
+ echo_info "Removed log files"
+else
+ echo_warn "Log files not found (already removed?)"
+fi
+
+# Switch back to Automatic network location
+echo_info "Restoring network configuration..."
+if networksetup -listlocations | grep -q "^Automatic$"; then
+ networksetup -switchtolocation Automatic 2>/dev/null || true
+ echo_info "Switched to Automatic network location"
+else
+ echo_warn "Automatic network location not found"
+fi
+
+# Delete the exo network location if it exists
+if networksetup -listlocations | grep -q "^exo$"; then
+ networksetup -deletelocation exo 2>/dev/null || true
+ echo_info "Deleted 'exo' network location"
+else
+ echo_warn "'exo' network location not found (already removed?)"
+fi
+
+# Re-enable Thunderbolt Bridge if it exists
+if networksetup -listnetworkservices 2>/dev/null | grep -q "Thunderbolt Bridge"; then
+ networksetup -setnetworkserviceenabled "Thunderbolt Bridge" on 2>/dev/null || true
+ echo_info "Re-enabled Thunderbolt Bridge"
+fi
+
+# Note about launch at login registration
+# SMAppService-based login items cannot be removed from a shell script.
+# They can only be unregistered from within the app itself or manually via System Settings.
+echo_warn "Launch at login must be removed manually:"
+echo_warn " System Settings → General → Login Items → Remove EXO"
+
+# Check if EXO.app exists in common locations
+APP_FOUND=false
+for app_path in "/Applications/EXO.app" "$HOME/Applications/EXO.app"; do
+ if [[ -d "$app_path" ]]; then
+ if [[ "$APP_FOUND" == false ]]; then
+ echo ""
+ APP_FOUND=true
+ fi
+ echo_warn "EXO.app found at: $app_path"
+ echo_warn "You may want to move it to Trash manually."
+ fi
+done
+
+echo ""
+echo "========================================"
+echo_info "EXO uninstall complete!"
+echo "========================================"
+echo ""
+echo "The following have been removed:"
+echo " • Network setup LaunchDaemon"
+echo " • Network configuration script"
+echo " • Log files"
+echo " • 'exo' network location"
+echo ""
+echo "Your network has been restored to use the 'Automatic' location."
+echo "Thunderbolt Bridge has been re-enabled (if present)."
+echo ""
+echo "Manual step required:"
+echo " Remove EXO from Login Items in System Settings → General → Login Items"
+echo ""
+
← caafc486 Forward tools to the models chat template properly (#1106)
·
back to Exo
·
nix: put treefmt in devshell 18c4e49f →