# Watchman for Safari

## Version
**Watchman v1.1.3** — synced with the Chrome/Edge extension.

## Requirements
- macOS Catalina 10.15.6 or later
- Xcode 12 or later
- Safari 14 or later
- Apple Developer Account ($99/year for App Store distribution)

## Converting to Safari Extension

Safari requires extensions to be wrapped in a macOS app. Use Apple's converter tool:

### Step 1: Convert the Extension
```bash
xcrun safari-web-extension-converter /path/to/extensions/safari \
  --project-location ~/Desktop/WatchmanSafari \
  --bundle-identifier com.yourcompany.watchman \
  --app-name "Watchman" \
  --swift \
  --macos-only
```

### Step 2: Build in Xcode
1. Xcode opens automatically after conversion
2. Select your development team (requires Apple Developer account)
3. Click Build (Cmd+B) to compile
4. Click Run (Cmd+R) to install

### Step 3: Enable in Safari
1. Open Safari Preferences > Extensions
2. Check the box next to "Watchman"
3. Grant necessary permissions when prompted

## Testing Without App Store

1. Safari > Settings > Advanced > "Show Develop menu in menu bar"
2. Develop > Allow Unsigned Extensions
3. Build and run from Xcode

## App Store Distribution

1. In Xcode: Product > Archive
2. Click "Validate App" to check for errors
3. Click "Distribute App" > App Store Connect
4. Complete submission in App Store Connect

## Alternative: Web-Based Converter (2024)
Apple now offers a web-based converter in App Store Connect:
1. Upload the Safari extension ZIP directly
2. App Store Connect auto-converts and packages
3. No Xcode required

## Notes
- Safari does not support sidepanel API (extension uses popup fallback)
- All 7 AI platforms supported: ChatGPT, Claude, Gemini, Copilot, Perplexity, Grok, X.com
- macOS and iOS versions can be created from same source
