Troubleshooting
The file tree is empty after opening a vault
Section titled “The file tree is empty after opening a vault”mdai indexes .md and .markdown files. Check that your notes have one
of those extensions and are not inside hidden folders (names starting
with . are skipped, e.g. .git, .obsidian).
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 needs a connection; everything else in mdai works offline.
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 SmartScreen explanation
and the checksums.
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.