Common problems

Each entry lists what you might see, the likely cause, and the exact command that fixes it.

⌘⇧M isn't working

Cause: The shortcut may be claimed by another app.

Fix: Check the tray icon — it shows "⌘⇧M unavailable" when conflicted. Use the Finder right-click Service instead: right-click a supported file → Services → Copy MunchFile link.

The Finder right-click Service doesn't appear

Cause: macOS Services only register on a signed build, or the file type isn't supported (e.g. .pdf).

Fix: Make sure you're right-clicking a .md or .html file. If you installed from the download page and it still doesn't appear, go to Apple menu → System Settings → Privacy & Security and confirm MunchFile is allowed under Automation.

The desktop app says "CLI is active"

Cause: The CLI daemon is running and holds the engine. The app starts without an active watcher to avoid conflicts.

Fix: Run munchfile stop to quit the CLI daemon — the app takes over automatically. Or keep using the CLI; the watch list is shared either way.

MunchFile isn't running

Symptom: Your links stopped updating, or munchfile status says nothing's running.

Fix: Start it.

munchfile start

To make it start every time you log in:

munchfile autostart

The link doesn't work

Symptom: Opening the link shows "This link doesn't work."

Likely cause: The file moved on disk, or you stopped sharing it.

Fix: See what's currently shared, then either re-share the file or point the link at its new location.

munchfile status
munchfile relink https://munchfile.dev/abc123 ./new-path/notes.md

I moved a folder and now the links are broken

Fix: Either fix each link with relink, or remove the links you don't need with cleanup.

munchfile cleanup

I'm logged out unexpectedly

Cause: Sessions can expire after long periods of inactivity.

Fix: Sign in again. Your shared links resume once MunchFile is signed in.

munchfile login

I changed visibility and the page hasn't updated

Cause: Pages are served through a CDN that caches briefly.

Fix: Wait ~30 seconds, then hard-refresh (Cmd+Shift+R / Ctrl+Shift+R).

Something's wrong but I don't know what

Start here:

munchfile status

If that doesn't make it obvious, get the details:

munchfile logs