|
Документация
Заказать демоПлатформа
ПлатформаMCPCLI
APIПроцессы
РуководстваЖурнал изменений

Обзор

  • @lingo.dev/cli

Начало работы

  • Быстрый старт
  • Конфигурация

Справочник

  • lingo push
  • lingo pull
  • Другие команды
  • lingo purge

Конфигурация

  • Управление ключами
  • Форматы
  • Локали

Руководства

  • Добавление локали
  • Существующие переводы
  • Повторный перевод
  • Примечания для переводчика
  • Запуски, состояние и восстановление
  • CI/CD
  • Монорепозитории
  • Крупные проекты

Ищете CLI прежней версии (v0)? См. документацию по CLI прежней версии

Другие команды

Команды настройки и идентификации. Ни одна из них не работает с исходным контентом — они управляют только учётными данными и привязками проекта.

lingo login#

Аутентификация в Lingo.dev. Два варианта:

OTP (по умолчанию, интерактивный режим)#

bash
lingo login
lingo login --email you@company.com           # skip the email prompt
lingo login --email you@company.com --code 123456   # skip the code prompt too

Отправляет одноразовый код на вашу почту, проверяет его и сохраняет сессию Supabase в ~/.lingo/auth.json. Рядом также сохраняются refresh-токены, поэтому сессия будет действовать между запусками, пока вы явно не выполните logout.

API key (CI / неинтерактивный режим)#

bash
lingo login --api-key lk_...

Сохраняет API-ключ. Создать ключи можно на платформе Lingo.dev в настройках вашей организации: API keys.

Вы также можете передать --api-key как глобальный флаг в любой команде — тогда сохранённые учётные данные будут полностью проигнорированы:

bash
lingo push --api-key lk_...

Удобно для разовых CI-зач, где учётные данные не должны записываться на диск.

lingo logout#

bash
lingo logout

Очищает ~/.lingo/auth.json. Если вы не были авторизованы, команда ничего не сделает.

lingo link#

bash
lingo link
lingo link --org org_a8c... --engine eng_b9d...   # skip prompts

Привязывает текущий проект к организации и движку локализации. Записывает orgId и engineId в .lingo/config.json (добавьте файл в коммит).

В интерактивном режиме можно выбрать существующие организации и движки или создать новые прямо по ходу дела — link запросит имя, проведёт onboarding-опрос для новых организаций и создаст ресурс через API перед привязкой.

lingo unlink#

bash
lingo unlink

Удаляет orgId и engineId из .lingo/config.json. Организация и движок при этом не удаляются — разрывается только локальная привязка. Удобно перед повторной привязкой к другому движку.

lingo whoami#

bash
lingo whoami
lingo whoami --json

Показывает три вещи:

  1. Identity — адрес почты, под которым вы вошли, либо то, что используется API-ключ.
  2. Org — привязанная организация (имя подтягивается через API).
  3. Engine — привязанный движок (имя подтягивается через API).
text
Email:   you@company.com
  Org:     Acme Inc (org_a8c...)
  Engine:  Production (eng_b9d...)
  Auth:    session

Если вы находитесь не в директории привязанного проекта, строки Org/Engine не выводятся. --json возвращает те же данные в структурированном виде для скриптов.

Глобальный флаг --api-key#

Каждая команда поддерживает флаг --api-key, который подменяет сохранённые учётные данные только для этого запуска. Стандартный паттерн для CI:

yaml
env:
  LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
  - run: lingo push --backfill-missing --yes --api-key "$LINGO_API_KEY"

(CLI также читает LINGO_API_KEY из окружения как запасной вариант.)

Что дальше#

  • lingo push — перевод с учётом области видимости и delta translation.
  • lingo pull — получение данных на разных машинах.
  • Configuration — .lingo/config.json, lockfile и состояние запуска.

Эта страница была полезной?

Max PrilutskiyMax Prilutskiy·Обновлено 5 дней назад·2 минуты чтения