getting started
Share your first file
MunchFile turns a local file into a live URL. Pick the tool that fits how you work.
For you — the Desktop app
No terminal needed. The app lives in your menu bar and handles everything.
- 01
Download
Download MunchFile for macOS and open the.dmg. Drag the app to your Applications folder. - 02
Open
Launch MunchFile. It lives in your menu bar — look for the Munchira icon in the top-right corner of your screen. - 03
Sign in
Click the menu bar icon → Sign in. Enter your email and click the link we send you. No password. - 04
Share a file
Drag any.mdor.htmlfile into the app window. Your live URL appears in the file list — click it to copy. - 05
Quick-share from anywhere
Select a file in Finder and press ⌘⇧M. The link lands on your clipboard instantly — no need to open the app.
For an AI agent or script — the CLI
Install the CLI, authenticate, and expose a file. The URL is yours to feed into any agent or pipeline.
1. Install
macOS — Homebrew
brew install ebuntario/munchfile/munchfileAny OS — npm (Node 20+)
npm install -g munchfile2. Sign in
munchfile loginWe'll email you a link. Click it and you're signed in.
3. Expose a file
munchfile watch ./notes.md
✅ Live: https://munchfile.dev/abc123The URL is stable — save it, share it, point an agent at it. Editing the file updates the page automatically.
See the CLI reference for all commands.
What's next
- Learn about visibility and sharing.
- Hitting an issue? Check the troubleshooting guide.
- Common questions in the FAQ.