Troubleshooting
The file tree is empty after opening a vault
Section titled “The file tree is empty after opening a vault”mdai indexes .md, .markdown, .mdown and .mkd files (any letter
case). Check that your notes have one
of those extensions and are not inside hidden folders (names starting
with . are skipped, e.g. .git).
AI actions return an error
Section titled “AI actions return an error”- Invalid key — re-paste the key in Settings; make sure it belongs to the selected provider.
- Quota/billing — check your balance in the provider’s dashboard; prepaid credits may have run out.
- Network — AI with a cloud provider needs a connection (with Ollama it stays on your computer). Writing, search, tasks and everything else work offline. mdai goes online only for: starting the trial; activating, deactivating or freeing a device, or Show my devices, in Settings → License; checking the list of revoked license keys (at most once every 30 days, only on an activated copy); checking whether a newer version exists (at most once a day, not in the Microsoft Store, Flatpak or Arch Linux versions); publishing to your own site; and AI actions and Ask vault with a cloud provider. The Mac App Store version makes none of the trial, license and update requests; instead it contacts mdai.me only when you ask it for a Windows or Linux key. The complete list is on the privacy page.
License won’t activate
Section titled “License won’t activate”- Activation needs a one-time internet connection.
- Each key works on 3 devices. If all three are in use, mdai lists them and lets you free one from inside the app — Settings → License, then Free next to the device you no longer use. You can also free the current device at any time with Deactivate.
- If you can no longer reach a device to free it, write to [support@mdai.me](mailto:support@mdai.me) and we'll sort it out.
- Check for typos: keys are safest copy-pasted from the purchase email.
A file changed outside mdai and I see a prompt
Section titled “A file changed outside mdai and I see a prompt”That’s by design: the file changed on disk (sync tool, another editor) while you had unsaved edits in mdai. Choose which version to keep — mdai never silently overwrites either side.
Windows says the app is unrecognized
Section titled “Windows says the app is unrecognized”That is the direct .exe, which is not code-signed yet. Install mdai from
the Microsoft Store instead and the warning does not appear at all — the
Store copy is signed by Microsoft. If you would rather keep the direct
installer, see Install for the Edge and SmartScreen
steps and the checksums.
Windows: “Documents is protected”
Section titled “Windows: “Documents is protected””Controlled folder access in Windows Security can block apps from writing to Documents. When it stops mdai from creating a folder there, mdai says so and offers a folder in your user folder instead. To keep your notes in Documents, allow mdai in Windows Security → Virus & threat protection → Ransomware protection → Allow an app through Controlled folder access.
Something else?
Section titled “Something else?”Write to support@mdai.me with your OS and a short description. Bug reports with steps to reproduce get fixed fastest.