Skip to main content

Troubleshooting

Audience: users hitting friction; contributors triaging reports.

App will not start​

  • Confirm OS version meets release notes.
  • Try a clean reinstall after backing up export paths described in release docs.
  • Check logs if your build writes them (contributors: ILoggerService / platform conventions).

Search or navigation feels broken​

  • Global search depends on registered providers per module; ensure content type exists (e.g. notes indexed).
  • After large imports, wait for background indexing if applicable.

AI features unavailable or slow​

  • First generation may cold-start local inference servers (LlamaCppServerManager); wait or check Settings for model/download state.
  • GPU paths depend on hardware detection—integrated GPUs may throttle.

Editor or mind map shortcuts do nothing​

Keybinds route through IKeyMap + IKeybindActionRouter; conflicts or focus scope can swallow chords. Check Settings → keybindings when present.

Contributors: correlate symptoms with Startup flow and Module system.