Babelize CLI
The Babelize CLI (@babelize/cli) manages i18n projects, starts translation runs, and raises GitHub PRs with locale files, all from your terminal.
The Babelize CLI (babelize) gives you full access to the Babelize platform from your terminal. Run translations, manage projects, raise PRs, and inspect billing — without ever opening a browser.
Quick start (translate locally)
Translate a React or Next.js repo in place with your own LLM key (no account needed) or a Babelize API key. The result is a git diff you can review:
export ANTHROPIC_API_KEY=sk-ant-... # or OPENAI_, GEMINI_, GROQ_, OPENROUTER_API_KEY
npx @babelize/cli translate --to fr,de
git diffNo LLM key? Create a Babelize API key at app.babelize.co/api-keys (free tier included) and export BABELIZE_API_KEY=bblz_sk_... instead.
React, Next.js, Django and static HTML are supported; Vue and React Native are in beta. See Translate Locally.
Quick Start (platform)
# Install globally
npm install -g @babelize/cli
# Or use without installing
npx @babelize/cli auth loginCommands Overview
Translate Locally
Translate this repo with your own LLM key. No account needed.
Authentication
Login, logout, session management, and provider tokens
Projects
Create, sync, archive, and manage your i18n projects
Engine Runs
Start translation runs, analyze i18n readiness, and watch phase-by-phase progress
Pull Requests
List, raise, and update GitHub PRs with locale files
Billing & Plans
View plans, usage, transactions, and upgrade your subscription
Advanced
Notifications, comments, analytics, users, roles, privacy, admin
Global Flags
Every command supports these flags:
| Flag | Description |
|---|---|
--json | Output raw JSON where the subcommand supports it (see note below) |
--api-url <url> | Connect to a different API (default: https://api.babelize.co/api) |
--token <token> | Pass an explicit auth token instead of using stored credentials |
--verbose / -v | Show full request/response details |
--yes / --non-interactive | Skip confirmation prompts (required in CI) |
--no-color | Disable ANSI colors |
--version / -V | Print CLI version |
--help / -h | Show help for any command |
--json is accepted everywhere but only implemented per subcommand — where a
subcommand doesn't produce JSON it falls back to the normal human-readable
output. Check the command's page in this section for its --json support.
Last updated: 2026-10-16
Usage Limits
Babelize plan limits explained: projects, AI credit quotas and API rate limits per plan, what happens when you reach a limit, and how to monitor your usage.
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.