Команды настройки и идентификации. Ни одна из них не работает с исходным контентом — они управляют только учётными данными и привязками проекта.
lingo login#
Аутентификация в Lingo.dev. Два варианта:
OTP (по умолчанию, интерактивный режим)#
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 / неинтерактивный режим)#
lingo login --api-key lk_...Сохраняет API-ключ. Создать ключи можно на платформе Lingo.dev в настройках вашей организации: API keys.
Вы также можете передать --api-key как глобальный флаг в любой команде — тогда сохранённые учётные данные будут полностью проигнорированы:
lingo push --api-key lk_...Удобно для разовых CI-зач, где учётные данные не должны записываться на диск.
lingo logout#
lingo logoutОчищает ~/.lingo/auth.json. Если вы не были авторизованы, команда ничего не сделает.
lingo link#
lingo link
lingo link --org org_a8c... --engine eng_b9d... # skip promptsПривязывает текущий проект к организации и движку локализации. Записывает orgId и engineId в .lingo/config.json (добавьте файл в коммит).
В интерактивном режиме можно выбрать существующие организации и движки или создать новые прямо по ходу дела — link запросит имя, проведёт onboarding-опрос для новых организаций и создаст ресурс через API перед привязкой.
lingo unlink#
lingo unlinkУдаляет orgId и engineId из .lingo/config.json. Организация и движок при этом не удаляются — разрывается только локальная привязка. Удобно перед повторной привязкой к другому движку.
lingo whoami#
lingo whoami
lingo whoami --jsonПоказывает три вещи:
- Identity — адрес почты, под которым вы вошли, либо то, что используется API-ключ.
- Org — привязанная организация (имя подтягивается через API).
- Engine — привязанный движок (имя подтягивается через API).
Email: you@company.com
Org: Acme Inc (org_a8c...)
Engine: Production (eng_b9d...)
Auth: sessionЕсли вы находитесь не в директории привязанного проекта, строки Org/Engine не выводятся. --json возвращает те же данные в структурированном виде для скриптов.
Глобальный флаг --api-key#
Каждая команда поддерживает флаг --api-key, который подменяет сохранённые учётные данные только для этого запуска. Стандартный паттерн для CI:
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 и состояние запуска.
