Parallel processing in CLI v0
Control the legacy worker pool and recover partial output without assuming unlimited provider capacity.
V0 turns locale/file combinations into translation tasks and assigns them to a client worker pool. More workers allow more tasks at once. They do not raise provider quotas or make the project one transaction.
Set a small pool for diagnosis #
lingo.dev@0.138.10 defaults to 10 workers. To investigate throttling or an unfamiliar backend, start lower:
lingo run --concurrency 2 --target-locale esInspect provider errors, memory use, and completed output before raising concurrency. Help documents a maximum of 10, although argument validation accepts larger positive numbers. Stay at or below 10 unless the installed release and backend have been verified together.
Reduce unnecessary work first #
Use file, locale, bucket, and key selectors to limit the actual task. --source-locale changes the source for the run. Quote wildcard selectors and inspect discovered configured paths.
Force changes the translation delta, while frozen mode checks synchronization instead of translating. Neither changes worker count. A smaller, relevant delta is often the useful change when the problem is reviewing too much output.
Keep successful progress after failure #
The Lingo.dev path chunks larger payloads and can write returned chunks before all work finishes. Other tasks can also complete while one fails. Preserve the diff, identify the failed locale/file, and retry the relevant scope before forcing the whole project.
Target-locale and key-scoped output does not refresh an existing source-checksum baseline. Settle the baseline deliberately; completed target writes do not prove every locale is current.
Per-file I/O coordination serializes shared-file writes within one run. It does not protect against a second CLI process or an editor writing that file. Avoid competing runs on the same configuration and lockfile. Cancellation does not restore earlier content, and purging before retry is a separate destructive decision.