login
Authenticate with Valiqor. Without flags, opens a browser-based device authorization flow. With --email and --password, authenticates directly (useful in CI/CD).
| Flag | Type | Default | Description |
|---|
--email / -e | string | — | Email for direct login (CI/CD mode) |
--password / -p | string | — | Password for direct login (CI/CD mode) |
--force / -f | flag | false | Force login even if already authenticated |
Browser Flow (Interactive)
The CLI opens your default browser and displays a user code. Approve the device to complete login. The CLI polls for approval automatically (up to 5 minutes).
Direct Login (CI/CD)
valiqor login --email user@example.com --password mysecret
Avoid passing --password directly on shared systems. Prefer the browser flow or environment variables for CI/CD.
Behavior
- Checks if an existing API key is valid before re-authenticating (skip with
--force).
- Saves the API key to both global (
~/.valiqor/credentials.json) and local (.valiqorrc).
- If you have reached the maximum number of API keys, the CLI prompts you to delete one or paste an existing key.
signup
Create a new Valiqor account. Without flags, runs interactively with prompts.
| Flag | Type | Default | Description |
|---|
--email / -e | string | — | Account email |
--password / -p | string | — | Account password |
--name / -n | string | — | Your name (required for direct signup) |
--org / -o | string | — | Organization name (required for direct signup) |
Interactive Mode
Prompts for email, password (with confirmation), name, and organization.
Direct Signup (CI/CD)
valiqor signup --email user@example.com --password mysecret --name "Jane Doe" --org "Acme Inc"
Behavior
- Checks if you are already logged in with a valid API key.
- On success, saves credentials globally and locally.
logout
Clear stored credentials.
| Flag | Type | Default | Description |
|---|
--all / -a | flag | false | Also clear the API key from the local .valiqorrc |
Examples
# Clear global credentials only
valiqor logout
# Clear global + local credentials
valiqor logout --all
verify-email
Send a verification email to unlock the full free tier (3 trial runs → 50 free runs).
No flags. If your email is already verified, the CLI reports that. Otherwise it triggers a verification email and opens the Valiqor dashboard as a fallback.
keys
Manage API keys. Requires an existing authenticated session.
valiqor keys <create|list|delete>
keys create
Create a new API key.
valiqor keys create [flags]
| Flag | Type | Default | Description |
|---|
--name / -n | string | auto-generated | Name for the new key |
--save / -s | flag | false | Save the new key to .valiqorrc |
# Create a named key and save it locally
valiqor keys create --name "ci-key" --save
The full key is only displayed once at creation time. Copy it immediately.
keys list
List all API keys for your account.
Displays key ID, name, prefix, created date, status (active/revoked), and usage count.
keys delete
Delete (revoke) an API key.
valiqor keys delete <key_id> [flags]
| Flag | Type | Default | Description |
|---|
--force / -f | flag | false | Skip confirmation prompt |
# Delete with confirmation
valiqor keys delete abc123
# Delete without confirmation (CI/CD)
valiqor keys delete abc123 --force
