Справочник команд CLI

Команды CLI для настройки, перевода и работы с каталогами.

Используйте lingo --help, чтобы найти нужную команду, и lingo <command> --help, чтобы посмотреть её параметры. lingo --version показывает установленное поколение CLI. Текущий пакет — @lingo.dev/cli. Для проектов i18n.json есть отдельное руководство по v0.

Если у вас уже есть проект i18n.json, в разделе Миграция вы найдёте соответствия между прежними рабочими процессами и текущими командами.

Инициализация #

lingo init создаёт начальную конфигурацию исходной и целевых локалей и шаблонов файлов. Параметр принудительной замены перезаписывает существующие записи файлов и может удалить расширенные настройки. Перед переводом проверьте итоговую конфигурацию.

Вход #

lingo login сохраняет сеанс браузера или проверенный ключ API. Локальный --api-key сохраняет ключ для дальнейшего использования. Глобальный параметр, указанный для другой команды, действует только при её текущем вызове.

Выход #

lingo logout удаляет сохранённые учётные данные. Ключи из переменных окружения и параметров вызова продолжают действовать.

Текущая учётная запись #

lingo whoami показывает учётную запись и тип аутентификации. --json выводит данные в машиночитаемом формате. Если из-за проблем с подключением команда использует сохранённые сведения, это не означает, что они проверены онлайн.

lingo link сохраняет ИД организации и движка локализации для перевода файлов. ИД определяют, какие ресурсы использовать, но не предоставляют к ним доступ.

lingo unlink удаляет эти ИД, но сохраняет файлы, настройки локализации и удалённые ресурсы.

Отправка #

lingo push отправляет исходные файлы. У команды есть отдельные режимы для сохранения исходного состояния, перевода изменений, добавления недостающих переводов, обновления ключей и принудительной замены. --wait также получает результаты. При повторном запуске команда заново выполняет работу, которая завершилась с ошибкой.

Получение #

lingo pull получает результаты последнего запуска, записанного локально, и проверяет хеши целевых файлов перед записью. --dry-run показывает, что будет записано, но при этом может обращаться к серверу.

Удаление переводов #

lingo purge показывает, какие созданные целевые файлы будут удалены, или удаляет их. С фильтрами по файлам или локалям команда удаляет из Lockfile только выбранные целевые записи. Без фильтров она удаляет весь Lockfile. Общие каталоги XCStrings пропускаются.

Извлечение #

lingo extract преобразует поддерживаемые статические вызовы TypeScript/TSX в исходный JSONC и объявления. Команда извлекает данные локально, а не переписывает и не переводит их автоматически.

Проверка #

lingo check завершается с ошибкой, если целевой файл отсутствует, а при наличии .lingo/lock.json — ещё и если исходный текст изменился с момента последнего перевода. Команда не отправляет сетевых запросов и не требует ключа API. Без Lockfile проверяет только наличие целевых файлов. В проектах React также проверяет актуальность каталога и типов, контекст, записи без привязки и недостающие переводы. Ключи в целевых файлах вне React и качество перевода команда не проверяет.

Очистка #

lingo clean сразу удаляет неиспользуемые исходные записи и устаревшие целевые записи из каталогов JSONC. У команды нет флага пробного запуска, и она не создаёт объявления заново.

Руководство #

lingo guide [name] выводит встроенное офлайн-руководство по React. Доступные названия: index, setup-react, api и migrate. Если название не указано, выводится оглавление. Если название неизвестно, команда показывает доступные варианты. Руководство соответствует установленной версии пакета.

Руководство для агентов #

lingo agent-guide [name] — для AI-агентов. Если не указать название руководства, команда выведет руководство для агентов. В нём описаны настройка, вход в систему и MCP server, а также приведён список руководств для агентов и людей. Если указать название, команда выведет нужное руководство, в том числе по стеку, даже если его нет в списке. Руководства соответствуют установленной версии пакета.

Агент #

lingo agent setup проверяет, есть ли Lingo.dev MCP server у обнаруженных агентов для работы с кодом (Claude Code, Codex и Cursor, а также агента, внутри которого запущена команда). Если его нет, команда предлагает перейти к настройке MCP, но никогда не меняет конфигурации агентов. С помощью --client вы можете указать, какие агенты проверить, в том числе те, которые не были обнаружены. Если проверять нечего, команда завершается с ошибкой и ничего не записывает. Внутри проекта она также записывает блок Lingo.dev в AGENTS.md и в существующий CLAUDE.md, если только тот не импортирует AGENTS.md, куда записывается этот блок. При этом команда никогда не создаёт CLAUDE.md. Если файл не удаётся прочитать, он ссылается за пределы проекта или содержит непарные маркеры блока, команда оставляет его без изменений и объясняет причину. Исправьте файл и запустите настройку ещё раз. --dry-run показывает план, -y записывает изменения без подтверждения, а --status показывает, что настроено для обнаруженных агентов, игнорируя --client. В разделе Настройка с помощью агента для работы с кодом есть промпты, которые вы можете передать агенту.

Обновление #

lingo update использует обнаруженный способ установки. Чтобы установить конкретную версию, используйте свой менеджер пакетов. Результаты проверки обновлений кешируются. Проверка пропускается, если обнаружена среда CI или она отключена через переменную окружения.

Оценка #

lingo score зарегистрирована, но не отображается в обычной справке. Команда запускает локальные комбинации модулей оценки и моделей через OpenRouter и сохраняет результаты локально, не добавляя записи в историю Radar.