Account + sign-in

Hypex is BYOK-first. An account is entirely optional — the IDE runs 100 % of its features offline with your own API key or local Ollama, forever free.

An account unlocks cross-device session sync, usage analytics, and (on paid plans) priority routing.

Creating an account

There is no sign-up form. The magic-link flow handles new and returning users identically — if your email isn't in our database yet, the first successful verification creates the record.

1. Open the IDE and click "Sign in" in the status bar (bottom-right) or in the chat header, or run Hypex: Sign in to your account.
2. Pick "Open browser" — Hypex opens hypex.pages.dev/signin?from=ide.
3. Type your email, hit Send code. You'll receive a 6-digit code by email within ~30 seconds.
4. Type the code, hit Verify. The browser redirects back to Hypex via the hypex:// URL handler and the IDE confirms "signed in as you@example.com".

Air-gapped / headless?

On the signin page hit "Paste token manually" in the IDE command flow instead. The browser shows the session token on the success page — copy, paste into the IDE prompt, done.

Your account page

hypex.pages.dev/account shows:

• Plan card — plan name, renewal date, daily usage bar with amber / red thresholds, Upgrade or Manage billing buttons
• Identity — email, plan, member-since
• Display name — optional, shown in the IDE status bar
• Wallet — lifetime spend, 30-day spend, last-call metadata, spend-by-provider bar chart, top 10 models by spend
• Devices — every active session, with a "Sign out" button per non-current device. "Sign out others" nukes everything except the current device
• Danger zone — sign out of this device

What data leaves your machine

When signed in, after each chat turn the IDE sends this metadata to hypex.pages.dev/api/usage/record:

• Timestamp
• Model id (grok-4-fast-reasoning)
• Input / output / cached / cache-write token counts
• Estimated cost (client-computed from the pricing table)
• Provider id

What is NEVER sent: your API key, your prompts, the model's replies, file content, tool arguments, tool results, project names or paths.

Signing out + going offline

Hypex: Sign out revokes the token server-side and wipes it locally. BYOK keeps working identically — the account layer is completely orthogonal.

Troubleshooting

Didn't receive the code

• Check spam.
• Codes are one-shot; requesting a new one invalidates all prior pending codes for your email.
• Rate limit: 5 codes / hour / email. Wait an hour if you burn through that.

"Sign in" button doesn't open the browser

Fallback path: Hypex: Open account page will also trigger the sign-in flow. Or copy the URL manually: https://hypex.pages.dev/signin?from=ide.

The IDE didn't receive the token after verify

Usually means the hypex:// protocol handler isn't registered on your system. The success page falls back to showing the token — copy it and paste into Hypex: Sign in to your account → Paste token manually.