Localesy CLI

Command-line interface for Localesy - AI-powered translation management for developers.

Installation

npx localesy@latest <command>

Or install globally:

npm install -g localesy

Quick Start

# Initialize a project by scanning your translation files
npx localesy init

# Check translation status
npx localesy status

# Push local translations to Localesy (pulls first if Localesy is ahead)
npx localesy push

# Translate changes on your branch to all languages
npx localesy translate

Commands

| Command | Description | | ----------- | ----------------------------------------------------- | | config | View or update project configuration | | init | Initialize Localesy by scanning for translation files | | login | Authenticate with Localesy | | logout | Clear stored credentials | | new | Create a new language, project, or organization | | open | Open the project in your browser | | status | Show translation stats and sync status | | push | Push local translations (pulls first if remote ahead) | | pull | Pull translations from Localesy into local files | | translate | Translate source changes to target languages |

Workflow

1. Initialize your project

npx localesy init --path ./src/locales

The CLI will scan your translation files (JSON, YAML, PO), detect languages, and create a project on Localesy.

2. Keep translations in sync

# Push local changes (pulls first if Localesy is ahead, so you never clobber remote edits)
npx localesy push

# Pull remote changes into your local files
npx localesy pull

# Skip the sync-status check and all prompts (e.g. in CI)
npx localesy push --yes

3. Translate missing keys

When your source files have keys that target languages are missing:

npx localesy translate

This analyzes your local files against Localesy, identifies missing keys, and generates translations for the target languages you select. The translated files are written to your local translation files — run git diff to review the changes.

4. Add new languages

npx localesy new
# Select "New language" and choose from available locales

Authentication

The CLI uses browser-based authentication. Run any command and you'll be prompted to log in via your browser. Credentials are stored locally at ~/.localesy/auth.json.

Configuration

Project configuration is stored locally and linked to your working directory. View or update it with:

npx localesy config

Environment Variables

| Variable | Description | | ------------------ | ----------------------------- | | LOCALESY_API_URL | Override the Localesy API URL | | LOCALESY_APP_URL | Override the Localesy app URL |

Requirements

• Node.js 18+
• Git (optional - used to detect your default branch during init)

License

MIT