lingo.dev run - Lingo.dev CLI

Introduction

Run localization pipeline

Usage

lingo.dev run [options]

Options

`--source-locale <source-locale>`

lingo.dev run --source-locale <source-locale>

Override the source locale from i18n.json for this run

Requires a value.

`--target-locale <target-locale>`

lingo.dev run --target-locale <target-locale>

Limit processing to the listed target locale codes from i18n.json. Repeat the flag to include multiple locales. Defaults to all configured target locales

Requires a value.

`--bucket <bucket>`

lingo.dev run --bucket <bucket>

Limit processing to specific bucket types defined in i18n.json (e.g., json, yaml, android). Repeat the flag to include multiple bucket types. Defaults to all configured buckets

Requires a value.

`--file <file>`

lingo.dev run --file <file>

Filter bucket path pattern values by substring match. Examples: messages.json or locale/. Repeat to add multiple filters

Requires a value.

`--key <key>`

lingo.dev run --key <key>

Filter keys by prefix matching on dot-separated paths. Example: auth.login to match all keys starting with auth.login. Repeat for multiple patterns

Requires a value.

`--api-key <api-key>`

lingo.dev run --api-key <api-key>

Override API key from settings or environment variables

Requires a value.

`--concurrency <concurrency>`

lingo.dev run --concurrency <concurrency>

Number of translation jobs to run concurrently. Higher values can speed up large translation batches but may increase memory usage. Defaults to 10 (maximum 10)

Requires a value.

`--debounce <milliseconds>`

lingo.dev run --debounce <milliseconds>

Delay in milliseconds after file changes before retranslating in watch mode. Defaults to 5000

Requires a value.

Flags

`--force`

lingo.dev run --force

Force re-translation of all keys, bypassing change detection. Useful when you want to regenerate translations with updated AI models or translation settings

`--debug`

lingo.dev run --debug

Pause before processing to allow attaching a debugger.

`--watch`

lingo.dev run --watch

Watch source locale files continuously and retranslate automatically when files change

`--sound`

lingo.dev run --sound

Play audio feedback when translations complete (success or failure sounds)