Why is Super Command not appearing when I press the shortcut?

Check that Elephas is running (look for the menu bar icon), and that Elephas is enabled in System Settings > Privacy & Security > Accessibility. If another app uses the same shortcut, change it in Elephas Settings.

Why are AI responses slow in Elephas?

For Offline AI, larger models take longer to respond — try a smaller model. For Cloud AI, response time depends on your provider and internet connection. Large workspaces with many documents may also add a small delay during the initial search step.

Why is Elephas not citing my documents?

Make sure the relevant documents are indexed in the workspace you are querying. Check the indexing status (green indicator next to each file). If the question does not match your document content, try rephrasing.

What does 'You exceeded your current quota' mean?

You have reached the usage limit for your current Elephas plan. Upgrade to a higher tier from Settings > Account, or wait for the next billing cycle for limits to reset.

How do I fix 'Cannot send Apple Events' errors?

Open System Settings > Privacy & Security > Automation and enable Elephas for the relevant apps. Elephas needs Automation permission to interact with other apps via Super Command.

Elephas Troubleshooting: Common Issues and Fixes

Q: How do I share a crash report with Elephas support?

Open Finder, navigate to ~/Library/Logs/DiagnosticReports/, find the most recent Elephas crash log, and email it to support@elephas.app.

Super Command does not appear

If pressing Ctrl + Space does not open Super Command:

Check that Elephas is running (look for the icon in your menu bar)
Go to System Settings > Privacy & Security > Accessibility and make sure Elephas is enabled
Check if another app is using the same keyboard shortcut. Try changing the shortcut in Elephas Settings
Restart Elephas

AI responses are slow

Offline AI: Larger models take longer to respond. Try a smaller model in Settings
Cloud AI: Response time depends on the AI provider and your internet connection. Check your connection
Large workspaces with many documents may take slightly longer for the initial search step

Elephas is not citing my documents

Make sure the relevant documents are indexed in the workspace you are querying
Check that indexing completed (look for a green status indicator next to each file)
Your question may not match the content of your documents. Try rephrasing

App crashes or freezes

Make sure you are running the latest version of Elephas
Restart the app. If the issue persists, try removing and re-adding the problematic workspace
Contact support via the in-app Crisp chat or email if the issue continues

Subscription and billing

Upgrading your plan: Open Elephas Settings > Account to manage your subscription tier
"You exceeded your current quota": You have reached the usage limit for your plan. Upgrade to a higher tier or wait for the next billing cycle
Canceling: If you purchased through the App Store, manage your subscription in System Settings > Apple ID > Subscriptions. For direct purchases, email support@elephas.app

Permissions and automation errors

"Cannot send Apple Events": Go to System Settings > Privacy & Security > Automation and enable Elephas for the relevant apps
"Elephas can't control app": Same fix. Elephas needs Automation permission to interact with other apps via Super Command
Accessibility permission: Required for Super Command. Go to System Settings > Privacy & Security > Accessibility and enable Elephas
Allow JavaScript from Apple Events: If using Elephas with Safari, enable this in Safari > Develop menu > Allow JavaScript from Apple Events

Sharing crash reports

If Elephas crashes, you can help us fix the issue by sharing the crash report. Open Finder, go to ~/Library/Logs/DiagnosticReports/, find the most recent Elephas crash log, and email it to support@elephas.app.