CLI Commands

Reference documentation for the Lingo.dev CLI commands

This page contains the complete list of commands available via Lingo.dev CLI. To access this documentation from the CLI itself, run the following command:

npx lingo.dev@latest --help

lingo.dev

Usage: lingo.dev [options] [command]

Lingo.dev CLI

Options:
  -v, --version         Show version
  -y, --no-interactive  Disable interactive mode
  -h, --help            Show help

Commands:
  init [options]        Initialize Lingo.dev project
  i18n [options]        Run Localization engine
  auth [options]        Show current authentication status
  login                 Authenticate with Lingo.dev API
  logout                Log out from Lingo.dev API
  show                  Prints out the current configuration
  config                Manage Lingo.dev CLI configuration
  lockfile [options]    Create a lockfile if it does not exist
  cleanup [options]     Remove keys from target files that do not exist in the
                        source file
  mcp                   Use Lingo.dev model context provider with your AI agent
  ci [options]          Run Lingo.dev CI/CD action
  status [options]      Show the status of the localization process
  run [options]         Run Lingo.dev localization engine
  purge [options]       Remove translations for given --bucket, --file, --key,
                        --locale
  help [command]        display help for command

lingo.dev init

Usage: lingo.dev init [options]

Initialize Lingo.dev project

Options:
  -f --force                Overwrite existing config (default: false)
  -s --source <locale>      Source locale (default: "en")
  -t --targets <locale...>  List of target locales (default: "es")
  -b, --bucket <type>       Type of bucket (default: "json")
  -p, --paths [path...]     List of paths for the bucket (default: [])
  -y, --no-interactive      Disable interactive mode
  -h, --help                Show help

lingo.dev i18n

Usage: lingo.dev i18n [options]

Run Localization engine

Options:
  --locale <locale>    Locale to process
  --bucket <bucket>    Bucket to process
  --key <key>          Key to process. Process only a specific translation key,
                       useful for debugging or updating a single entry
  --file [files...]    File to process. Process only a specific path, may
                       contain asterisk * to match multiple files. Useful if
                       you have a lot of files and want to focus on a specific
                       one. Specify more files separated by commas or spaces.
  --frozen             Run in read-only mode - fails if any translations need
                       updating, useful for CI/CD pipelines to detect missing
                       translations
  --force              Ignore lockfile and process all keys, useful for full
                       re-translation
  --verbose            Show detailed output including intermediate processing
                       data and API communication details
  --interactive        Enable interactive mode for reviewing and editing
                       translations before they are applied
  --api-key <api-key>  Explicitly set the API key to use, override the default
                       API key from settings
  --debug              Pause execution at start for debugging purposes, waits
                       for user confirmation before proceeding
  --strict             Stop processing on first error instead of continuing
                       with other locales/buckets
  -h, --help           Show help

lingo.dev auth

Usage: lingo.dev auth [options]

Show current authentication status

Options:
  --login     Login to your account (deprecated: use 'lingo.dev login' instead)
  --logout    Logout from your account (deprecated: use 'lingo.dev logout'
              instead)
  -h, --help  Show help

lingo.dev login

Usage: lingo.dev login [options]

Authenticate with Lingo.dev API

Options:
  -h, --help  Show help

lingo.dev logout

Usage: lingo.dev logout [options]

Log out from Lingo.dev API

Options:
  -h, --help  Show help

lingo.dev show

Usage: lingo.dev show [options] [command]

Prints out the current configuration

Options:
  -h, --help       Show help

Commands:
  config           Print out the current configuration
  locale <type>    Print out the list of locales
  files [options]  Print out the list of files managed by Lingo.dev
  help [command]   display help for command

lingo.dev show config

Usage: lingo.dev show config [options]

Print out the current configuration

Options:
  -h, --help  Show help

lingo.dev show locale

Usage: lingo.dev show locale [options] <type>

Print out the list of locales

Arguments:
  type        Type of locales to show, either "sources" or "targets"

Options:
  -h, --help  Show help

lingo.dev show files

Usage: lingo.dev show files [options]

Print out the list of files managed by Lingo.dev

Options:
  --source    Only show source files, files containing the original
              translations
  --target    Only show target files, files containing translated content
  -h, --help  Show help

lingo.dev config

Usage: lingo.dev config [options] [command]

Manage Lingo.dev CLI configuration

Options:
  -h, --help         Show help

Commands:
  set <key> <value>  Set a configuration key to a value
  unset <key>        Remove a configuration key
  get <key>          Get the value of a configuration key
  help [command]     display help for command

