Engine Runs

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 develop

The 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/42

Use --no-poll to start the run and return immediately:

babelize run start --project <id> --languages es --no-poll

`babelize run preview`

Dry-run mode — shows what strings would be extracted without modifying any files.

babelize run preview --project <id> --languages es,fr
babelize run preview --project <id> --languages de --json

`babelize 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 analyze`

Analyze source code to detect framework, config, and string patterns.

babelize run analyze --project <id>

Modular Architecture

Module	What Happens
Workspace Validation	Framework detection (Next.js, React)
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
Preview Analysis	Generates translation preview warnings
Summary	Stats, diffs, overflow, and RTL preview 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 logs

Engine Runs

Commands

babelize run start

babelize run preview

babelize run status <babelId>