# hushdrop [Health: Active]
**Category:** ๐ป Developer Tools
**Repository:** https://github.com/maxtechera/hushdrop
**GitHub Stars:** 8
**Views:** 0
**Installs:** 0
**Upvotes:** 0
**Directory Page:** https://allmcps.com/mcp/hushdrop
## Description
Open-source artifact sharing for AI agents: private, branded, zero-knowledge links.
## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):
```json
"mcpServers": {
"hushdrop": {
"command": "npx",
"args": ["-y","skills"]
}
}
```
## Documentation & README
# Hushdrop
**Share what your AI builds โ on your own domain.**
Open-source, self-hosted artifact sharing. Drop a file, an HTML page, or a whole site and get a
branded, **password-protected (zero-knowledge AES-256)** link on **your own domain** in ~1 second โ
from your terminal or any AI agent. The open-source alternative to Stacktree.
[](https://www.npmjs.com/package/hushdrop)
[](https://www.npmjs.com/package/hushdrop)
[](https://github.com/maxtechera/hushdrop/actions/workflows/ci.yml)
[](LICENSE)
[](https://github.com/maxtechera/hushdrop/stargazers)
[**Live demo โ**](https://hushdrop.dev) ยท [Docs](https://hushdrop.dev/docs) ยท [Try in browser](https://hushdrop.dev/try) ยท [vs Stacktree](https://hushdrop.dev/stacktree-alternative)
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fmaxtechera%2Fhushdrop&stores=%5B%7B%22type%22%3A%22blob%22%7D%5D)
---
## Quick start
The core way to use Hushdrop is **from your agent** โ it publishes what it builds to your own domain.
**Claude Code** (recommended โ auto-updates via the plugin marketplace):
```bash
/plugin marketplace add maxtechera/hushdrop
/plugin install hushdrop
```
**Cursor ยท Codex ยท Copilot ยท Gemini ยท 20+ Agent Skills hosts:**
```bash
npx skills add maxtechera/hushdrop-skill
```
**No install** โ open **[hushdrop.dev/try](https://hushdrop.dev/try)**, drop an HTML file, get a link. No account.
**One-off from the terminal** โ zero install, zero setup, no account:
```bash
npx hushdrop report.html # โ https://hushdrop.dev/u/xxxx (+ password, copied) โ no setup, no account
```
**Free hosted account** โ persistent links on your own handle (`hushdrop.dev/you/`):
```bash
npx hushdrop login # passwordless: GitHub or magic link
npx hushdrop report.html # โ https://hushdrop.dev/you/report-a1b2 (persistent)
```
**Your own domain** โ self-host on your Vercel Blob (free, MIT, your URL + brand forever):
```bash
# one-click: the "Deploy with Vercel" button above auto-provisions a Blob store โ then:
npx hushdrop-install # wire your agents + CLI
hush deploy --domain share.yoursite.com # or do it from a local clone
```
No dashboard required. Two commands to try; one more to own.
## Why this exists
Anthropic shipped artifact sharing so teams could hand each other the things they make with AI. It's
great โ and it's locked to their surface, their domain, their account. Stacktree does the agent-native
version, but it's a closed SaaS: your content sits on their servers, custom domains and limits are
paywalled, and you can't audit or self-host it.
I make things all day with agents: reports, proposals, guides, dashboards, whole little sites. I wanted
to hand someone a link that's **mine** โ my domain, my brand, my keys โ in the time it takes to type one
command, without uploading client work to someone else's server. So `hush` does exactly that:
terminal-native, zero-knowledge, on your own domain, usable from any agent. MIT.
## Hushdrop vs. the alternatives
| | **Hushdrop** | Stacktree | send.co | tiiny.host |
|---|:---:|:---:|:---:|:---:|
| Your own domain | โ
free | โ | โ | paid |
| Zero-knowledge AES-256 | โ
| โ
| files only | โ |
| Open-source / self-host | โ
MIT | โ | โ | โ |
| CLI + MCP (agent-native) | โ
| partial | โ | โ |
| Anonymous, no-account drop | โ
| โ | โ
| โ
|
| Burn-after-read / email-gate | โ
| partial | partial | โ |
| Price | **free / self-host** | paid | freemium | freemium |
Full write-ups: [vs Stacktree](https://hushdrop.dev/stacktree-alternative) ยท [vs Send](https://hushdrop.dev/send-co-alternative) ยท [vs ShareDuo](https://hushdrop.dev/shareduo-alternative)
## Features
- ๐ **Zero-knowledge** โ branding + AES-256 happen client-side; the server only stores ciphertext.
- ๐ **Your domain, your brand** โ colors, logo, social cards flow into the unlock gate + previews.
- ๐ค **Agent-native** โ one CLI command or 9 MCP tools; any agent that runs a shell can publish.
- โฑ๏ธ **Auto-expire & burn-after-read** โ `--expire 7d`, `--burn`, server-enforced cleanup.
- ๐ง **Email-gate & revocable share links** โ restrict by domain, mint/revoke guest links.
- ๐ฆ **Anything static** โ HTML, Markdown (rendered), PDFs, images, multi-file zips โ sites.
- ๐ **One-click self-host** โ Deploy to Vercel auto-provisions Blob; no DB to run.
## What you can drop
| You run | You get |
|---------|---------|
| `hush report.html` | Branded, AES-256-locked page at `yourdomain.com/` (+ auto password) |
| `hush notes.md` | Markdown โ rendered, branded HTML page |
| `hush report.html -p secret` | Your own password |
| `hush report.html --no-lock` | Branded page, no password โ renders for anyone with the link |
| `hush report.html --expire 7d` | Auto-expire (`7d`/`24h`/`2w`/date); enforce with `hush gc` |
| `hush report.html --burn` | Burn-after-read โ self-destructs on first view |
| `hush report.html --email-gate acme.com` | Only viewers with that email domain can open it |
| `hush deck.pdf --page` | A branded **download page** wrapping the file |
| `hush site.zip` | Multi-file static site at `yourdomain.com//` |
| `hush -s q3 deck.html` | Force the slug |
## CLI reference
| Command | Does |
|---------|------|
| `hush ` | Publish (managed / hosted / self-host, auto-detected) |
| `hush login` / `whoami` / `logout` | Passwordless hosted account (GitHub or magic link) |
| `hush list` / `rm ` / `gc` | List, delete, garbage-collect drops |
| `hush share [--revoke]` | Mint / revoke a revocable guest link |
| `hush claim ` | Move an anonymous `/u/` drop into your account |
| `hush set-expiry` / `set-email-gate` / `set-password` / `set-feedback` | Manage a hosted drop |
| `hush init` / `setup` / `deploy` | Configure + self-host on your own domain |
| `hush migrate` | Re-home hosted drops onto your own Blob |
## Use it from any AI agent
`npx hushdrop-install` registers the **`drops` MCP server** into your detected agents (Claude Code, Codex,
Cursor, Windsurf, OpenCode, Amp), puts `hush` on your `PATH`, and prints config for GUI clients.
```bash
claude mcp add hushdrop -- npx -y hushdrop-mcp # Claude Code
codex mcp add hushdrop -- npx -y hushdrop-mcp # Codex
```
```jsonc
{ "mcpServers": { "hushdrop": { "command": "npx", "args": ["-y", "hushdrop-mcp"] } } }
```
### MCP tools (9 โ vs Stacktree's 7)
| Tool | Purpose |
|------|---------|
| `publish_html` | Publish raw HTML โ branded, password-protected link |
| `publish_file` | Publish a local file (optionally a branded download page) |
| `update_site` | Replace a drop's content in place (same URL) |
| `list_sites` / `delete_site` | List / delete drops |
| `set_password` / `set_expiry` / `set_email_gate` / `set_feedback` | Manage a hosted drop |
## How it works
1. **Read** your file and detect its type.
2. **Brand** (HTML) โ inject favicon, OG/Twitter card, and a subtle corner badge before ` `.
3. **Encrypt** (if locking) โ [StatiCrypt](https://github.com/robinmoisson/staticrypt) (AES-256, client-side) behind your branded unlock gate. The badge is baked in *before* encryption, so it survives.
4. **Upload** to Vercel Blob under a clean key.
5. **Serve** โ `yourdomain.com/