Referencia de comandos de la CLI
Consulta los comandos de la CLI para configurar, traducir y mantener los catálogos.
Usa lingo --help para consultar los comandos y lingo <command> --help para ver sus opciones. lingo --version identifica la generación instalada. El paquete actual es @lingo.dev/cli; los proyectos i18n.json utilizan el manual de v0, que se ofrece por separado.
Si ya tienes un proyecto i18n.json, Migración relaciona 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 sustituye 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 opción local --api-key guarda la clave de forma persistente. La opción global, cuando se usa en otro comando, solo se aplica a esa ejecución.
Cerrar sesión #
lingo logout borra las credenciales guardadas de forma persistente. Las claves del entorno y las proporcionadas para la ejecución siguen teniendo efecto.
Quién soy #
lingo whoami muestra la identidad y el tipo de autenticación; --json ofrece la salida en un formato 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 utilizados para traducir archivos. Los ID seleccionan recursos, pero no conceden acceso.
Desvincular #
lingo unlink elimina esos ID, pero conserva los archivos, la configuración de localización y los recursos remotos.
Enviar #
lingo push envía los archivos de origen. Sus modos distinguen entre el almacenamiento de una base de referencia, la traducción incremental, la generación de destinos que faltan, la actualización de claves y la sustitución forzada. --wait también recupera los resultados. Al ejecutarlo de nuevo, se reintentan las tareas fallidas.
Recuperar #
lingo pull recupera la última ejecución registrada localmente y comprueba los hashes de destino antes de escribir. --dry-run permite previsualizar qué se escribirá, aunque puede seguir contactando con el servidor.
Purgar #
lingo purge permite previsualizar o eliminar los destinos derivados. 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 archivos JSONC de origen y declaraciones. Realiza una extracción local, no una reescritura ni una traducción automática.
Comprobar #
lingo check falla si falta un archivo de destino y, cuando .lingo/lock.json está presente, si un archivo de origen ha cambiado desde su última traducción. No realiza llamadas de red ni necesita una clave de API. Sin el Lockfile, solo comprueba que existan los archivos de destino. En proyectos de React, también comprueba que el catálogo y los tipos estén actualizados, revisa el contexto y detecta entradas huérfanas y traducciones que faltan. No comprueba las claves de los archivos de destino que no sean 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 dispone de 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 y 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 instalada del paquete.
Guía para agentes #
lingo agent-guide [name] está pensado para agentes de IA. Si no se indica 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 indica un nombre, muestra esa guía, incluidas las guías de tecnologías que no figuran en la lista. Las guías corresponden a la versión instalada del paquete.
Agente #
lingo agent setup comprueba si los agentes de programación que detecta (Claude Code, Codex y Cursor, además del agente en el que 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 comprobar en su lugar, incluidos los que no se hayan detectado. Si no hay ningún agente que comprobar, 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, salvo que este importe un AGENTS.md en el que se escriba el bloque; nunca crea CLAUDE.md. Si un archivo no se puede leer, enlaza a una ubicación fuera del proyecto o contiene marcadores de bloque sin emparejar, lo deja sin cambios e indica el motivo; 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 instrucciones para dar a tu agente.
Actualizar #
lingo update utiliza el método de instalación detectado. Para instalar una versión concreta, usa tu gestor de paquetes. Las comprobaciones de actualizaciones se almacenan en caché y se omiten cuando se detecta un entorno de CI o cuando se desactivan mediante el 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 escribe los resultados localmente, sin añadirlos al historial de Radar.