BabelizeBabelize
CLI

Installation & Setup

Install the Babelize CLI (@babelize/cli), log in, verify the connection to your account, configure defaults, and log out. Step-by-step setup with examples.

Install

# Global install
npm install -g @babelize/cli

# yarn
yarn global add @babelize/cli

# Run without installing
npx @babelize/cli --help

Login

After installation, log in to your Babelize account:

babelize auth login

You'll be prompted for your email and password. Credentials are written to the CLI config directory for your platform:

PlatformPath
Linux~/.config/@babelize/cli-nodejs/config.json
macOS~/Library/Preferences/@babelize/cli-nodejs/config.json
Windows%APPDATA%\@babelize\cli-nodejs\Config\config.json

The file is plain JSON restricted to your user (mode 600 on macOS/Linux).

Login with flags (non-interactive)

babelize auth login --email you@example.com --password yourpassword

For CI pipelines, use a Babelize API key as BABELIZE_TOKEN instead — see CI/CD.

Connect to a different API URL

babelize auth login --api-url https://api.babelize.co

Verify the connection

# Check who you're logged in as
babelize auth whoami

# Check API health
babelize status

# Deep health check (verifies DB, Redis, queues)
babelize status --deep

Configuration

LocationContents
~/.config/@babelize/cli-nodejs/config.json (Linux)Access token, refresh token, and saved API URL

See the Login section above for the macOS and Windows paths.

You can override the API URL for one command with --api-url, set it with the BABELIZE_API_URL environment variable, or save one with babelize auth login --api-url <url> (localhost URLs included). The flag wins over the variable, and the variable over the saved URL:

BABELIZE_API_URL=http://localhost:3001/api babelize projects list

Logout

babelize auth logout

This revokes your session on the server and clears local credentials.

Last updated: 2026-10-16

How is this guide?

On this page