BUILD INSTRUCTIONS

# Quick Build Instructions

## Option 1: Create Xcode Project Manually (Recommended)

1. **Open Xcode**
2. **File → New → Project**
3. Choose **macOS → App**
4. Settings:
   - Product Name: `ClaudePromptRefiner`
   - Interface: `SwiftUI`
   - Language: `Swift`
   - Organization Identifier: `com.yourname`
   - Save in: `/Users/aimanyounis/ClaudePromptRefiner`

5. **Delete default ContentView.swift** (we have SettingsView instead)

6. **Add our files:**
   - They're already in the folder!
   - Just drag them into Xcode:
     - ClaudePromptRefinerApp.swift
     - AppDelegate.swift
     - ClipboardMonitor.swift
     - SettingsView.swift

7. **Replace Info.plist:**
   - Right-click `Info.plist` in Xcode
   - Open As → Source Code
   - Replace with contents of our `Info.plist`

8. **Configure Signing:**
   - Select project in Xcode
   - Go to **Signing & Capabilities**
   - Choose your Team
   - Bundle Identifier: `com.yourname.ClaudePromptRefiner`

9. **Build & Run:**
   - Press ⌘R
   - Grant Accessibility permissions when prompted
   - Look for the wand icon (🪄) in menu bar

## Option 2: Use Existing Project

If you already have an Xcode project:

1. Add all `.swift` files to your project
2. Update `Info.plist` with:
   - `LSUIElement` = `YES` (menu bar only, no dock icon)
   - Accessibility usage description
   - Apple Events usage description
3. Make sure `@main` is on `ClaudePromptRefinerApp`

## Enable Required Permissions

After first run, you'll need to:

1. **System Settings → Privacy & Security → Accessibility**
   - Enable `ClaudePromptRefiner` ✅

2. **System Settings → Privacy & Security → Automation** (if needed)
   - Allow `ClaudePromptRefiner` to control other apps

## Test It

1. Open TextEdit or any text editor
2. Type: `write me a story about a cat`
3. Select that text
4. Press **⌘⇧P**
5. Claude should open with refinement request
6. Copy Claude's response (⌘C)
7. Watch it auto-paste back! 🎉

## Troubleshooting

### "App can't be opened because it is from an unidentified developer"
- Right-click app → Open
- Or disable Gatekeeper temporarily: `sudo spctl --master-disable`

### Hotkey doesn't register
- Check Accessibility permissions
- Try logging out and back in
- Restart the app

### Can't capture selected text
- **Must grant Accessibility access**
- System Settings → Privacy & Security → Accessibility
- Add ClaudePromptRefiner and enable it

### Build errors in Xcode
- Make sure deployment target is macOS 13.0+
- Check that all Swift files are added to target
- Clean build folder: ⌘⇧K

## Advanced: Customize the Hotkey

To change from ⌘⇧P to something else:

In `AppDelegate.swift`, find: