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 --helpLogin
After installation, log in to your Babelize account:
babelize auth loginYou'll be prompted for your email and password. Credentials are written to the CLI config directory for your platform:
| Platform | Path |
|---|---|
| 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 yourpasswordFor 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.coVerify 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 --deepConfiguration
| Location | Contents |
|---|---|
~/.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 listLogout
babelize auth logoutThis revokes your session on the server and clears local credentials.
Last updated: 2026-10-16
Babelize CLI
The Babelize CLI (@babelize/cli) manages i18n projects, starts translation runs, and raises GitHub PRs with locale files, all from your terminal.
Translate Locally
Translate a React or Next.js repo from your terminal with your own LLM key or a Babelize API key. No GitHub App, no dashboard: the result lands in your working tree as a git diff.