Help

Using drops

What is a drop?

A drop is something you can add to your Windy apps — a dashboard, a skill an agent can use, a theme, etc. Drops are tiny + safe by default + work the same way across every Windy product.

How do I install one?

Open Windy Word and click the pulsing 🖥️ Panel tile. That opens the Control Panel. Click + Get more drops in the top-right and pick the drop you want. It'll install in a second or two. To switch between drops you've installed, use the drop name button in the top-left of the Control Panel.

Do I need a Windy account?

No. The two built-in drops (Echo HQ + Glance) work without any account. If you want to install drops from the marketplace, the Control Panel handles auth for you using your Windy Word session — you'll just stay signed in across drops you install.

Where do my installed drops live?

On your computer, inside Windy Word's app data folder. Uninstalling a drop removes it cleanly. Echo HQ is built into Windy Word and can't be removed (it's the fallback when nothing else is selected).

Authoring drops

What does it take?

If you can write HTML + a little JavaScript, you can ship a Control Panel dashboard. If you can do more, you can ship richer drop types (skills, themes, voice-packs, workflows — coming as their consumer surfaces land).

Install the CLI

npm install -g @windy/drops-sdk

Scaffold a starter

windy-drops new my-first-drop --type control-panel-template
cd my-first-drop
# Edit SKILL.md (set your handle + id), render.js (the dashboard), styles.css
windy-drops validate .
windy-drops bundle .

Fork an existing drop

windy-drops fork windy-glance your-handle-my-glance
# Edit + republish

Publish to the marketplace

windy-drops publish .

Publishing signs your manifest with your Eternitas Passport and uploads the bundle to the registry. First-time setup walks you through getting a Passport.

Get tipped

Connect Stripe at /me/payouts to receive tips from people who install your drops. The platform takes 0% — tips go directly to you.

Common questions

The drop selector doesn't open in the Control Panel.

Make sure you're running the latest Windy Word. The drop-library bridge was added in version 1.7+; older versions show the built-in Echo HQ only. Update from downloads.windyword.ai.

"The marketplace isn't available right now."

Usually means your computer can't reach the registry. Check your internet connection. If that's fine, the registry might be having a moment — try again in a minute.

How do I uninstall a drop?

Uninstall via the Control Panel ships in a follow-up release. For now, drops you install stay in your library until you reset Windy Word's app data.

How does the platform stay open?

The drop spec is a JSON Schema. Both SDKs (TypeScript + Python) are MIT-licensed. Drops themselves are also MIT by default. Anyone can write a host that consumes the same drops the Windy Control Panel does.

Stuck? Open an issue at sneakyfree/windy-drops/issues.