CLI v0 reference
Maintain an installed i18n.json project while preserving its accepted translations and source baseline.
This manual covers the older lingo.dev package and its i18n.json/i18n.lock workflow. Examples are scoped to 0.138.10. Keep the version recorded in an existing project's lockfile while planning a migration; installing a mutable latest version is not reproducible recovery.
For a new project, start with the current CLI. Its server-side push/pull workflow has different state and selection rules.
How an installed v0 run works #
The bucket configuration selects a parser and discovers source/target files, expanding [locale] where needed. The parser extracts content and separates recognized nontranslatable values. The delta compares source values, existing targets, and earlier source checksums to find new, changed, removed, or renamed entries.
Selected text goes through a Lingo.dev localization engine or a configured direct provider. Returned translations are reconstructed into target files or locale sections of a shared file. Tasks can write successful output before another task fails; the whole project is not an atomic transaction.
Keep the baseline with the content #
Commit i18n.json, accepted locale output, and i18n.lock together. The lockfile records source state, not every target edit or language approval. Ordinary runs advance source checksums; target-locale or key-scoped runs can write output without refreshing an existing baseline.
The lockfile reference explains why later ordinary work can revisit a source change after a scoped run. Existing translations covers adoption without replacing every present value.
Find the next operation #
Use the first-file procedure to reproduce a small legacy run. Configuration and Formats identify what the installed generation reads and writes.
For ongoing work, Locales adds a target; Key controls distinguishes ordinary edits from human-owned values; Retranslation scopes a deliberate refresh. Monorepos and Parallel processing cover ownership and throughput without assuming that more workers remove provider limits.