Skip to main content

Troubleshooting

The AI isn't responding​

Check your provider is configured. Open Settings → AI Providers and make sure the provider you're using shows as connected. If it shows an error, try reconnecting.

Check your API key. If you're using a raw API provider (Anthropic, OpenAI, etc.), your key might have expired or run out of credits.

For Claude Code or Codex: The CLI session might have expired. Go to Settings → AI Providers and reconnect. For Claude Code, this opens a terminal window and you re-authenticate via browser.

Try re-indexing. Click the sidebar footer and look for a Re-index option, or ask the AI to re-index your notes. This rebuilds the search index from scratch.

Check the notes folder. Settings → General shows the path. Make sure it's pointing to the right folder.

Notes must be in the root folder. Coeus doesn't search subfolders. All your .md files need to be in the top level of the notes folder, not in subfolders.

Semantic search isn't working​

Check your embeddings configuration. Settings → AI Providers → Embeddings. Make sure the API URL, model, and dimensions are all correct.

Click Fill Embeddings. New notes don't get embeddings until this runs. If you added notes recently and they're not showing in semantic search, click Fill Embeddings.

Test the endpoint. If you're using Ollama, make sure it's running (ollama serve) and that the model is pulled (ollama pull nomic-embed-text).

Telegram bot isn't responding​

Check the bot is enabled. Settings → Integrations → Telegram → make sure the toggle is on.

Make sure Coeus is running. The bot only works while Coeus is open on your desktop. There's no cloud component keeping it alive when the app is closed.

Re-link if needed. If you got a new phone or Telegram account, generate a new link code and send /link CODE to the bot again.

Audio transcription is slow​

Local Whisper transcription speed depends on the model and your hardware. The tiny.en model is fastest; medium.en is slowest. On an Apple Silicon Mac, even medium.en is reasonably quick. On older hardware, stick to base.en or tiny.en.

For faster transcription, switch to the OpenAI API mode in Settings → Integrations → Speech.

A note has a conflict (Reload vs. Keep my edits)​

This happens when the note file changed on disk while you were editing it in Coeus: usually because a sync tool (Dropbox, iCloud) updated it, or because you were editing it in another app at the same time.

  • Reload: Discard your edits and load the version from disk
  • Keep my edits: Save your current edits, overwriting the disk version

If you're not sure which version has the content you want, open the file in a text editor to check before deciding.

Something else is wrong​

Open an issue on GitHub at github.com/digitalknk/coeus-app. Include your OS version and what you were doing when it happened.