Skip to main content
plugin CX Codex

dropthehassle — Claude Code plugin: publish sites to free HTTPS

A plugin that teaches the agent to publish a built site to a free HTTPS address yourname.dropthehassle.app or your own domain via DropTheHassle.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install dropthehassle@awesome-codex-plugins
Open on GitHub

What dropthehassle does

The plugin bundles publish-website, dropthehassle-publish, buy-domain, custom-domain and domain-email skills. The agent verifies the folder holds a finished site (index.html at the root) rather than source code, and triggers a build if needed (Vite, Astro, Next.js with output: 'export', Nuxt generate, Create React App). It runs a local preflight check (scripts/preflight.mjs) against upload limits, sets up the DropTheHassle CLI via npx -y dropthehassle@latest deploy . --email <email> (asks for your address), and deploys the site. You get a live link and a claim link valid for 7 days.

For server apps (SSR, API routes), DropTheHassle connects a backend on AWS, Google Cloud or DigitalOcean through set_backend. When you want a custom domain, the agent checks real availability and pricing, hands you a payment link and stops — you pay, never the agent. MCP tools (local server npx -y dropthehassle-mcp or remote https://dropthehassle.com/mcp) work without a token on first deploy; managing your account requires DTH_TOKEN from dropthehassle.com.

What it helps with

  • publish a static site to free HTTPS without sign-up
  • build a project and deploy it with one agent prompt
  • connect your own domain without DNS configuration
  • find available domain names with pricing and get a payment link
  • set up a mailbox on your custom domain

Example prompts for the agent

  • Publish this site to DropTheHassle
  • Build the project and deploy it to free HTTPS
  • Check which domains are available for my project and show prices

How to install dropthehassle

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install dropthehassle@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about dropthehassle

How to install dropthehassle in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install dropthehassle@awesome-codex-plugins.

What does the dropthehassle plugin do?

It teaches the agent to publish built sites to a free HTTPS address via DropTheHassle, run builds before deploying, and connect custom domains. The agent cannot spend money — it only shows you the payment link.

Do I need a token for the first deploy with dropthehassle?

No, the first deploy works without a token. The DTH_TOKEN is required only for account operations: listing sites, renaming links, payment links.

Source text

dropthehassle-skill · MIT
# DropTheHassle publish skill

An open [Agent Skill](https://agentskills.io) that teaches your coding agent to publish a **built
site or web app** with [DropTheHassle](https://dropthehassle.com): a free HTTPS
`yourname.dropthehassle.app` link with no account, card or DNS work, then a real domain when you
want one.

Task words it answers: **deploy website**, **buy domain**, **email on my domain**. Skills in
`skills/`: `publish-website`, `dropthehassle-publish`, `buy-domain`, `custom-domain`, `domain-email`.

Works in **Claude Code, Cursor, Codex and Windsurf**, and any other agent that reads `SKILL.md`
skills.

**Your AI can publish. It can never spend your money.** The skill tells the agent to search names
and hand you a payment link, never to buy.

## What the agent does with it

1. Checks the folder is a finished site (an `index.html` at the top), not source code, and runs the
   build first when it is (Vite, Astro, Next.js `output: 'export'`, Nuxt generate, Create React App,
   Lovable/Bolt exports). DropTheHassle serves the built files and never runs a server itself. A
   server app (SSR, API routes, server functions, a TanStack Start app) runs on AWS, Google Cloud,
   DigitalOcean or your own server and is connected with `set_backend` or the dashboard's Backend
   card: DropTheHassle then puts it behind the same link. A TanStack Start app (Lovable from
   13 May 2026) can also go online as an SPA build (`dist/client`), without its server
   functions and `/api` routes.
2. Runs a local preflight (`scripts/preflight.mjs`, no network, no dependencies) against the upload
   limits.
3. Sets up the DropTheHassle CLI (`npx -y dropthehassle@latest deploy . --email <the user's email>`; it asks you for
   your email first, never makes one up), the local MCP server
   (`npx -y dropthehassle-mcp`) or the hosted connector (`https://dropthehassle.com/mcp`).
4. Deploys, and gives you the live link plus the **claim link** (valid 7 days).
5. Checks the site is really live (the same check as
   [Is my website down?](https://dropthehassle.com/is-my-website-down)).
6. If you want your own name, checks which domains are really free and what they cost, and stops
   there until you say otherwise.

## Cursor

Install the DropTheHassle plugin from the Cursor Marketplace, or add only the MCP server.

One click: `cursor://anysphere.cursor-deeplink/mcp/install?name=dropthehassle&config=eyJ1cmwiOiJodHRwczovL2Ryb3B0aGVoYXNzbGUuY29tL21jcCJ9`

Or add to `mcp.json`:

```json
{ "mcpServers": { "dropthehassle": { "url": "https://dropthehassle.com/mcp" } } }
```

Then ask: "publish my site". No token needed.

## Install

Install the DropTheHassle skill in Claude Code, Cursor, Codex or Gemini CLI: `npx skills add bosmdavid-gif/dropthehassle-skill`

This repo has four skills. `npx skills add bosmdavid-gif/dropthehassle-skill` lists them all;
pick one or more.

| Skill | What it does |
| --- | --- |
| [`dropthehassle-publish`](skills/dropthehassle-publish) | Publish a built website or web app on a free HTTPS link: build, preflight, deploy, Update and Restore, claim link, live check. |
| [`buy-domain`](skills/buy-domain) | Find a free domain name with real availability and price, then hand you the payment link. You pay; the site goes live on it with no DNS. |
| [`custom-domain`](skills/custom-domain) | Connect a domain you already own to your site, free, with one A record you set at your registrar. |
| [`domain-email`](skills/domain-email) | Turn on a mailbox such as [email protected] (€5 / $5 a month). You pay the link. |

Install them with the open [skills CLI](https://github.com/vercel-labs/skills), as a Claude Code
plugin, or by copying the folders.

### Any agent (skills CLI)

```bash
npx skills add bosmdavid-gif/dropthehassle-skill
```

Pick your agents in the prompt, or name them (`-g` installs for every project):

```bash
npx skills add bosmdavid-gif/dropthehassle-skill --skill dropthehassle-publish -g -a claude-code -a cursor -a codex -a windsurf -y
```

Update later with `npx skills update dropthehassle-publish -g -y`.

### Claude Code

As a plugin, inside Claude Code:

```
/plugin marketplace add bosmdavid-gif/dropthehassle-skill
/plugin install dropthehassle@dropthehassle
```

Or copy the folder:

```bash
git clone https://github.com/bosmdavid-gif/dropthehassle-skill.git
mkdir -p ~/.claude/skills
cp -r dropthehassle-skill/skills/dropthehassle-publish ~/.claude/skills/
```

Use `.claude/skills/` inside a project instead to share it with the repo. Claude picks the skill up
by itself when you ask to publish a site, or call it with `/dropthehassle-publish`
(`/dropthehassle:dropthehassle-publish` when installed as a plugin).

### Cursor

```bash
npx skills add bosmdavid-gif/dropthehassle-skill --skill dropthehassle-publish -a cursor
```

Or copy `skills/dropthehassle-publish` to `.cursor/skills/` (this project) or `~/.cursor/skills/`
(every project). Cursor also reads `.agents/skills/` and `.claude/skills/`. Type `/` in Agent chat
to call it by name.

### Codex

```bash
npx skills add bosmdavid-gif/dropthehassle-skill --skill dropthehassle-publish -a codex
```

Or copy `skills/dropthehassle-publish` to `.agents/skills/` in the repo, or `~/.agents/skills/` for
every repo. Call it with `$dropthehassle-publish`, or let Codex pick it. Codex keeps the network
off in its sandbox by default: approve the deploy command when it asks, or see
[the Codex guide](https://dropthehassle.com/guides/codex-deploy-custom-domain).

### Windsurf

```bash
npx skills add bosmdavid-gif/dropthehassle-skill --skill dropthehassle-publish -a windsurf
```

Or copy `skills/dropthehassle-publish` to `.windsurf/skills/` (this workspace) or
`~/.codeium/windsurf/skills/` (every workspace). Windsurf also reads `.agents/skills/` and
`~/.agents/skills/`. Call it with `@dropthehassle-publish`, or let Cascade pick it.

### Without skills support

Paste the contents of
[`skills/dropthehassle-publish/SKILL.md`](skills/dropthehassle-publish/SKILL.md) into your
project's `AGENTS.md` or `CLAUDE.md`, or point your AI at https://dropthehassle.com/llms.txt.

## Connect DropTheHassle (optional, for the MCP tools)

The CLI needs nothing set up. To give the agent the MCP tools too:

```bash
claude mcp add dropthehassle -- npx -y dropthehassle-mcp           # Claude Code
codex mcp add dropthehassle --url https://dropthehassle.com/mcp     # Codex
```

Cursor (`.cursor/mcp.json`), Windsurf (`.devin/mcp_config.local.json`) and others:

```json
{
  "mcpServers": {
    "dropthehassle": { "command": "npx", "args": ["-y", "dropthehassle-mcp"] }
  }
}
```

A first deploy needs no token. Account tools (your sites, renaming a link, payment links) need the
token from dropthehassle.com, menu, **Connect your AI**, set as `DTH_TOKEN`. Don't commit it. Full
setup per tool: [references/setup.md](skills/dropthehassle-publish/references/setup.md) and
[the MCP guide](https://dropthehassle.com/guides/deploy-with-your-ai-mcp).

## Try it

Open a folder with a finished site, or a project that builds to one, and ask:

> Publish this site with DropTheHassle and give me the link.

You should see the agent check or build the folder, run the preflight, deploy, and come back with
a `….dropthehassle.app` link, a claim link, and a live check. Then try:

> Is there a free .com for this?

It should list names with prices from a real search, and not create a payment link until you ask.

## What's in the box

```
skills/buy-domain/SKILL.md          # find a free name, hand over the payment link
skills/custom-domain/SKILL.md       # connect a domain you already own (one A record)
skills/domain-email/SKILL.md        # mailbox on your domain, human pays
skills/dropthehassle-publish/
├── SKILL.md                    # the workflow the agent follows
├── references/
│   ├── setup.md                # CLI, MCP and hosted connector setup per tool
│   ├── domains.md              # search, buying (human pays), own domain, renaming the link
│   └── troubleshooting.md      # every deploy answer and what to do, TanStack/Lovable
└── scripts/
    └── preflight.mjs           # local check: finished site? within the limits?
.claude-plugin/                 # Claude Code plugin + marketplace manifest
```

Run the preflight yourself:

```bash
node skills/dropthehassle-publish/scripts/preflight.mjs ./my-site
```

## Facts this skill is based on

Everything in the skill was checked on 2026-10-01 against the published packages
(`dropthehassle` CLI 0.3.0, `dropthehassle-mcp` 0.4.2 on npm), the hosted MCP server at
`https://dropthehassle.com/mcp`, and https://dropthehassle.com/llms.txt. When those change, the
tools' own messages win. Found something out of date? Open an issue.

## Links

- DropTheHassle: https://dropthehassle.com
- llms.txt: https://dropthehassle.com/llms.txt
- MCP server: https://github.com/bosmdavid-gif/dropthehassle-mcp ([npm](https://www.npmjs.com/package/dropthehassle-mcp))
- CLI: [npm `dropthehassle`](https://www.npmjs.com/package/dropthehassle)
- Guides: [publish AI-built HTML](https://dropthehassle.com/guides/put-ai-html-online),
  [Claude Code](https://dropthehassle.com/guides/claude-code-website-online),
  [Cursor](https://dropthehassle.com/guides/cursor-site-own-domain),
  [Codex](https://dropthehassle.com/guides/codex-deploy-custom-domain),
  [Windsurf](https://dropthehassle.com/guides/windsurf-deploy-custom-domain)

## Privacy and support

- Privacy: https://dropthehassle.com/privacy
- Terms: https://dropthehassle.com/terms
- Support: https://dropthehassle.com/support or [email protected]

## License

MIT. See [LICENSE](LICENSE).

© DropTheHassle · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for DevOps and infrastructure →

From the same set391

The whole set →
exotic-car-rental-skills exotic-car-rental-skills searches exotic and luxury car rentals across the US, calculates total rental costs, and inspects rental companies via a free read-only MCP server. CX Codex ★ 1,596repo stars exa The plugin adds Exa web search and full-page retrieval. Use it when an agent needs current sources for online research. CX Codex ★ 1,596repo stars equibles equibles wires a hosted MCP server for US stock research into your agent: SEC filings, XBRL statements, earnings call transcripts, 13F holdings and insider trades. CX Codex ★ 1,596repo stars eigenheim-market eigenheim-market connects live Berlin real estate market data to your assistant without API keys. Query apartment prices per square metre, gross rental yields, and official land values. CX Codex ★ 1,596repo stars droplinked-codex-plugin droplinked-codex-plugin connects your assistant to droplinked's hosted MCP server to search verified stock, check onchain merchant attestations, and initiate checkout flows. CX Codex ★ 1,596repo stars dodopayments dodopayments is a Claude Code and Codex plugin for Dodo Payments tasks involving checkouts, subscriptions, and billing. It loads relevant integration skills and connects to the API and docs through MCP. CX Codex ★ 1,596repo stars digital-marketing-pro digital-marketing-pro — an agency plugin that puts every brand through one twelve-part marketing route and keeps the output in four core documents. Built for portfolios, not one-offs. CX Codex ★ 1,596repo stars dex The dex plugin for Claude Code and Codex explores data warehouses, maintains dbt models, and tracks schema drift. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open