MAUI Sherpa

Your guide to .NET MAUI development

MAUI Sherpa is a desktop application for macOS, Windows, and Linux that helps manage your .NET MAUI development environment. It provides a unified interface for Android SDK management, Apple Developer tools, environment diagnostics, DevFlow app inspection, and GitHub Copilot integration.

🌐 Visit the website →

• Check your development environment health
• Diagnose .NET SDK, workloads, and dependencies
• AI-powered fix suggestions via Copilot
• One-click environment repairs

• Browse and install SDK packages
• Manage platform tools, build tools, and system images
• Search and filter packages
• Track installed vs available packages

• View USB and Wi-Fi devices alongside Android emulators
• Pair and connect devices using wireless debugging
• Create, start, stop, and delete emulators, including bulk deletion
• Search and filter emulators by state, device type, and Android version

• Pair a device without Android Studio from Android Devices > Pair over Wi-Fi; the sheet lists Available Devices (found on your network, refreshed every few seconds) and My Devices (connected to adb, with live status)
• Enable Developer options > Wireless debugging on an Android 11+ phone or Android 13+ TV/Wear OS device
• For QR pairing, choose Pair over Wi-Fi… in Sherpa and Pair device with QR code on the device; scan with that scanner, not the regular camera app. Codes are single-use and expire after 3 minutes; Stop cancels.
• For code pairing, choose Pair device with pairing code on the device, then Pair on its row under Available Devices and enter the six-digit code; codes are never saved or logged
• If Android does not connect automatically, use Connect on its row, or Reconnect for an offline Wi-Fi device under My Devices
• When the network blocks discovery (guest Wi-Fi, VPNs, isolation), open Enter an address manually to pair or connect by IP address and port; the pairing and debugging ports differ
• On macOS, allow MAUI Sherpa under System Settings › Privacy & Security › Local Network. If the ADB server was started by an app without that access, Sherpa shows Restart ADB, which relaunches it from Sherpa (briefly disconnecting all Android devices)
• Sherpa also discovers devices with a private, discovery-only ADB server, because a long-running ADB server often misses devices announced after it starts; after pairing, Sherpa connects the device for debugging
• Requires current Android SDK platform-tools and the same Wi-Fi network. QR pairing needs ADB mDNS discovery.

• Create and manage Android signing keystores
• View certificate signatures and details
• Export PEPK keys for Google Play
• Cloud sync keystores across machines

• Xcode Management: Browse available Xcode versions, download directly from Apple with authenticated sign-in (SRP + 2FA), and install — all from within the app
• Simulators: Manage iOS/iPadOS/tvOS/watchOS simulators with built-in inspector
• Bundle IDs: Create and manage App IDs with capabilities editor
• Devices: Register devices for development and ad-hoc distribution
• Certificates: Create, download, export, and revoke signing certificates
• Provisioning Profiles: Create, edit, and manage profiles with CI secrets export
• Root Certificates: Install Apple root certificates for development

• Android: Logcat viewer, file browser, shell, screen capture, and device tools
• iOS Simulator: Log viewer, app manager, screen capture, and simulator tools

• Remote visual tree inspection of running MAUI apps
• Interactive screenshot with element highlighting
• Network request monitoring with detailed views
• Application log streaming (native + WebView)
• Blazor WebView DOM inspection via CDP
• Live property editing (colors, sizes, brushes)
• sherpa-inspector dotnet tool package and self-contained executable for embedding the inspector in external WebViews (website, docs)

• Bundle Apple + Android signing configs into reusable profiles
• Publish secrets to GitHub, GitLab, Azure DevOps repositories
• Multi-destination publishing with review workflow

• Chat with Copilot directly in the app
• Get AI-assisted help with your development environment
• Suggested prompts for common tasks

Download the latest release from the Releases page, or see the Getting Started guide for detailed instructions.

brew install --cask redth/tap/maui-sherpa

1. Download MAUI-Sherpa.macos.zip
2. Extract and move MAUI Sherpa.app to Applications
3. Right-click and select "Open" on first launch (to bypass Gatekeeper)

winget install Maui.Sherpa

This becomes available once the generated manifest is accepted into the upstream microsoft/winget-pkgs repository.

1. Download MAUI-Sherpa.win-x64.zip or MAUI-Sherpa.win-arm64.zip
2. Extract to your preferred location
3. Run the self-contained MauiSherpa.exe (no separate .NET or Windows App SDK installation required)

Download AppImage, .deb, or Flatpak from the releases page for your architecture (x64 or arm64).

To use the Apple Developer tools, you'll need to configure your App Store Connect credentials:

1. Go to App Store Connect → Users and Access → Integrations → Individual Keys
2. Create a new API key with "Developer" access
3. Download the .p8 key file
4. In MAUI Sherpa, click the identity picker and add your credentials:
   • Issuer ID: Found on the Keys page
   • Key ID: The ID of your API key
   • Private Key: Contents of the .p8 file

Your credentials are stored securely in the system keychain.

To use the Copilot integration:

1. Install GitHub Copilot CLI
2. Authenticate with gh auth login
3. MAUI Sherpa will automatically detect and connect to Copilot

# Clone the repository
git clone https://github.com/Redth/MAUI.Sherpa.git
cd MAUI.Sherpa

# Restore dependencies
dotnet restore

# Build for macOS (AppKit)
dotnet build src/MauiSherpa.MacOS -f net10.0-macos

# Build for Windows (Windows only)
dotnet build src/MauiSherpa -f net10.0-windows10.0.19041.0

# Run tests
dotnet test

MAUI.Sherpa/
├── src/
│   ├── MauiSherpa/               # Shared MAUI Blazor Hybrid UI + Windows app head
│   │   ├── Components/           # Reusable Blazor components
│   │   ├── Pages/                # Blazor page components
│   │   ├── Services/             # Platform-specific services
│   │   └── Platforms/            # Platform code (Windows)
│   ├── MauiSherpa.MacOS/         # macOS AppKit app head
│   ├── MauiSherpa.LinuxGtk/      # Linux GTK4 app head
│   ├── MauiSherpa.Core/          # Business logic library
│   │   ├── Handlers/             # Mediator request handlers
│   │   ├── Requests/             # Request records
│   │   ├── Services/             # Service implementations
│   │   └── ViewModels/           # MVVM ViewModels
│   └── MauiSherpa.Workloads/     # .NET workload querying library
├── tests/
│   ├── MauiSherpa.Core.Tests/    # Core library tests
│   └── MauiSherpa.Workloads.Tests/ # Workloads library tests
├── website/                      # GitHub Pages website
└── docs/                         # Documentation

# Run all tests
dotnet test

# Run with coverage
dotnet test --collect:"XPlat Code Coverage"

# Run specific test project
dotnet test tests/MauiSherpa.Core.Tests

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

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

• .NET MAUI - Cross-platform UI framework
• Platform.Maui.MacOS - macOS AppKit backend for .NET MAUI
• Microsoft.Maui.Platforms.Linux.Gtk4 - Linux GTK4 backend for .NET MAUI
• Shiny.Mediator - Mediator pattern with caching
• AndroidSdk - Android SDK management APIs
• AppleDev.Tools - Apple Developer Tools APIs and AppStoreConnect API client
• MAUI DevFlow - Remote app inspection agent
• GitHub Copilot - AI-powered assistance via Copilot SDK