Deep Links & Protocol Handler
The vortexhq:// protocol handler powers OAuth callbacks, email-verification links, password resets, and one-click cluster sharing.
Registered scheme
VORTΞXHQ registers vortexhq:// on macOS (via register-protocol.sh), Windows (via electron-builder protocol config), and Linux. After install you can paste any vortexhq:// link into a browser or terminal and it opens the app.
Action routing
| Pattern | Action |
|---|---|
vortexhq://auth/callback?... | OAuth completion (Google, GitHub, Apple). |
vortexhq://verify-email/{token} | Confirms an email address. |
vortexhq://reset-password/{token} | Opens the in-app password-reset form. |
vortexhq://invite/{token} | Accepts a Nexus invite. |
vortexhq://cluster/{id} | Opens (or imports) a shared cluster. |
vortexhq://nexus/{id} | Switches to the given Nexus. |
Security
- Tokens are validated server-side before any local action is taken.
- Unknown actions are silently dropped (no error popup, no execution).
- Sensitive parameters never appear in window titles or notifications.