cli reference

Commands

These are the commands the munchfile binary exposes. Run munchfile --help any time to see the same list from the terminal.

munchfile login

Sign in with a magic link. We email you a link; clicking it signs you in on this machine.

munchfile login

munchfile logout

Sign out of this machine. Your shared links keep working until munchfile is signed back in.

munchfile logout

munchfile watch <path>

Start sharing a file or folder. Single-file watches print the live URL.

munchfile watch ./notes.md

Flags:

  • --public — anyone with the link can view; can appear on your public profile.
  • --unlisted — anyone with the link can view; hidden from search.
  • --private — only you can view (this is the default).
  • --no-wait — don't wait to print the URL inline; useful in scripts.
Share publicly
munchfile watch ./blog-post.md --public

munchfile unwatch <path>

Stop sharing. The link will stop working.

munchfile unwatch ./notes.md

munchfile status

See what's currently shared from this machine, including each file's link and visibility.

munchfile status

munchfile logs

Show recent MunchFile logs. Helpful when something isn't working and you want detail.

munchfile logs

munchfile start / stop

Manually start or stop the MunchFile background service. You usually don't need these — watch starts it for you.

munchfile start
munchfile stop

munchfile relink <link> <new-path>

Point an existing link at a moved file. Same URL, new location on disk.

munchfile relink https://munchfile.dev/abc123 ./moved/notes.md

munchfile cleanup

Remove old links that point at files you no longer have. Walk through them interactively.

munchfile cleanup

munchfile profile

Manage your public profile page at munchfile.com/<your-username>.

munchfile profile

munchfile autostart

Make MunchFile start automatically when you log in. One command, survives reboots.

munchfile autostart
CLI reference — MunchFile Docs