Skip to main content

​
Log in

zwrm auth login
Opens your browser to complete the authentication flow. Your token is saved to ~/.zwrm/credentials.json. For headless environments (SSH sessions, CI pipelines), pass a token directly: 
zwrm auth login --token <your-api-token>

​
Log out

zwrm auth logout
Removes ~/.zwrm/credentials.json.

​
Check your identity

zwrm auth whoami
Shows your user ID, email, and name.

​
View your token

zwrm auth token
Displays your current token in masked format and shows where it was loaded from (environment variable or credentials file).

​
Token resolution

ZWRM looks for your API token in this order:
  1. ZWRM_API_TOKEN environment variable
  2. ~/.zwrm/credentials.json file
Setting ZWRM_API_TOKEN is useful for CI/CD pipelines and automation: 
export ZWRM_API_TOKEN="your-token-here"
zwrm deploy

​
Credentials file

The credentials file is stored at ~/.zwrm/credentials.json with restricted permissions (mode 0600): 
{
  "token": "...",
  "user": {
    "id": "...",
    "email": "[email protected]",
    "name": "User Name"
  }
}