CLI reference — lexisync

Command-line interface for syncing, pulling, and publishing translations from CI or your laptop.

lexisync ships a CLI in the same package. It talks to the v1 API using the secret key from your environment.

npx lexisync sync \
  -p $PROJECT_ID              # project id
  -f ./locales/en/common.json # source file
  -l en                        # source language
  -n common                    # namespace (default: common)

# Override behaviour
  --dry-run                   # validate only, no writes
  --merge                     # merge into existing keys (default: replace)
  --review                    # mark as human (origin=human)

Pull writes the published catalog back to local files. Use it during on-boarding or to refresh cached translations.

npx lexisync pull -p $PROJECT_ID -d ./locales -v production

Publish takes a snapshot of the working copy and pushes it to the CDN under the given version tag.

npx lexisync publish -p $PROJECT_ID -v production

# Idempotent retry
npx lexisync publish -p $PROJECT_ID -v production --idempotency-key release-2026-03-01