Authentication

XWidget Cloud uses Google OAuth for authentication. The CLI handles the entire flow — you just need a browser.

Login

$ xc cloud login

This opens your default browser for Google OAuth authentication. The CLI waits for the callback and stores the session locally in an encrypted file at ~/.xwidget/secure_storage.

Once authenticated, all subsequent xc cloud and xc analytics commands use the stored session automatically.

Check Current User

$ xc cloud whoami

Displays the email address of the currently authenticated user, or a message indicating you are not logged in.

Logout

$ xc cloud logout

Ends the current session and clears the stored credentials from ~/.xwidget/secure_storage.

Session Behavior

Most cloud commands require authentication. If you run a command while logged out, the CLI will display a warning:

You are not logged in.

The login and whoami commands are the exceptions — they work regardless of session state.