Troubleshooting
macOS says the app is damaged or cannot be opened
Remove quarantine attributes and relaunch:
bash
xattr -d com.apple.quarantine "/Applications/Minion Mind.app"A plugin is installed but looks inactive
Check all of these:
- The vault is trusted.
- The plugin is enabled.
- The plugin view or ribbon icon exists.
- The setting page opens.
A file type opens incorrectly
Possible causes:
- A plugin has claimed the file type.
- The host compatibility layer for that custom view is incomplete.
- The file is opening in an old tab that was created before the custom view loaded.
PDFs, Canvas, or Excalidraw feel inconsistent
- Reopen the file after the vault finishes loading.
- Confirm the plugin or built-in view is actually registered.
- If an interaction works only the first time, suspect a host-side compatibility issue rather than the file itself.
Agent bridge connects in terminal but not in the plugin
- The command path may be right, but the plugin arguments may still be wrong.
- Some bridges must stay alive and wait on stdio.
- A CLI that exits immediately is usually not a working ACP bridge for a live view.
Still blocked
- Reproduce the issue with the fewest enabled plugins possible.
- Capture the exact file type, plugin, and command path involved.
- Then compare behavior in a clean vault versus your real vault.