Troubleshooting

Find your problem below and try the fix in the right column. Most problems come down to a provider that isn’t connected, a missing macOS permission, or an old copy of the app. If nothing here helps, send diagnostics and ask on Discord.

Try these first

Quit and reopen Enconvo. Choose Quit from the Enconvo menu bar icon, then open Enconvo from Applications.
Update. Choose Check for Updates from the menu bar icon.
Check the model. Open Settings → AI Model and make sure the provider you use is connected. If you’re not sure, sign in to your Enconvo account and use Auto Route.
Check permissions. Open Settings → Permissions and turn on what the feature needs. See Permissions.

Answers and models

Problem	What to do
No answer, or an error about the provider	Open the provider in Settings → AI Model and click Validate. For a plan sign-in, open the account card’s menu and click Reconnect.
An error about limits, quota, or points	Check the provider’s usage page, or Settings → Points Usage for Enconvo Cloud. Switch to another provider for now.
Every cloud provider fails	Check your internet connection. Behind a proxy, check Use System Network Proxy Preferences under Network Proxy in Settings → General.
Answers are slow	Pick a smaller or faster model, attach less context, or lower the reasoning effort. Local models slow down with long inputs.
One model fails, others work	The problem is with that model or provider. Pick another model in the chat’s model picker.
Ollama or LM Studio doesn’t connect	Make sure the server is running and BaseUrl matches its address, then click Refresh beside Model Name. See Ollama or LM Studio.

Shortcuts and windows

Problem	What to do
A shortcut does nothing	Another app may use the same keys, such as Spotlight, Raycast, or Alfred. Change one of them in Settings → Shortcut.
Shortcuts stopped working after an update	Quit and reopen Enconvo. If that doesn’t help, turn Accessibility off and on for Enconvo in System Settings.
You can’t find the app	Enconvo lives in the menu bar. Click its icon, or press ⇧⌘D for SmartBar.

Selected text and the screen

Problem	What to do
PopBar doesn’t appear, or Enconvo can’t read the selected text	Turn on Accessibility for Enconvo in System Settings → Privacy & Security → Accessibility. If it’s already on, turn it off, wait two seconds, turn it back on, and reopen Enconvo. Secure fields and some custom editors don’t share their text.
Screenshots, OCR, or screen context fail	Turn on Enconvo in System Settings → Privacy & Security → Screen & System Audio Recording, then reopen Enconvo.
A permission is on but has no effect after an update	Remove Enconvo from that list in System Settings with −, add it again, and reopen Enconvo.

Voice and audio

Problem	What to do
Dictation hears nothing	Check Microphone permission, and the microphone selected in Settings → Dictation.
Dictation is wrong or slow	Try another speech model in Settings → Dictation Models. Add names and terms to Settings → Dictionary.
Read Aloud is silent	Check your Mac’s volume and output device. Try System in Settings → Text-to-Speech; it needs no key and works offline.

See Dictation and Speech recognition for more.

Knowledge Base

Problem	What to do
Documents don’t finish indexing	Check the embedding provider in Settings → KnowledgeBase, and that the file type is supported.
Searches find nothing	Make sure the knowledge base is attached to the chat. Lower the score threshold or raise the number of results in the knowledge base’s settings.
A large knowledge base is slow	Split it into smaller knowledge bases by topic, or add a reranker.

See Knowledge Base and Knowledge Base settings.

Browser, apps, and plugins

Problem	What to do
Enconvo can’t control your browser	Install the Enconvo Companion extension from Settings → Browser Use, then restart the browser. See Browser extension.
An Agent can’t use your apps	Turn on the permissions Settings → Computer Use asks for. See Computer Use.
A plugin command fails	Open Settings → Plugins, check the plugin’s settings and credentials, and update Enconvo.

Send diagnostics

When Enconvo freezes, crashes, or keeps misbehaving, send diagnostic logs to the Enconvo team. Choose Submit Diagnostics… from the menu bar icon, or open Settings → Diagnostics. Enconvo removes personal details, such as file names, email addresses, keys, and the text of your prompts, before anything leaves your Mac, and shows you exactly what was sent. See Privacy and security.

Get help

Ask on Discord. Include your Enconvo version (Settings → About), your macOS version, what you did, and what happened.
Report a problem or suggest a feature with Feedback in the menu bar menu.
Check the FAQ for quick answers.

Get started

Ask AI anywhere

Voice

Recordings and transcripts

Context, knowledge, and the web

Write and create

Files and utilities

Agents and AI Commands

Workflows and automations

Plugins and integrations

iPhone

Settings and account

Reference

Try these first

Answers and models

Shortcuts and windows

Selected text and the screen

Voice and audio

Knowledge Base

Browser, apps, and plugins

Send diagnostics

Get help

​Try these first

​Answers and models

​Shortcuts and windows

​Selected text and the screen

​Voice and audio

​Knowledge Base

​Browser, apps, and plugins

​Send diagnostics

​Get help

Try these first

Answers and models

Shortcuts and windows

Selected text and the screen

Voice and audio

Knowledge Base

Browser, apps, and plugins

Send diagnostics

Get help