Sound Copilot — macOS installation
==================================

Requirements
------------
- macOS 11 or later
- REAPER 7.x (64-bit; Apple Silicon or Intel)

Install
-------
1. Quit REAPER completely (Cmd+Q). A reload is not enough after installing extensions.

2. Copy the extension file from this archive into REAPER's UserPlugins folder:

     reaper_sound_copilot-arm64.dylib

   The chat UI is embedded inside this file (no separate HTML to install).

   Default location:

     ~/Library/Application Support/REAPER/UserPlugins/

   Create the UserPlugins folder if it does not exist.

3. If you downloaded the archive from the web, remove the quarantine flag (Gatekeeper):

     xattr -d com.apple.quarantine \
       ~/Library/Application\ Support/REAPER/UserPlugins/reaper_sound_copilot-arm64.dylib

   (Ignore errors if the attribute is not present.)

4. Start REAPER.

Open Sound Copilot
------------------
- Actions → search "Sound Copilot: Show chat window" → Run
- Or View → Dockers → Sound Copilot

Verify
------
- First launch: follow the welcome screen to add an API key (Settings → AI token).

Uninstall
---------
Quit REAPER, then delete:

  ~/Library/Application Support/REAPER/UserPlugins/reaper_sound_copilot-arm64.dylib

Settings are stored in REAPER extended state (section sound_copilot).
