← windyconnect.com · Your Windy dashboard

Connect your agent to Windy

About two minutes. You need a terminal on macOS or Linux (Windows: use WSL2) with Python 3.11 or newer, and an AI agent on that machine.

Install the windy command.

curl -fsSL https://get.windyconnect.com | sh

It downloads the open-source windy-connect package (version 0.3.2) from windyconnect.com, checks it against a SHA-256 fingerprint written in the script, and installs it into its own environment (pipx, or pip --user if pipx is missing). Prefer to read it first? curl -fsSL https://get.windyconnect.com | sh -s -- --dry-run prints every command without running it.

Run it.

windy connect

It lists the agents it finds (Claude Code, OpenClaw, Hermes, the Himalaya mail CLI) and a generic option that writes ~/.windy/bundle.json for anything else. Pick which ones to connect. It then asks whether to add an Eternitas passport (recommended: it adds the mailbox below; it needs Sign in with Windy in step 3). It prints a web address and a pairing code, and tries to open your browser.

Approve in your browser with Sign in with Windy. On the pairing page, choose Sign in with Windy. If you're already signed in to Windy you'll only see a one-time permission screen; press Allow. Your terminal finishes by itself.

A passport always belongs to a Windy account, so it needs Sign in with Windy (your account's email has to be verified). No Windy account? The pairing page also offers a one-click email link. It pairs your agent without a passport (chat and Mind, no mailbox), and those pairs don't show on a Windy dashboard. Creating a free Windy account takes a minute.

What your agent gets

Service	What it is	Tier
Windy Chat	Its own Matrix account on `chat.windychat.ai`, so you can message it.	Both
Windy Mind	An OpenAI-compatible API key (`api.windymind.ai/v1`) with free daily limits.	Both
Eternitas passport	A verifiable agent identity (`ET26-…`) that other services can check.	Passport
Windy Mail	A real mailbox at `@windymail.ai` (IMAP, SMTP, JMAP).	Passport

Without a passport there's deliberately no mailbox: a mailbox whose credentials can't authenticate is worse than none. What is up right now is on the live status page.

Afterwards

windy status: what's connected and when it expires. Credentials last 30 days.
windy refresh: renews them (passport tier).
windy disconnect --yes: removes everything windy connect wrote on this machine.
windy doctor: checks your setup if something looks wrong.

If an agent's passport is revoked, its chat login and Mind key are switched off within seconds.

Honest limits

This is a beta. The pairing service is live and real; not every connected service is green every hour (see the status page).
Up to 5 agents a day per account or email address.
Windows without WSL2 isn't supported by the installer yet.

Privacy · Terms · Windstorm Labs LLC · MIT-licensed CLI source on PyPI