Troubleshooting

Start with the exact error or status shown in the app. Check app version and installation source before following instructions for a feature that may be build-specific.

Audio Or Transcription Is Missing

Check System Settings → Privacy & Security, grant the required access, and relaunch when requested. Select an available microphone in Settings → Audio, then test your speech and computer audio separately. Read warning chips such as mic stopped or system audio stopped.

For Parakeet, wait for local model readiness. For Apple Speech, select a supported language and install/check its language asset on compatible macOS 26+ systems. For Deepgram, validate the API key and check its account quota and network path.

Permissions · Audio · Transcription

AI Validation Or Analysis Fails

Open Settings → AI Providers and check the primary provider, exact model, status, credentials or sign-in, quota, and network access. A custom endpoint needs the correct base URL and model ID, image support, and suitable tool capabilities for document retrieval.

For subscription connections, follow the sign-in or re-check control; the Mac App Store build does not offer external subscription integrations. Retry after correcting the reported problem. A ready backup only switches automatically when failover is enabled.

AI providers · Custom endpoints

ExtraBrain AI Has No Access Or Credits

Check the eligible plan in Plan & Billing, then use Re-check status in ExtraBrain AI. Distinguish Pro required, Not included, No credits, and Temporarily unavailable. Use another ready provider when needed.

ExtraBrain AI · Activate or restore Pro

Local Gemma Is Not Ready

Wait for download verification/startup, then use the displayed retry action if needed. Check compatibility, storage, and memory. For a context-capacity error, shorten the request/context or use another suitable provider. Gemma is absent from the App Store build.

Local Gemma

An Imported Document Is Missing From Answers

Check that the file is TXT, Markdown, or a readable PDF under 10 MB, its status is Ready, and Use in analysis is on. Inspect the extracted preview and retry/reindex errors. A failed replacement may leave the previous version active. Ask a specific question about the file and check provider retrieval support.

Reference Documents

Screenshot Context Is Missing Or Wrong

Check Screen Recording permission, the active-window/whole-screen setting, and the current session’s screenshot entry. Use region capture to narrow the scope. If a fresh screenshot appears unexpectedly, check Take screenshot before analysis in Screenshot settings or Quick Settings.

Screen context

Overlay Is Hidden Or Cannot Be Clicked

Use the configured Toggle Window Visibility or Toggle Click-Through shortcut. Click-through settings are under Privacy; app icon visibility is under Privacy. Session-start automation may reapply privacy or opacity choices.

Shortcuts · Privacy · Automation

A Summary Fails Or Delete Is Disabled

Check provider readiness and the plan gate before retrying summary generation. A summary error does not remove saved session content. End the active session before deleting it. Use New for a fresh main view; use Session History deletion to remove stored data.

Session History

Phone Or MCP Cannot Connect

For Phone Control, keep the Mac awake, update both apps, enable the controller, scan a fresh code, and approve on the Mac. Cross-network use needs an enabled relay in the installed build/service.

For MCP, use the direct-download app, enable paired apps, use the one-time config within 15 minutes, and confirm approval. Revoke and recreate an expired or unwanted connection.

Phone Control · MCP connections

Still Stuck?

Send feedback with steps, expected/actual behavior, version, build, and provider/transcription mode. Keep API keys, license keys, pairing codes, and private session content out of the report.