Referencia de CLI

La CLI de i1n es la interfaz principal para gestionar la localización. Instálala globalmente con npm i -g i1n.

Todos los comandos se ejecutan en el contexto del directorio del proyecto actual, utilizando la configuración de i1n.config.json.

Inicializa i1n en un proyecto. Ejecuta una configuración interactiva que detecta el framework de tu proyecto, establece el formato y directorio del archivo de localización, configura el idioma de origen y crea i1n.config.json.

Este comando solo necesita ejecutarse una vez por proyecto. Vuelve a ejecutarlo para reconfigurar los ajustes.

Empuja los archivos de traducción locales a i1n. La CLI escanea tus archivos de localización (ej. locales/**/*.json) y sincroniza todas las claves con el proyecto.

Usá --translate [langs] para activar la traducción automática después de hacer push. Ejemplo: i1n push --translate es,fr,de,ja traduce a español, francés, alemán y japonés.

Si una clave y un idioma fueron editados en ambos lados desde la última sincronización (un conflicto real), la CLI te preguntará de forma interactiva: mantener el valor local, aceptar el valor del servidor o abortar el envío. Los cambios realizados solo en el servidor (ediciones hechas por otro usuario o en el panel mientras trabajabas) se escriben automáticamente en tus archivos locales al momento de enviar, y i1n.d.ts se regenera cuando es necesario.

Flags disponibles: --translate [langs] activa la traducción por IA después de hacer push (ejemplo: i1n push --translate es,fr,de,ja); --strategy <mode> establece la política de conflictos en interactive (predeterminado en una terminal), ours (gana el local), theirs (gana el servidor) o abort (se detiene ante cualquier conflicto). --force es una abreviatura de --strategy ours y sobrescribe los valores del servidor, lo cual es destructivo y descarta cualquier edición hecha en el servidor por otros colaboradores.

Extrae traducciones de i1n y escribe archivos locales. Obtiene todas las traducciones, escribe archivos de localización en tu formato configurado y genera definiciones de tipos TypeScript i1n.d.ts.

Ejecute esto después de que las traducciones estén completas, o como parte de su canalización de CI/CD para garantizar que los archivos estén siempre sincronizados.

Agrega interactivamente nuevos idiomas de destino a tu proyecto. El comando verifica los espacios de idioma disponibles en tu plan y permite la reactivación de idiomas usados previamente sin consumir nuevos espacios.

La disponibilidad de idiomas depende de tu plan: Starter admite 2, Pro admite 5, Business admite 12 y Enterprise admite los 182 idiomas disponibles.

Muestra los límites del proyecto y el uso actual. Muestra las claves utilizadas frente al límite, los créditos de traducción de IA utilizados frente al límite, los espacios de idioma utilizados frente a los disponibles y una lista de idiomas activos.

Utilice este comando para monitorear el consumo y determinar cuándo puede ser necesaria una actualización del plan.

Genera reglas de contexto de agente de IA para el proyecto. Crea archivos de reglas para Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) y Antigravity (.antigravity/rules.md).

Estos archivos enseñan a los agentes de IA a usar claves de traducción en lugar de cadenas codificadas, a colocar las claves en archivos de namespace correctos, a preservar las variables de interpolación y a ejecutar i1n push después de las modificaciones.

Inicia un servidor del Protocolo de Contexto de Modelo (MCP) que expone las herramientas de i1n a los asistentes de codificación de IA. Esto permite que Cursor, Claude Code, Windsurf y otros agentes compatibles con MCP ejecuten comandos de i1n directamente —push, pull, traducir, agregar idiomas y más— sin salir del IDE.

El servidor MCP expone 7 herramientas: i1n_status, i1n_push, i1n_pull, i1n_translate, i1n_add_language, i1n_extract_and_translate e i1n_search. La característica destacada es i1n_extract_and_translate: tu agente de IA extrae cadenas codificadas de un componente, las pasa a i1n y se envían instantáneamente, se traducen a todos los idiomas activos y se regeneran las definiciones de tipo. Configúralo con: claude mcp add i1n -- npx i1n mcp.