@autoglot/cli

Translate i18n files from the command line. Supports JSON, YAML, PO/POT, and Xcode String Catalogs.

Quick start

npx @autoglot/cli en.json --lang es,fr,de

Pass multiple files or a shell glob to translate them together in one job:

npx @autoglot/cli ios/Layers/**/*.xcstrings --lang es,fr,de

Setup

1. Sign up at autoglot.app
2. Go to dashboard / API keys and create a key
3. Export it:

export AUTOGLOT_API_KEY=your_key_here

CLI usage

autoglot <files...> --lang <codes> [options]

Arguments

Options

Examples

Translate a JSON file into Spanish, French, and German:

npx @autoglot/cli src/locales/en.json --lang es,fr,de

Translate a PO file with explicit source language and output directory:

npx @autoglot/cli messages.po --lang ja,ko --source en --output ./translations

Use a project's glossary and style guide:

npx @autoglot/cli en.json --lang es,fr --project acme/my-app

Keep a build moving with cached translations if fresh translation takes more than two minutes:

npx @autoglot/cli en.json --lang es,fr --project acme/my-app --timeout 120

Skip cache to force re-translation:

npx @autoglot/cli en.yaml --lang pt-BR --no-cache

Translate multiple Xcode String Catalogs in one job with one timeout:

npx @autoglot/cli ios/Layers/**/*.xcstrings --lang de,fr --project acme/ios --input-root . --branch main --deployment-type release --timeout 120

Library usage

@autoglot/cli also exports a translate() function for use in Node.js scripts and other tools (like @autoglot/next).

import { translate } from '@autoglot/cli';
import { readFileSync } from 'fs';

const files = await translate({
  files: [{
    filename: 'frontend/apps/web/locales/en.json',
    content: readFileSync('en.json', 'utf-8'),
  }],
  targetLanguages: ['es', 'fr', 'de'],
  sourceLanguage: 'en',
  apiKey: process.env.AUTOGLOT_API_KEY!,
  project: 'myorg/my-app',
  branch: 'main',
  deploymentType: 'release',
  timeoutSeconds: 120,
  onProgress: (status) => {
    console.log(`${status.completed_strings}/${status.total_strings}`);
  },
});

for (const file of files) {
  console.log(file.filename, file.content.length);
}

translate(options)

Returns Promise<{ filename: string; content: string }[]> — the translated files.

JobStatus

The object passed to onProgress:

Supported file formats

Supported languages

Links

• autoglot dashboard
• Get API key
• Report issues