Referencia de comandos de la CLI
Encuentra comandos de la CLI para configurar, traducir y mantener tus catálogos.
Usa lingo --help para explorar los comandos y lingo <command> --help para consultar sus opciones. lingo --version identifica la generación instalada. El paquete actual es @lingo.dev/cli; los proyectos i18n.json usan el manual de v0, disponible por separado.
Si ya tienes un proyecto i18n.json, Migración muestra cómo se corresponden los flujos de trabajo anteriores con los comandos actuales.
Inicializar #
lingo init crea la configuración inicial de los idiomas de origen y destino y los patrones de archivos. La opción de forzado reemplaza las entradas de archivos existentes y puede descartar opciones avanzadas; revisa la configuración resultante antes de traducir.
Iniciar sesión #
lingo login guarda una sesión del navegador o una clave de API validada. Su --api-key local conserva la clave. La opción global usada en otro comando solo se aplica a esa ejecución.
Cerrar sesión #
lingo logout elimina las credenciales guardadas. Las claves del entorno y las proporcionadas para una ejecución siguen siendo válidas.
Consultar identidad #
lingo whoami muestra la identidad y el tipo de autenticación; --json proporciona una salida legible por máquinas. Recurrir a la información guardada ante un problema de conectividad no equivale a una verificación en línea.
Vincular #
lingo link guarda los ID de la organización y del motor de localización que se usan para traducir archivos. Los ID permiten seleccionar recursos, pero no otorgan acceso.
Desvincular #
lingo unlink elimina esos ID sin afectar los archivos, la configuración de localización ni los recursos remotos.
Enviar #
lingo push envía los archivos de origen. Sus modos permiten distinguir entre almacenar una base de referencia, traducir de forma incremental, completar los destinos faltantes, actualizar las claves y forzar el reemplazo. --wait también recupera la salida. Al ejecutarlo de nuevo, se reintentan las tareas fallidas.
Obtener #
lingo pull recupera la última ejecución registrada localmente y verifica los hashes de destino antes de escribir. --dry-run muestra una vista previa de lo que se escribirá, pero aun así puede comunicarse con el servidor.
Purgar #
lingo purge muestra una vista previa de los destinos derivados o los elimina. Con filtros de archivo o idioma, elimina del Lockfile solo las entradas de destino seleccionadas; sin filtros, elimina todo el Lockfile. Los catálogos XCStrings compartidos se omiten.
Extraer #
lingo extract convierte las llamadas estáticas compatibles de TypeScript/TSX en JSONC de origen y declaraciones. Realiza una extracción local, no una reescritura ni una traducción automática.
Comprobar #
lingo check falla cuando falta un archivo de destino y, si .lingo/lock.json está presente, cuando un archivo de origen ha cambiado desde su última traducción. No realiza llamadas de red ni requiere una clave de API. Sin el Lockfile, solo verifica que existan los archivos de destino. En proyectos de React, también verifica que el catálogo y los tipos estén actualizados, además del contexto, los elementos huérfanos y las traducciones faltantes. No verifica las claves dentro de los archivos de destino que no son de React ni evalúa la calidad de las traducciones.
Limpiar #
lingo clean elimina de inmediato las entradas de origen huérfanas y las entradas de destino obsoletas de los catálogos JSONC. No tiene una opción de simulación ni regenera las declaraciones.
Guía #
lingo guide [name] muestra la guía de React incluida en el paquete, disponible sin conexión. Los nombres son index, setup-react, api y migrate; si se omite el nombre, se selecciona el índice. Si el nombre no se reconoce, se muestran las opciones disponibles. La guía corresponde a la versión del paquete instalado.
Guía para agentes #
lingo agent-guide [name] está pensado para agentes de IA. Si no se especifica un nombre, muestra la guía para agentes, que explica la configuración, el inicio de sesión y el MCP server, y enumera las guías para agentes y personas. Si se especifica un nombre, muestra la guía correspondiente, incluidas las guías de stacks que no aparecen en la lista. Las guías corresponden a la versión instalada del paquete.
Agente #
lingo agent setup verifica si los agentes de programación que detecta (Claude Code, Codex y Cursor, además del agente dentro del cual se ejecuta) tienen el MCP server de Lingo.dev y remite a la configuración de MCP para los que no lo tienen; nunca modifica sus configuraciones. --client permite indicar qué agentes verificar en su lugar, incluso los que no se detectaron. Si no hay ningún agente que verificar, falla sin escribir nada. Dentro de un proyecto, también escribe el bloque de Lingo.dev en AGENTS.md y en un CLAUDE.md existente, a menos que este importe un AGENTS.md que reciba el bloque; nunca crea CLAUDE.md. Deja el archivo sin cambios y explica el motivo si no se puede leer, si apunta a una ubicación fuera del proyecto o si sus marcadores de bloque no están emparejados; corrige el archivo y vuelve a ejecutar la configuración. --dry-run muestra el plan, -y escribe sin preguntar y --status muestra lo que está configurado para los agentes detectados, sin tener en cuenta --client. Configurar con un agente de programación incluye indicaciones para darle a tu agente.
Actualizar #
lingo update usa el método de instalación detectado. Usa tu administrador de paquetes para instalar una versión específica. Las comprobaciones de actualizaciones se guardan en caché y se omiten cuando se detecta un entorno de CI o cuando se desactivan mediante una variable de entorno.
Puntuar #
lingo score está registrado, pero no aparece en la ayuda habitual. Ejecuta combinaciones locales de evaluadores y modelos a través de OpenRouter y guarda los resultados localmente, sin agregar historial a Radar.