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

CLI i1n — это основной интерфейс для управления локализацией. Установите его глобально с помощью npm i -g i1n.

Все команды выполняются в контексте текущего каталога проекта с использованием конфигурации из файла i1n.config.json.

Инициализируйте i1n в проекте. Запускает интерактивную настройку, которая определяет структуру вашего проекта, устанавливает формат и каталог файлов локали, настраивает исходный язык и создает файл i1n.config.json.

Эту команду нужно выполнить один раз для каждого проекта. Повторно запустите ее для перенастройки параметров.

Отправляйте локальные файлы перевода в i1n. CLI сканирует ваши файлы локализации (например, locales/**/*.json) и синхронизирует все ключи с проектом.

Используйте --translate [langs] для запуска AI-перевода после отправки. Пример: i1n push --translate es,fr,de,ja переводит на испанский, французский, немецкий и японский языки.

Если ключ и язык были изменены с обеих сторон после последней синхронизации (настоящий конфликт), CLI предложит сделать выбор в интерактивном режиме: сохранить локальное значение, принять серверное значение или прервать отправку. Изменения, внесенные только на сервере (другим пользователем или через панель управления во время вашей работы), автоматически записываются в ваши локальные файлы во время отправки, а файл i1n.d.ts при необходимости пересоздается.

Доступные флаги: --translate [langs] запускает ИИ-перевод после отправки (пример: i1n push --translate es,fr,de,ja); --strategy <mode> устанавливает политику разрешения конфликтов: interactive (по умолчанию в терминале), ours (приоритет локальной версии), theirs (приоритет серверной версии) или abort (прерывание при любом конфликте). --force — это сокращение для --strategy ours, которое перезаписывает значения на сервере; это деструктивное действие, которое отменяет любые изменения, внесенные другими пользователями на стороне сервера.

Получите переводы из i1n и запишите локальные файлы. Извлекает все переводы, записывает файлы локалей в настроенном вами формате и генерирует определения типов TypeScript i1n.d.ts.

Запустите это после завершения переводов или как часть вашего конвейера CI/CD, чтобы гарантировать, что файлы всегда синхронизированы.

Интерактивно добавляйте новые языки для перевода в ваш проект. Команда проверяет доступные языковые слоты в вашем плане и позволяет повторно активировать ранее использовавшиеся языки, не занимая новые слоты.

Доступность языков зависит от вашего плана: Starter поддерживает 2, Pro — 5, Business — 12, а Enterprise — все 182 языка.

Отображение лимитов проекта и текущего использования. Показывает использованные ключи в сравнении с лимитом, использованные кредиты на AI-перевод в сравнении с лимитом, использованные языковые слоты в сравнении с доступными, а также список активных языков.

Используйте эту команду для отслеживания использования и определения, когда может потребоваться обновление плана.

Сгенерируйте правила контекста для AI-агента для проекта. Создает файлы правил для Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) и Antigravity (.antigravity/rules.md).

Эти файлы учат ИИ-агентов использовать ключи перевода вместо жестко закодированных строк, размещать ключи в файлах правильного пространства имен, сохранять переменные интерполяции и запускать i1n push после внесения изменений.

Запустите сервер протокола контекста модели (MCP), который предоставляет инструменты i1n для ИИ-помощников по программированию. Это позволит Cursor, Claude Code, Windsurf и другим совместимым с MCP агентам выполнять команды i1n напрямую — push, pull, translate, add languages и другие — не покидая IDE.

Сервер MCP предоставляет 7 инструментов: i1n_status, i1n_push, i1n_pull, i1n_translate, i1n_add_language, i1n_extract_and_translate и i1n_search. Выделяющаяся функция — i1n_extract_and_translate: ваш ИИ-агент извлекает жестко закодированные строки из компонента, передает их в i1n, и они мгновенно отправляются, переводятся на все активные языки и перегенерируются определения типов. Настройте его с помощью: claude mcp add i1n -- npx i1n mcp.