> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lazylocales.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> The lazylocales command-line interface

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

## Installation

```bash theme={null}
npm install --save-dev lazylocales
```

Or use it directly with `npx`:

```bash theme={null}
npx lazylocales <command>
```

## Commands

| Command                       | Description                                                    |
| ----------------------------- | -------------------------------------------------------------- |
| [`translate`](/cli/translate) | Push source, translate locally with AI, and write locale files |
| [`check`](/cli/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`](/cli/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`](/cli/auth)          | Authenticate with LazyLocales                                  |
| [`logout`](/cli/auth)         | Clear stored credentials                                       |
| [`whoami`](/cli/auth)         | 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](/integrations/ci-cd) for details.