Installation

Detailed installation and troubleshooting guide.

System Requirements

• macOS 10.15 (Catalina) or later
• Internet connection for AI API calls
• API key from OpenAI or Google Gemini

Installation Steps

1. Download

• Download Grammar Assistant (macOS only)
• Choose the latest version for your Mac (Apple Silicon or Intel)

2. Install

• Open the .dmg file
• Drag Grammar Assistant to Applications folder
• Launch from Applications

3. Security Prompt (First Launch)

If you see: "Grammar Assistant is damaged and can't be opened"

This happens because the app is not code-signed. Fix it:

sudo xattr -rd com.apple.quarantine "/Applications/Grammar Assistant.app"

Alternative method:

1. Right-click (or Control-click) the app → Open
2. If still blocked, open Terminal and run the command above

If you see: "Grammar Assistant cannot be opened because the developer cannot be verified"

1. Right-click the app → Open
2. Click Open in the confirmation dialog

TIP

These are one-time steps. macOS will remember your choice.

4. Grant Accessibility Permission

Required for Cmd+Shift+G to work:

1. System Settings → Privacy & Security → Accessibility
2. Click 🔒 to unlock (enter password)
3. Click + button
4. Find and add Grammar Assistant
5. Restart the app

Why is this needed?

Accessibility permission allows:

• Monitoring Cmd+Shift+G shortcut globally
• Auto-copying selected text
• Working across all apps

The app only activates when YOU press the shortcut.

Troubleshooting

"App is damaged" Error

If you see "Grammar Assistant is damaged and can't be opened":

sudo xattr -rd com.apple.quarantine "/Applications/Grammar Assistant.app"

This removes the quarantine flag that macOS adds to downloaded apps.

Shortcut Not Working

Check:

1. ✅ Accessibility permission granted?
2. ✅ App is running?
3. ✅ Tried restarting the app?

Still not working?

• Some apps may block shortcuts (rare)
• Check macOS keyboard shortcuts for conflicts
• Try in a different app (e.g., TextEdit)

App Crashes or Won't Start

1. Check macOS version (10.15+)
2. Try deleting app and reinstalling
3. Check Console.app for error logs

API Key Issues

• Make sure you copied the full key (no spaces)
• Verify key is active on provider's dashboard
• Check internet connection

Uninstalling

1. Quit Grammar Assistant
2. Move app to Trash from Applications
3. (Optional) Remove settings:

   ~/Library/Application Support/com.kitelus.grammar-assistant/

Getting Help

• 📖 Getting Started Guide
• 🔍 Search Issues
• ✍️ Create New Issue