Skip to content

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).

  • 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.
  • 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.

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.

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.

Write to support@mdai.me with your OS and a short description. Bug reports with steps to reproduce get fixed fastest.