lingo.dev config set

Usage: lingo.dev config set [options] <key> <value>

Set a configuration key to a value

Arguments:
  key         Configuration key to set
  value       New value

Options:
  -h, --help  Show help

lingo.dev config unset

Usage: lingo.dev config unset [options] <key>

Remove a configuration key

Arguments:
  key         Configuration key to remove

Options:
  -h, --help  Show help

lingo.dev config get

Usage: lingo.dev config get [options] <key>

Get the value of a configuration key

Arguments:
  key         Configuration key

Options:
  -h, --help  Show help

lingo.dev lockfile

Usage: lingo.dev lockfile [options]

Create a lockfile if it does not exist

Options:
  -f, --force  Force create a lockfile
  -h, --help   Show help

lingo.dev cleanup

Usage: lingo.dev cleanup [options]

Remove keys from target files that do not exist in the source file

Options:
  --locale <locale>  Specific locale to cleanup
  --bucket <bucket>  Specific bucket to cleanup
  --dry-run          Show what would be removed without making changes
  --verbose          Show detailed output including:
    - List of keys that would be removed.
    - Processing steps.
  -h, --help         Show help

lingo.dev mcp

Usage: lingo.dev mcp [options]

Use Lingo.dev model context provider with your AI agent

Options:
  -h, --help  Show help

lingo.dev ci

Usage: lingo.dev ci [options]

Run Lingo.dev CI/CD action

Options:
  --parallel [boolean]             Run in parallel mode
  --api-key <key>                  API key
  --pull-request [boolean]         Create a pull request with the changes
  --commit-message <message>       Commit message
  --pull-request-title <title>     Pull request title
  --working-directory <dir>        Working directory
  --process-own-commits [boolean]  Process commits made by this action
  -h, --help                       Show help

lingo.dev status

Usage: lingo.dev status [options]

Show the status of the localization process

Options:
  --locale <locale>    Locale to process
  --bucket <bucket>    Bucket to process
  --file [files...]    File to process. Process only files that include this
                       string in their path. Useful if you have a lot of files
                       and want to focus on a specific one. Specify more files
                       separated by commas or spaces.
  --force              Ignore lockfile and process all keys, useful for
                       estimating full re-translation
  --verbose            Show detailed output including key-level word counts
  --api-key <api-key>  Explicitly set the API key to use, override the default
                       API key from settings
  -h, --help           Show help

lingo.dev may-the-fourth

Usage: lingo.dev may-the-fourth [options]

May the Fourth be with you

Options:
  -h, --help  Show help

lingo.dev run

Usage: lingo.dev run [options]

Run Lingo.dev localization engine

Options:
  --source-locale <source-locale>  Locale to use as source locale. Defaults to
                                   i18n.json locale.source
  --target-locale <target-locale>  Locale to use as target locale. Defaults to
                                   i18n.json locale.targets
  --bucket <bucket>                Bucket to process
  --file <file>                    File to process. Process only files that
                                   match this glob pattern in their path. Use
                                   quotes around patterns to prevent shell
                                   expansion (e.g., --file '**/*.json'). Useful
                                   if you have a lot of files and want to focus
                                   on a specific one. Specify more files
                                   separated by commas or spaces. Accepts glob
                                   patterns.
  --key <key>                      Key to process. Process only a specific
                                   translation key, useful for updating a
                                   single entry. Accepts glob patterns.
  --force                          Ignore lockfile and process all keys, useful
                                   for full re-translation
  --api-key <api-key>              Explicitly set the API key to use, override
                                   the default API key from settings
  --debug                          Pause execution at start for debugging
                                   purposes, waits for user confirmation before
                                   proceeding
  --concurrency <concurrency>      Number of concurrent tasks to run
  --watch                          Watch source files for changes and
                                   automatically retranslate
  --debounce <milliseconds>        Debounce delay in milliseconds for watch
                                   mode (default: 5000ms)
  -h, --help                       Show help

lingo.dev purge

Usage: lingo.dev purge [options]

Remove translations for given --bucket, --file, --key, --locale

Options:
  --bucket <bucket>  Bucket to process
  --file [files...]  File(s) to process. Only process files that match the
                     given glob pattern(s).
  --key <key>        Key to remove. Remove all translation keys matching the
                     given glob pattern.
  --locale <locale>  Locale to process
  --yes-really       Skip interactive confirmation and delete without asking.
  -h, --help         Show help