Up and Running
in Minutes
Two paths: do it yourself in 3 steps, or let the Claude Code agent skill handle it for you.
Deploy Your Worker
One click. Cloudflare creates your Worker, provisions KV storage, and prompts you for an API key. Everything in one flow.
During deploy, you'll be asked to:
- →Choose a Worker name (or keep "mdrop")
- →Set your
API_KEY— pick any strong string and save it
After deploy, copy your Worker URL (e.g., https://mdrop.username.workers.dev)
Install the CLI
npm install -g mdrop Connect & Share
# Point the CLI at your Worker mdrop init # Paste your Worker URL and the API key you chose # Share your first file mdrop README.md --theme brutalist # → https://your-worker.workers.dev/a1b2c3d4
Custom Domain (optional)
Want pages at share.yourdomain.com?
- Go to Workers & Pages → your mDrop Worker → Settings → Domains & Routes
- Click Add → Custom Domain
- Enter your subdomain — Cloudflare handles DNS and SSL
- Run
mdrop initagain with your new domain
Quick Reference
# Themes mdrop file.md --theme clean # minimal sans-serif (default) mdrop file.md --theme brutalist # hard borders, monospace mdrop file.md --theme terminal # green on black, hacker mdrop file.md --theme academic # serif, paper, LaTeX mdrop file.md --theme playful # rounded, colorful # Expiry mdrop file.md --expires 1h # 1 hour mdrop file.md --expires 7d # 7 days (default) mdrop file.md --expires never # permanent # Management mdrop list # list shared pages mdrop delete a1b2c3d4 # delete a page mdrop preview file.md # preview before sharing
Install the Agent Skill
The mDrop agent skill lets Claude Code handle everything — setup, deploy, and sharing. One command installs it.
curl -fsSL https://raw.githubusercontent.com/vincenthopf/mdrop/main/skill/install.sh | bash
This clones the repo to ~/.agents/mdrop and symlinks the skill to ~/.claude/skills/mdrop.md.
Use It
Once installed, just tell Claude Code what you want:
"Share this README"
Claude checks if mDrop is configured, installs it if needed, renders the file, uploads it, and gives you the URL.
"Set up mDrop"
Claude walks you through the full setup — deploying the Worker, installing the CLI, and configuring everything.
"/mdrop notes.md --theme terminal"
Direct invocation with the slash command. Same as running mdrop from the terminal.
What the Skill Does
1.Checks if mdrop CLI is installed
2.Checks if it's configured (Worker URL + API key)
3.If not → walks you through deploy + install + configure
4.If ready → runs the command and returns your URL
Windows
On Windows (PowerShell or WSL), clone manually and copy the skill file:
# PowerShell git clone https://github.com/vincenthopf/mdrop $env:USERPROFILE\.agents\mdrop Copy-Item $env:USERPROFILE\.agents\mdrop\skill\mdrop.md $env:USERPROFILE\.claude\skills\mdrop.md