Auth CLI Commands | Wraps
CLI Reference / Auth
Authenticate with the Wraps Platform for dashboard access, templates, and workflows.
wraps auth login
Authenticate with the Wraps Platform using the device authorization flow. Opens your browser to authorize the CLI.
--token <token>
Use an API token instead of the device authorization flow. Useful for CI/CD environments.
--json
Output result as JSON for scripting and automation
- Opens your browser to
wraps.dev/devicefor authorization - Displays a one-time code in the terminal for you to confirm in the browser
- Polls for authorization until you approve or the code expires
- Stores the access token in
~/.wraps/auth.json - Displays your account email and organization on success
Interactive login (recommended):
Login with an API token (for CI/CD):
wraps auth status
Show your current authentication status, including account details and organization membership.
--json
Output result as JSON for scripting and automation
- Reads the stored token from
~/.wraps/auth.json - Validates the token with the Wraps Platform API
- Displays account email, organization name, and current plan
- Shows an error if not authenticated or if the token has expired
wraps auth logout
Clear stored authentication credentials and log out of the Wraps Platform.
- Removes the access token from
~/.wraps/auth.json - Confirms successful logout with a message in the terminal
- Does not revoke the token server-side (use the dashboard for that)
Authentication Flow
The device authorization flow lets you authenticate securely without entering credentials in the terminal.