Desktop Install

PilotDeck provides a native macOS desktop app based on Electron. The current build supports Apple Silicon (arm64).

Standard Install

1. 1
   Download and open the DMG

   Go to the PilotDeck latest Release page, download the Apple Silicon DMG file, then double-click the downloaded file.

2. 2
   Move it into Applications

   Drag PilotDeck.app into the Applications folder.

3. 3
   Launch

   Open PilotDeck from Launchpad or Finder.

Fix for DMG Files Received Through IM Apps

注意 · Warning

If you received the DMG file through sandboxed IM apps such as Feishu, WeChat, or QQ, macOS 14 (Sonoma) and later may reject the app because of the com.apple.provenance extended attribute, even when the code signature and notarization are valid.

Option 1: Run the Fix Script

bash install-pilotdeck.sh

The script will:

1. Find the installed PilotDeck.app
2. Clear macOS quarantine/provenance extended attributes
3. Verify code signing and Apple notarization

Option 2: Fix Manually

# Clear extended attributes
xattr -cr /Applications/PilotDeck.app

# Launch again
open /Applications/PilotDeck.app

提示 · Info

Technical background: macOS Sonoma introduced the com.apple.provenance extended attribute. Files downloaded by sandboxed apps such as Feishu or WeChat may be marked with this attribute, causing Gatekeeper to apply stricter policy checks. xattr -cr is safe here: Apple's notarization ticket is stored in Contents/CodeResources, not in extended attributes.

Configuration

After the desktop app starts, it launches the embedded PilotDeck Gateway service. The config path is the same as the Web version:

~/.pilotdeck/pilotdeck.yaml

On first launch, the app guides you through API key setup. For details, see Config File Reference.

Next Steps

Web Install

You can also use PilotDeck through the Web flow

Core Features

Learn about PilotDeck's core capabilities