CLI Overview - LazyLocales Documentation

The lazylocales CLI is the primary way to interact with LazyLocales. It handles authentication, source file management, translation triggering, and locale file downloads.

Installation

npm install --save-dev lazylocales

Or use it directly with npx:

npx lazylocales <command>

Commands

Command	Description
`translate`	Push source, translate locally with AI, and write locale files
`check`	Scan codebase for unused/missing translation keys
`push`	Push the source locale file to LazyLocales
`pull`	Check status of translated locale files on disk
`status`	Show translation coverage for all locales
`add`	Add a new target language to the project
`remove`	Remove a target language from the project
`delete-project`	Permanently delete the current project
`login`	Authenticate with LazyLocales
`logout`	Clear stored credentials
`whoami`	Show the currently logged-in user
`completion`	Print shell completion script for tab completion

Global options

All commands support these flags:

Flag	Description
`--help`	Show help for a command
`--version`	Show the installed CLI version

Authentication

The CLI uses your login session by default. Credentials are stored in ~/.config/lazylocales/. For CI/CD environments, set the LAZYLOCALES_API_KEY environment variable. The CLI uses it automatically. See CI/CD Setup for details.