BabelizeBabelize
CLI

Authentication

Log in to and out of the Babelize CLI, manage active sessions, and add or remove GitHub provider tokens, with the commands and flags for each.

Commands

babelize auth login

Log in to your Babelize account. Without flags it asks how: GitHub or Google open your browser to sign in, and the CLI receives the session on a temporary localhost port (it gives up after 5 minutes); Email asks for your email and password in the terminal. The first time, it also asks whether you're connecting to Babelize Cloud or a self-hosted server.

babelize auth login
babelize auth login --github          # or --google
babelize auth login --email you@example.com --password secret
babelize auth login --api-url https://babelize.example.com/api   # self-hosted

If the browser doesn't open, the CLI prints the sign-in URL to open yourself. You don't need to log in before npx babelize: it signs you in when needed.

CI tip: prefer BABELIZE_TOKEN for pipelines (see CI/CD) — no session to store on the runner.

babelize auth signup

Create a new Babelize account.

babelize auth signup
babelize auth signup --email new@example.com --password mypassword123 --display-name "Ada"

Confirm your email, then run babelize auth login.

babelize auth logout

Log out and revoke your current session.

babelize auth logout

babelize auth whoami

Also available as babelize auth status and babelize auth me.

Show the currently authenticated user.

babelize auth whoami
babelize auth whoami --json   # Machine-readable

babelize auth reset-password

Send a password reset email.

babelize auth reset-password --email you@example.com

Token refresh

There is no auth refresh command — access tokens are refreshed automatically from the stored refresh token whenever a request returns 401. Re-run babelize auth login only if the refresh token itself has expired.

Provider Tokens (GitHub)

Manage OAuth tokens for connected providers (e.g. GitHub).

babelize auth provider-tokens list
babelize auth provider-tokens validate
babelize auth provider-tokens get github
babelize auth provider-tokens delete github

Sessions

Active sessions are managed via the account command group:

babelize account sessions              # List sessions (header shows the active count)
babelize account revoke-session <id>   # Force-logout a session

Last updated: 2026-11-01

How is this guide?

On this page