CLI
reflex signup / login / logout / whoami
Account creation and local credential management.
reflex signup
Create a new Reflex account.
reflex signup --name "Jane Doe" --email jane@example.comYou'll be prompted for a password (minimum 8 characters). The command creates
the account but does not log you in — run reflex login afterward to
obtain an API key.
| Flag | Default | Description |
|---|---|---|
--name | required | Display name. |
--email | required | Email address. |
--password | prompted | Account password (≥ 8 chars). |
--site-url | https://app.tryreflex.ai | Override the dashboard URL. |
--callback-url | — | URL to return to after signup completes. |
--json | off | JSON output. |
reflex login
Authenticate and store an API key locally.
reflex loginThe CLI:
- Creates a device-auth request.
- Opens the approval URL in your browser (prints it as a fallback).
- Polls until you approve.
- Writes the resulting API key to
~/.config/reflex/credentials.json.
| Flag | Default | Description |
|---|---|---|
--timeout | 600.0 s | How long to wait for approval. 0 exits after printing the URL. |
--poll-interval | 2.0 s | How often to poll while waiting. |
--hostname | system host | Label shown on the approval screen. |
--site-url | production | Override the dashboard URL. |
--convex-url | production | Override the API backend URL. |
--verbose, -v | off | Print request IDs and browser hints. |
--json | off | JSON output. |
Headless servers
# On the headless host: print the URL and exit
reflex login --timeout 0
# Open the printed URL on a workstation with a browser, approve it,
# then re-run login on the headless host to fetch the key:
reflex loginreflex logout
Delete the local credentials file.
reflex logoutDoes not revoke the key on the server side — to invalidate a key permanently, rotate or delete it from the dashboard.
reflex whoami
Verify which account the current API key belongs to.
reflex whoamiSample JSON output:
{
"ok": true,
"account": {
"userId": "user_...",
"email": "jane@example.com",
"organization": { "id": "org_...", "name": "Acme Robotics" }
}
}Exits non-zero if no key is configured or the key is invalid.