Engine Runs
Start a Babelize translation run from the CLI and watch the pipeline live, phase by phase, from string extraction to the pull request. Includes run history.
Commands
babelize run start
Start a full Babelize engine run — triggers the modular i18n architecture.
babelize run start --project <id> --languages es,fr,de
babelize run start --project <id> --languages ja,zh --branch developThe CLI polls for status automatically, showing real-time pipeline progress:
Phase 0: Workspace Validation ✓ (0.3s)
Phase 1: String Extraction ✓ (1.2s)
Phase 2: Key Generation ✓ (0.5s)
Phase 3: Lockfile Check ✓ (0.2s)
Phase 4: Base Locale Handling ✓ (0.8s)
Phase 5: Translation ✓ (12.4s)
Phase 6: Lockfile Update ✓ (0.2s)
Phase 7: AST Injection ✓ (2.1s)
Phase 8: Finalization ✓ (0.3s)
Phase 9: Preview Analysis ✓ (0.4s)
Phase 10: Summary ✓ (0.1s)
✓ Babel run completed!
PR opened: https://github.com/yourorg/yourapp/pull/42Use --no-poll to start the run and return immediately:
babelize run start --project <id> --languages es --no-pollbabelize run status <babelId>
Check the status of a specific babel job.
babelize run status <babel-uuid>
babelize run status <babel-uuid> --watch # Keep polling until done
babelize run status <babel-uuid> --watch --json # Final status as JSON (CI-friendly)babelize run analyze
Analyze source code to detect framework, config, and string patterns.
babelize run analyze --project <id>babelize scan [directory]
Scan a local directory for hardcoded strings without a project or API key — useful for checking i18n readiness before your first run.
babelize scan # Scan the current directory
babelize scan ./src # Scan a subdirectory
babelize scan --extensions .ts,.tsx # Restrict file extensions
babelize scan --json # Machine-readable resultsDefault extensions: .tsx, .jsx, .ts, .js, .vue, .html.
Modular Architecture
| Module | What Happens |
|---|---|
| Workspace Validation | Framework detection (React, Next.js, Django and static HTML; Vue and React Native in beta) |
| String Extraction | AST parsing finds hardcoded strings |
| Key Generation | Creates i18n keys with collision detection |
| Lockfile Check | Checks lockfile for cached translations |
| Base Locale Handling | Source locale file and lockfile sync |
| Translation | AI translation via NLLB-200 or BYOK Anthropic/OpenAI |
| Lockfile Update | Updates lockfile with new translations |
| AST Injection | Modifies source files with t() wrappers |
| Finalization | Dependency injection, config file creation |
| Summary | Stats, diffs, and analysis |
Babels (Run History)
babelize babels list # All runs
babelize babels list --project <id> # Filter by project
babelize babels list --limit 50 # More results
babelize babels get <babel-uuid> # Single run with logsLast updated: 2026-10-16
Projects
Create, manage, sync and archive Babelize projects from the CLI, and manage target languages, team members and translation memory, with command examples.
Pull Requests
List, raise and update GitHub pull requests with translated locale files from the Babelize CLI, so every translation change lands as a reviewable PR.