---
name: run
description: Build and launch BrewBar.app for manual testing. Use after making changes to verify the app runs and the menu bar icon appears correctly.
disable-model-invocation: false
---

Build and launch BrewBar for manual testing.

Steps:
1. Build the app in Debug configuration:
   ```
   xcodebuild \
     -project BrewBar.xcodeproj \
     -scheme BrewBar \
     -configuration Debug \
     -destination "platform=macOS" \
     build \
     SYMROOT=build \
     2>&1
   ```
   If the build fails, stop here and report the errors with explanations.

2. If the build succeeds, open the built app:
   ```
   open build/Debug/BrewBar.app
   ```

3. Tell the user:
   - The app is a menu bar app (.accessory policy) — it will NOT appear in the Dock, only in the menu bar at the top right of the screen
   - Look for the BrewBar icon in the menu bar to confirm it launched
   - Clicking the icon opens the menu; the app runs Homebrew commands in the background
   - To quit, use the Quit option in the app's menu

Note: If a previous instance is already running, macOS may bring it forward instead of launching a new one. Quit the existing instance first if you need a fresh launch.