try fixing instructions for unsigned app

Author: 6

.github/workflows/release.yml

@@ -57,7 +57,22 @@ jobs:
             - macOS 10.15 or later
             - Node.js (for ccusage CLI functionality)
 
-            **Note**: This build is not code-signed. You may need to right-click and select "Open" the first time you run it, or go to System Preferences > Security & Privacy to allow it to run.`
+            **Important: First-time setup for unsigned app**
+            
+            If you see "ccusage-macos-menubar.app is damaged and can't be opened":
+            
+            1. Open Terminal
+            2. Run this command:
+               \`\`\`bash
+               xattr -cr /Applications/ccusage-macos-menubar.app
+               \`\`\`
+            3. The app should now open normally
+            
+            Alternative method:
+            - Right-click the app and select "Open"
+            - Click "Open" in the dialog that appears
+            
+            This only needs to be done once. The app is not actually damaged - macOS shows this message for unsigned apps downloaded from the internet.`
             });
             return data.id;
 

CLAUDE.md

@@ -183,9 +183,24 @@ No Apple Developer account required. To create a release:
 
 ### Requirements
 - Targets Apple Silicon Macs only (M1/M2/M3)
-- No code signing (users need to right-click → Open on first launch)
+- No code signing (see "First Run Instructions" below)
 - Requires Node.js installed on the user's machine for ccusage functionality
 
+### First Run Instructions
+Since the app is not code-signed, macOS may show "app is damaged and can't be opened" when downloading from GitHub releases.
+
+**To fix this:**
+```bash
+# After moving the app to /Applications, run:
+xattr -cr /Applications/ccusage-macos-menubar.app
+```
+
+**Alternative method:**
+1. Right-click the app and select "Open"
+2. Click "Open" in the security dialog
+
+This only needs to be done once. The app is safe - macOS shows this for all unsigned apps downloaded from the internet.
+
 ### Manual Release Process
 If you prefer to build and release manually:
 ```bash