Quick answers

Do I need the CLI or the desktop app?

The desktop app is for human use — share files without opening a terminal. The CLI is for AI agents and automation — install it, expose a file, and point any agent or pipeline at the stable URL. Both are free.

Is the desktop app available on Windows or Linux?

macOS only for now. The CLI works everywhere Node 20+ is installed.

Can I use the app and the CLI together?

Yes. They share ~/.munchfile/ so the watch list is the same. Run one at a time — the desktop app defers automatically if the CLI daemon is active.

What file types are supported?

Markdown and HTML — .md, .markdown, .html, and .htm. More file types are on the roadmap.

Where are my files stored?

Encrypted on Cloudflare R2. We only store the contents of files you explicitly share.

What happens if I'm offline?

MunchFile queues changes locally and syncs them when you're back online. Your existing links keep working from the last version we have.

Can I share a folder?

Yes. Every supported file in the folder gets its own link. New files added later are picked up automatically.

Is there a file size limit?

Yes — limits depend on your plan. See Pricing for details.

How do I delete a link?

Run munchfile unwatch <path>. The link stops working immediately.

Is there an API?

Not yet. If you have a use case, let us know on GitHub.

Where do I report a bug?

Open a GitHub issue with the output of munchfile status and a quick description.