feat: add uninstall command and documentation for PairUX release:patch

Author: ralyodio

apps/installer/scripts/install.sh

@@ -213,16 +213,74 @@ install_linux() {
     # Create wrapper script that handles sandbox issues
     info "Creating launcher script..."
     mkdir -p "$BIN_DIR"
-    cat > "$BIN_DIR/pairux" << 'WRAPPER'
+    cat > "$BIN_DIR/pairux" << WRAPPER
 #!/bin/bash
 # PairUX launcher
 # ELECTRON_DISABLE_SANDBOX is required for AppImages without SUID chrome-sandbox
-APPIMAGE="$HOME/.pairux/PairUX.AppImage"
-if [ -x "$APPIMAGE" ]; then
+
+VERSION="$version"
+APPIMAGE="\$HOME/.pairux/PairUX.AppImage"
+INSTALL_DIR="\$HOME/.pairux"
+BIN_DIR="\$HOME/.local/bin"
+DESKTOP_FILE="\$HOME/.local/share/applications/pairux.desktop"
+ICON_FILE="\$HOME/.local/share/icons/hicolor/256x256/apps/pairux.png"
+
+case "\${1-}" in
+    -h|--help)
+        echo "Usage: pairux [options]"
+        echo ""
+        echo "PairUX - collaborative screen sharing desktop app"
+        echo ""
+        echo "Options:"
+        echo "  -h, --help       Show this help message"
+        echo "  -v, --version    Show version number"
+        echo "  uninstall        Remove PairUX completely"
+        exit 0
+        ;;
+    -v|--version)
+        echo "pairux \$VERSION"
+        exit 0
+        ;;
+    uninstall)
+        echo "Uninstalling PairUX..."
+        echo ""
+
+        # Kill running instances
+        pkill -f "PairUX.AppImage" 2>/dev/null && echo "  Stopped running instance"
+
+        # Remove AppImage and install directory
+        if [ -d "\$INSTALL_DIR" ]; then
+            rm -rf "\$INSTALL_DIR"
+            echo "  Removed \$INSTALL_DIR"
+        fi
+
+        # Remove desktop entry
+        if [ -f "\$DESKTOP_FILE" ]; then
+            rm -f "\$DESKTOP_FILE"
+            echo "  Removed desktop entry"
+            update-desktop-database "\$HOME/.local/share/applications" 2>/dev/null || true
+        fi
+
+        # Remove icon
+        if [ -f "\$ICON_FILE" ]; then
+            rm -f "\$ICON_FILE"
+            echo "  Removed icon"
+        fi
+
+        # Remove this launcher script last
+        echo "  Removed \$BIN_DIR/pairux"
+        echo ""
+        echo "PairUX has been uninstalled."
+        rm -f "\$BIN_DIR/pairux"
+        exit 0
+        ;;
+esac
+
+if [ -x "\$APPIMAGE" ]; then
     export ELECTRON_DISABLE_SANDBOX=1
-    exec "$APPIMAGE" "$@"
+    exec "\$APPIMAGE" "\$@"
 else
-    echo "Error: PairUX AppImage not found at $APPIMAGE"
+    echo "Error: PairUX AppImage not found at \$APPIMAGE"
     echo "Please reinstall: curl -fsSL https://installer.pairux.com/install.sh | bash"
     exit 1
 fi

apps/web/src/app/docs/page.tsx

@@ -25,6 +25,7 @@ const tableOfContents = [
   { id: 'control', title: 'Remote Control' },
   { id: 'security', title: 'Security' },
   { id: 'troubleshooting', title: 'Troubleshooting' },
+  { id: 'uninstalling', title: 'Uninstalling' },
   { id: 'faq', title: 'FAQ' },
 ];
 
@@ -69,6 +70,11 @@ const faqs = [
     answer:
       'Audio sharing is on our roadmap but not yet implemented. Currently, PairUX is focused on visual screen sharing and control.',
   },
+  {
+    question: 'How do I uninstall PairUX?',
+    answer:
+      'Run "pairux uninstall" to completely remove PairUX, including the desktop app, launcher script, desktop entry, and icon. On macOS, you can also drag PairUX from Applications to the Trash.',
+  },
 ];
 
 export default function DocsPage() {
@@ -357,6 +363,41 @@ export default function DocsPage() {
                     </ul>
                   </section>
 
+                  {/* Uninstalling */}
+                  <section id="uninstalling" className="mt-12">
+                    <h2>Uninstalling</h2>
+
+                    <h3>Linux</h3>
+                    <p>Run the built-in uninstall command to remove everything:</p>
+                    <pre>
+                      <code>pairux uninstall</code>
+                    </pre>
+                    <p>This removes the AppImage, launcher script, desktop entry, and icon.</p>
+                    <p>To uninstall manually:</p>
+                    <pre>
+                      <code>{`rm -rf ~/.pairux
+rm -f ~/.local/bin/pairux
+rm -f ~/.local/share/applications/pairux.desktop
+rm -f ~/.local/share/icons/hicolor/256x256/apps/pairux.png`}</code>
+                    </pre>
+
+                    <h3>macOS</h3>
+                    <p>
+                      Drag <strong>PairUX.app</strong> from your Applications folder to the Trash.
+                      To also remove the CLI launcher:
+                    </p>
+                    <pre>
+                      <code>rm -f ~/.local/bin/pairux</code>
+                    </pre>
+
+                    <h3>Windows</h3>
+                    <p>
+                      Open <strong>Settings → Apps → Installed apps</strong>, find PairUX, and click{' '}
+                      <strong>Uninstall</strong>. Alternatively, run the uninstaller from the Start
+                      Menu.
+                    </p>
+                  </section>
+
                   {/* FAQ */}
                   <section id="faq" className="mt-12">
                     <h2>Frequently Asked Questions</h2>