[{"href":"/es/cli","title":"Usa Lingua sin abrir una ventana","description":"Conoce el CLI headless de Lingua, compílalo hoy y convierte tu primer comando en un flujo local repetible.","group":"start","searchText":"Usa Lingua sin abrir una ventana Conoce el CLI headless de Lingua, compílalo hoy y convierte tu primer comando en un flujo local repetible. instalar homebrew brew npm terminal primeros pasos headless offline ayuda El CLI de Lingua sirve cuando una acción útil debe salir de la app y convertirse en un comando de terminal, un pipe o un paso de CI. Ejecuta las mismas utilidades y el mismo esquema de Run Capsules de Lingua, pero   no   abre Electron ni React.\n\nEs local, automatizable y deliberadamente pequeño. Úsalo para formatear un payload desde stdin, ejecutar un archivo confiable, validar una Capsule en CI o repetir una ejecución capturada.\n\n   Instálalo\n\nEn macOS, Homebrew descarga el artefacto oficial del CLI y configura Node 24 automáticamente. No ejecuta npm:\n\n   bash\nbrew install johnny4young/tap/lingua-cli\nlingua --help\n   \n\nEsta fórmula es independiente de  brew install --cask johnny4young/tap/lingua , que instala en  /Applications/lingua.app  la misma aplicación Desktop distribuida en el  .dmg .\n\n @linguacode/cli  también continúa disponible en npm para cualquier plataforma compatible con Node. No tiene dependencias de paquete y necesita Node 24.x:\n\n   bash\nnpm install -g @linguacode/cli\nlingua --help\n   \n\n¿Prefieres no instalar nada? Ejecútalo una sola vez con  npx :\n\n   bash\nnpx @linguacode/cli --help\n   \n\nEn Windows x64 y Linux x64 puedes usar los archivos independientes  lingua-cli- -linux-x64.tar.gz  y  -windows-x64.tar.gz  incluidos en cada  GitHub Release  https://github.com/johnny4young/lingua/releases/latest  estable. Las utilidades y la validación de Capsules no requieren una instalación separada de Node; ejecutar o reproducir JavaScript y TypeScript todavía requiere Node.js 24 en  PATH .\n\n   Compílalo desde el código fuente\n\nSi contribuyes al proyecto, o si sigues  main  antes de una release, compílalo desde el repositorio:\n\n   bash\ngit clone https://github.com/johnny4young/lingua.git\ncd lingua\ncorepack enable\npnpm install\npnpm run build:cli\nnode dist/cli/lingua.cjs --help\n   \n\nPara desarrollo local, agrega el comando  lingua  a tu  PATH :\n\n   bash\npnpm link --global\nlingua --version\n   \n\nEste enlace apunta a tu checkout. Ejecuta  pnpm run build:cli  después de cambiar el código del CLI.\n\n   Ejecuta tu primer comando útil\n\nFormatea JSON directamente desde otro programa:\n\n   bash\ncurl -s https://api.github.com/repos/johnny4young/lingua \\\n  | lingua utility json-format\n   \n\nTambién puedes ejecutar un archivo con el toolchain instalado en tu equipo:\n\n   bash\nlingua run ./scripts/check.ts -- --verbose\n   \n\nTodo lo que aparece después de  --  pertenece a tu programa, no a Lingua.\n\n   Elige el comando correcto\n\n| Quieres… | Empieza con |\n| --- | --- |\n| transformar o inspeccionar un valor |  lingua utility  |\n| ejecutar un archivo o proyecto convencional |  lingua run  |\n| revisar una Capsule sin ejecutarla |  lingua capsule validate  |\n| reproducir una ejecución capturada |  lingua capsule replay  |\n| descubrir utilidades y sus opciones |  lingua list utilities --json  |\n| activar autocompletado |  lingua completion  |\n\n   Un modelo mental seguro\n\nEl CLI no interpola tu comando mediante un shell, pero el código que ejecuta  lingua run  conserva tus permisos del sistema operativo. Ejecuta solo código confiable. Para código no confiable, coloca el CLI dentro de un contenedor o sandbox bajo tu control.\n\nEl CLI no necesita red. Tu programa sí puede usarla, y cada lenguaje requiere su toolchain local correspondiente.\n\n   Continúa según tu tarea\n\n-  Ejecuta archivos y proyectos  /es/cli/run-code \n-  Conecta utilidades en pipes  /es/cli/utilities \n-  Copia recetas para APIs, repositorios, CI, contenedores y PowerShell  /es/cli/recipes \n-  Valida y repite Run Capsules  /es/cli/capsules \n-  Usa Lingua en scripts y CI  /es/cli/automation \n-  Resuelve problemas de PATH, runtimes y salida  /es/cli/troubleshooting \n-  Consulta comandos, opciones y códigos  /es/cli/reference  "},{"href":"/es/cli/run-code","title":"Ejecuta archivos y proyectos","description":"Ejecuta JavaScript, TypeScript, Python, Go, Rust, Ruby o Lua confiable con stdin, argumentos, timeouts y variables explícitas.","group":"guides","searchText":"Ejecuta archivos y proyectos Ejecuta JavaScript, TypeScript, Python, Go, Rust, Ruby o Lua confiable con stdin, argumentos, timeouts y variables explícitas. ejecutar proyecto stdin argumentos timeout entorno javascript typescript python go rust ruby lua  lingua run  convierte un archivo o un directorio de proyecto convencional en un comando predecible. Lingua selecciona un runtime instalado, lo inicia sin shell, limita la salida y controla el timeout.\n\n   Ejecuta un archivo\n\n   bash\nlingua run ./hello.js\nlingua run ./analysis.py\nlingua run ./hello.go\nlingua run ./hello.rs --timeout 60000\n   \n\nJavaScript y TypeScript usan Node.js. Python, Go, Rust, Ruby y Lua usan sus toolchains de terminal. Si falta un runtime, Lingua termina con código 3 e indica la capacidad ausente.\n\n   Pasa stdin sin un pipe frágil\n\nUsa  --stdin  cuando la entrada ya está en un archivo:\n\n   bash\nlingua run ./normalize.py --stdin fixtures/raw.txt\n   \n\nTambién funciona un pipe normal:\n\n   bash\nprintf 'Ada\\nGrace\\n' | lingua run ./greet.js\n   \n\nUna terminal interactiva envía EOF cuando no existe un pipe, así que un programa que lee stdin no queda esperando una entrada invisible.\n\n   Pasa argumentos a tu programa\n\nColoca las opciones de Lingua antes de  -- . Cada token posterior llega al programa sin cambios:\n\n   bash\nlingua run ./scripts/check.ts --timeout 45000 -- --verbose --fix src\n   \n\nEste es el workaround cuando tu programa también tiene una opción  --json  o  --quiet .\n\n   Agrega variables de entorno explícitas\n\n   bash\nlingua run ./worker.py \\\n  --env MODE=development \\\n  --env FEATURE X=enabled\n   \n\nPuedes repetir  --env . Lingua no hereda ciegamente todas las variables del proceso padre y bloquea claves de inyección del loader y  NODE OPTIONS . Pasa secretos solo cuando sean indispensables; el historial del shell y los logs de CI pueden exponer argumentos.\n\n   Ejecuta un proyecto convencional\n\n   bash\nlingua run ./my-project\n   \n\nLa detección sigue un orden fijo:\n\n1.  package.json :  scripts.start , luego  scripts.dev  y después un  main  válido.\n2.  go.mod :  go run . .\n3.  Cargo.toml :  cargo run --quiet -- .\n4. Entradas convencionales como  main.py ,  index.js  o  src/index.ts .\n\nSi un framework necesita un launcher especial, ejecútalo directamente o apunta Lingua a un archivo que funcione de manera independiente. Lingua no adivina comandos específicos de frameworks.\n\n   Automatiza de forma determinista\n\nUsa  --json  cuando otro programa consuma el resultado y revisa el código de salida:\n\n   bash\nif result=$ lingua run ./healthcheck.ts --json ; then\n  printf '%s\\n' \"$result\" | jq -r '.run.stdout'\nelse\n  printf '%s\\n' \"$result\" | jq -r '.reason'  &2\nfi\n   \n\nEl modo normal transmite la salida mientras corre el programa. El modo JSON guarda la misma salida limitada dentro de un solo documento válido. "},{"href":"/es/cli/utilities","title":"Conecta utilidades en pipes","description":"Descubre utilidades, transforma stdin o archivos, pasa opciones y mantén predecibles tus pipelines de shell.","group":"guides","searchText":"Conecta utilidades en pipes Descubre utilidades, transforma stdin o archivos, pasa opciones y mantén predecibles tus pipelines de shell. utilidad pipe entrada opción json-format base64 regex listar utilidades  lingua utility  lleva transformaciones enfocadas a la terminal. Los adaptadores se comparten con los paneles de utilidades de Lingua, pero el CLI mantiene un contrato textual apropiado para automatización.\n\n   Descubre antes de adivinar\n\n   bash\nlingua list utilities\nlingua list utilities --json | jq '.utilities   |  id, options '\n   \n\nEl registro JSON es la forma más segura de descubrir ids, tipos de entrada/salida y opciones aceptadas.\n\n   Lee desde stdin\n\n   bash\necho ' \"team\": \"Ada\",\"Grace\"  ' | lingua utility json-format\nprintf 'hello world' | lingua utility base64-encode\n   \n\nStdin permite conectar utilidades naturalmente con  curl ,  git ,  jq  y otros programas.\n\n   Lee un archivo\n\n   bash\nlingua utility json-format --input package.json --option indent=4\nlingua utility base64-encode --input README.md\n   \n\n --input  solo pertenece a  utility . Para el stdin de un programa ejecutado, usa  lingua run --stdin .\n\n   Repite opciones del adaptador\n\n   bash\nlingua utility regex-replace --input src.ts \\\n  --option pattern='console\\\\.log' \\\n  --option flags=g \\\n  --option replacement=logger.info\n   \n\nCada  --option  acepta un par  key=value . Usa comillas cuando el valor contenga espacios o caracteres especiales del shell.\n\n   Mantén limpios tus pipelines\n\n --quiet  elimina los diagnósticos de Lingua, pero conserva la salida correcta:\n\n   bash\nlingua utility json-format --input raw.json --quiet   normalized.json\n   \n\nUsa  --json  para recibir un envelope estructurado de Lingua, no cuando necesites directamente los bytes transformados:\n\n   bash\nlingua utility json-format --input raw.json --json | jq -r '.value'\n   \n\nLa salida binaria no forma parte de este contrato headless textual. Lingua termina con código 3 en vez de corromper el flujo de la terminal.\n\nPara ver ejemplos con opciones sobre APIs, JWTs, hashes, Unicode,\nidentificadores, cron, reemplazos de código y más, continúa con  Recetas\nprácticas para el desarrollo diario  /es/cli/recipes . "},{"href":"/es/cli/capsules","title":"Valida y repite Run Capsules","description":"Revisa una RunCapsuleV1, repite capturas confiables de una sola fuente y entiende los límites de integridad y Workspace.","group":"guides","searchText":"Valida y repite Run Capsules Revisa una RunCapsuleV1, repite capturas confiables de una sola fuente y entiende los límites de integridad y Workspace. capsule validar repetir RunCapsuleV1 hash comparación workspace confianza Las Run Capsules conservan un buffer de código, entrada, argumentos, metadatos de entorno y salida registrada. El CLI puede validar ese contrato o repetir su única fuente con un runtime local.\n\n   De la app a la CLI\n\nEjecuta código en Lingua y abre   Configuración → Cuenta → Cápsulas de\nejecución  . Elige   Guardar JSON para CLI  . La app de escritorio usa un diálogo\nlocal para guardar; el navegador descarga el mismo JSON  RunCapsuleV1  saneado. El nombre\nsugerido es  lingua-run.capsule.json . También puedes importar el JSON en\nLingua para previsualizarlo sin ejecutarlo.\n\nEn una terminal abierta en la carpeta del archivo, valida primero:\n\n   bash\nlingua capsule validate \"lingua-run.capsule.json\" --json\n   \n\nRevisa el código en el JSON y usa el comando de replay por separado solo si\nconfías en él. Replay ejecuta código con tus permisos del sistema:\n\n   bash\nlingua capsule replay \"lingua-run.capsule.json\" --json\n   \n\nLa app ofrece botones independientes para copiar los comandos; copiarlos no\nejecuta ninguno. Cambia la ruta entre comillas si elegiste otro nombre o carpeta.\n\n   Valida sin ejecutar\n\n   bash\nlingua capsule validate ./run.capsule.json\nlingua capsule validate ./run.capsule.json --json\n   \n\nLa validación revisa el límite de 4 MiB, la sintaxis JSON, la versión del esquema, las migraciones, los campos obligatorios y sus tipos. Nunca ejecuta el código guardado.\n\nÚsala como gate de carga o build:\n\n   bash\nfor capsule in build/ .capsule.json; do\n  lingua capsule validate \"$capsule\" --quiet || exit 1\ndone\n   \n\n   Repite una fuente confiable\n\n   bash\nlingua capsule replay ./run.capsule.json\nlingua capsule replay ./run.capsule.json --timeout 60000 --json\n   \n\nReplay verifica primero que  source.content  coincida con su hash SHA-256. Después ejecuta el código y compara estado, stdout y stderr con el resultado registrado.\n\nUn comando correcto todavía puede devolver  comparison.matches: false . Eso es evidencia útil de reproducibilidad, no un error del runtime.\n\n   Conoce el límite de confianza\n\nEl hash detecta inconsistencias accidentales.   No es una firma  : quien edita el archivo también puede reemplazar el código y recalcular el hash. Repite únicamente Capsules de fuentes confiables porque el código recibe tus permisos del sistema operativo.\n\nLas Capsules de preview del navegador no se pueden repetir en un proceso headless. Un runtime ausente termina con código 3 en vez de sustituir silenciosamente el modo de ejecución.\n\n   Workaround para Capsule Workspace\n\n CapsuleWorkspaceV1  puede transportar archivos de texto adicionales seleccionados explícitamente para revisarlos en la app. El CLI no reconstruye ni repite ese wrapper multiarchivo.\n\n- Si la Capsule anidada funciona por sí sola, extrae y repite esa única fuente.\n- Si depende de archivos vecinos, usa  lingua run  directorio-del-proyecto   sobre el proyecto real. "},{"href":"/es/cli/recipes","title":"Recetas prácticas para el desarrollo diario","description":"Copia patrones del CLI de Lingua para APIs, datos, scripts locales, hooks de Git, CI, contenedores, Capsules, Bash y PowerShell.","group":"guides","searchText":"Recetas prácticas para el desarrollo diario Copia patrones del CLI de Lingua para APIs, datos, scripts locales, hooks de Git, CI, contenedores, Capsules, Bash y PowerShell. recetas ejemplos api curl jq hook git github actions npm scripts makefile docker powershell ci Estas recetas resuelven tareas pequeñas y frecuentes con comandos que puedes copiar y adaptar. Asumen que  lingua --version  funciona y que confías en cada archivo o programa que vas a ejecutar.\n\n   Elige una receta según el resultado\n\n| Necesitas… | Receta |\n| --- | --- |\n| inspeccionar la respuesta de una API |  Formatea JSON desde curl   formatea-json-desde-curl  |\n| revisar un token sin subirlo a internet |  Lee el header y payload de un JWT   lee-el-header-y-payload-de-un-jwt  |\n| construir una consulta URL segura |  Codifica un componente de URL   codifica-un-componente-de-url  |\n| normalizar archivos generados |  Protege el formato JSON con un hook de Git   protege-el-formato-json-con-un-hook-de-git  |\n| ejecutar una revisión del repositorio |  Expón Lingua mediante package.json   expón-lingua-mediante-packagejson  |\n| agregar un gate de CI |  Fija el CLI en GitHub Actions   fija-el-cli-en-github-actions  |\n| reproducir una ejecución capturada |  Exige una repetición exacta de una Capsule   exige-una-repetición-exacta-de-una-capsule  |\n| usar Lingua desde Windows |  Conserva el código de salida en PowerShell   conserva-el-código-de-salida-en-powershell  |\n\n   Trabaja con APIs y datos web\n\n    Formatea JSON desde curl\n\nMantén el JSON transformado en stdout para poder pasarlo a  jq :\n\n   bash\ncurl -fsSL https://api.github.com/repos/johnny4young/lingua \\\n  | lingua utility json-format --quiet \\\n  | jq ' name, stargazers count, open issues count '\n   \n\n curl -f  hace fallar el pipe ante un error HTTP. En jobs de CI con Bash, agrega  set -o pipefail  para que un comando posterior no oculte una falla anterior.\n\n    Minifica un artefacto JSON de release\n\n   bash\nlingua utility json-minify --input config/runtime.json --quiet \\\n    dist/runtime.min.json\n   \n\nEl comando analiza el JSON antes de escribir. Una entrada inválida falla en vez de producir un artefacto transformado parcialmente.\n\n    Lee el header y payload de un JWT\n\n   bash\nprintf '%s' \"$ACCESS TOKEN\" \\\n  | lingua utility jwt-decode --quiet \\\n  | jq ' algorithm: .header.alg, subject: .payload.sub, expires: .payload.exp '\n   \n\nEsto solo decodifica texto local.   No   verifica la firma, el issuer, la audience, la expiración ni la autorización. Nunca trates los claims decodificados como una identidad confiable.\n\n    Codifica un componente de URL\n\n   bash\nquery=$ printf '%s' 'state:open label:\"good first issue\"' \\\n  | lingua utility url-encode --quiet \n\ncurl -fsSL \"https://api.github.com/search/issues?q=$ query \" | jq '.total count'\n   \n\n url-encode  sirve para un componente, como el valor de una consulta, no para volver a codificar una URL completa.\n\n    Separa una URL absoluta en campos\n\n   bash\nprintf '%s' 'https://example.com:8443/api/items?limit=20 results' \\\n  | lingua utility url-parse --quiet \\\n  | jq ' origin, pathname, searchParams '\n   \n\n url-parse  rechaza deliberadamente las URLs relativas. Resuelve primero una ruta relativa contra su base.\n\n    Codifica o decodifica texto en Base64\n\n   bash\nencoded=$ printf '%s' 'valor local de desarrollo' | lingua utility base64-encode --quiet \nprintf '%s' \"$encoded\" | lingua utility base64-decode --quiet\n   \n\nEl contrato del CLI es texto UTF-8. Base64 es una codificación, no cifrado, y esta receta no está pensada para archivos binarios arbitrarios ni secretos.\n\n    Escapa un snippet como texto HTML\n\n   bash\nprintf '%s' ' button data-id=\"42\" Ejecutar & revisar /button ' \\\n  | lingua utility html-entity-encode --quiet\n   \n\nEsto escapa contenido textual. No sanitiza un documento HTML ni vuelve seguro ejecutar markup no confiable.\n\n   Normaliza texto y datos de desarrollo\n\n    Calcula el digest de un texto\n\n   bash\ndigest=$ lingua utility hash \\\n  --input release-notes.md \\\n  --option algorithm=SHA-256 \\\n  --quiet \nprintf 'release-notes.md  %s\\n' \"$digest\"\n   \n\nEl digest cubre el texto UTF-8 leído por el CLI. Usa una herramienta de checksum del sistema cuando necesites procesar byte por byte un archivo binario arbitrario.\n\n    Ordena y elimina rutas duplicadas\n\n   bash\ngit diff --name-only origin/main...HEAD \\\n  | lingua utility line-sort \\\n      --option unique=true \\\n      --option caseInsensitive=true \\\n      --quiet\n   \n\nAgrega  --option numeric=true  cuando valores como  fixture2  y  fixture10  deban usar orden natural.\n\n    Produce nombres con un estilo estable\n\n   bash\nprintf '%s' 'HTTP response cache key' \\\n  | lingua utility string-case --option target=snake --quiet\n\nprintf '%s' 'Guía rápida para equipos' \\\n  | lingua utility slugify --option separator=hyphen --quiet\n   \n\nUsa  string-case  para nombres de código   camel ,  snake ,  kebab  y otros . Usa  slugify  para un segmento ASCII de URL o nombre de archivo.\n\n    Reemplaza un patrón repetido en código\n\n   bash\nlingua utility regex-replace \\\n  --input src/legacy.ts \\\n  --option pattern='console\\\\.log' \\\n  --option flags=g \\\n  --option replacement=logger.info \\\n  --quiet   /tmp/legacy.updated.ts\n\ndiff -u src/legacy.ts /tmp/legacy.updated.ts\n   \n\nRevisa el diff antes de reemplazar el archivo original. Pon el patrón entre comillas para que el shell no interprete backslashes ni metacaracteres.\n\n    Inspecciona Unicode sospechoso\n\n   bash\ngit log -1 --pretty=%B | lingua utility string-inspect --quiet\n   \n\nEl resultado distingue grafemas, code points, unidades UTF-16, bytes UTF-8, caracteres de ancho cero y controles bidireccionales. Es útil cuando dos strings se ven iguales, pero se comparan de forma diferente.\n\n    Convierte un timestamp durante un incidente\n\n   bash\nprintf '%s' '1735689600' | lingua utility timestamp --quiet\n   \n\nEl resultado incluye ISO 8601, epoch en milisegundos y epoch en segundos. Registra aparte la zona horaria original cuando importe: un Unix epoch representa un instante, no la zona del autor.\n\n    Convierte un entero sin perder precisión\n\n   bash\nprintf '%s' '9007199254740993' \\\n  | lingua utility number-base \\\n      --option from=10 \\\n      --option to=16 \\\n      --option prefixOutput=true \\\n      --quiet\n   \n\nEl conversor usa aritmética de enteros, no punto flotante. Los valores superiores al límite seguro de JavaScript permanecen exactos.\n\n    Genera identificadores para pruebas\n\n   bash\nprintf 'generator-input-is-ignored' \\\n  | lingua utility uuid \\\n      --option format=v7 \\\n      --option count=5 \\\n      --quiet\n   \n\n uuid  es un generador: recibe stdin porque todas las utilidades comparten un contrato de entrada textual, pero lo ignora deliberadamente. Los valores generados no son snapshots deterministas.\n\n    Traduce un horario a cron\n\n   bash\nprintf '%s' 'weekdays at 9:30' \\\n  | lingua utility cron-phrase --option annotate=true --quiet\n   \n\nMantén  annotate=true  durante la revisión: los comentarios adicionales muestran supuestos y advertencias de cron. Prueba la expresión final en la zona horaria y la implementación de cron que la ejecutarán.\n\n    Inspecciona un color del sistema de diseño\n\n   bash\nprintf '%s' 'rgba 14, 165, 233, 0.75 ' \\\n  | lingua utility color-convert --quiet\n   \n\nLa salida presenta formas equivalentes HEX, RGB/RGBA y HSL para compararlas rápidamente.\n\n   Ejecuta herramientas del repositorio de forma consistente\n\n    Pasa un fixture como stdin\n\n   bash\nlingua run ./scripts/normalize.py \\\n  --stdin ./fixtures/raw-event.json \\\n  --timeout 45000\n   \n\nUsa  --stdin  cuando la entrada ya tenga una ruta. Evita un pipe frágil y deja visible el fixture en la invocación.\n\n    Envía argumentos al programa\n\n   bash\nlingua run ./scripts/check.ts \\\n  --timeout 60000 \\\n  -- --changed-only --format=json\n   \n\nTodo lo que está después de  --  pertenece a  check.ts . Lingua no analiza ni reordena esos tokens.\n\n    Ejecuta la raíz de un proyecto convencional\n\n   bash\nlingua run ./tools/release-audit --timeout 120000\n   \n\nLa detección de directorios admite  package.json ,  go.mod ,  Cargo.toml  y entry points comunes. Ejecuta directamente el comando del framework cuando un repositorio necesite orquestación personalizada o un servidor permanente.\n\n    Expón Lingua mediante package.json\n\nFija el CLI en  devDependencies  y ofrece al equipo un script fácil de recordar:\n\n   json\n \n  \"devDependencies\":  \n    \"@linguacode/cli\": \"1.5.1\"\n   ,\n  \"scripts\":  \n    \"check:local\": \"lingua run ./scripts/check.ts --timeout 60000 -- --changed-only\",\n    \"check:capsules\": \"lingua capsule validate ./artifacts/latest.capsule.json --quiet\"\n   \n \n   \n\n   bash\nnpm run check:local\n   \n\nIncluye el lockfile en Git. Actualiza la versión fijada únicamente después de pasar las mismas verificaciones en tu repositorio.\n\n    Agrega un target de Make\n\n   make\n.PHONY: verify-fixtures\nverify-fixtures:\n\tlingua run ./scripts/verify-fixtures.py --stdin ./fixtures/events.ndjson --timeout 90000\n   \n\nLa línea de la receta debe comenzar con un tab. Make conserva el código de salida de Lingua, por lo que una ejecución fallida hace fallar el target.\n\n    Protege el formato JSON con un hook de Git\n\nUsa un archivo temporal en vez de reescribir automáticamente el archivo staged:\n\n   bash\n !/usr/bin/env bash\nset -euo pipefail\n\ntmp=$ mktemp \ntrap 'rm -f \"$tmp\"' EXIT\n\nlingua utility json-format --input config/app.json --option indent=2 --quiet   \"$tmp\"\nif ! cmp -s config/app.json \"$tmp\"; then\n  echo 'config/app.json no tiene el formato canónico'  &2\n  diff -u config/app.json \"$tmp\" || true\n  exit 1\nfi\n   \n\nInstálalo con el gestor de hooks que ya utilice el repositorio. Los hooks pueden omitirse, así que conserva el mismo invariante en CI.\n\n   Integra Lingua en automatización\n\n    Fija el CLI en GitHub Actions\n\n   yaml\nname: CLI checks\non:  pull request \n\njobs:\n  verify:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 24\n          cache: npm\n      - run: npm ci\n      - run: npx --no-install lingua run ./scripts/check.ts --json\n      - run: npx --no-install lingua capsule validate ./artifacts/example.capsule.json --quiet\n   \n\nEsto asume que  @linguacode/cli  está fijado en el repositorio y el lockfile, como en la receta de  package.json . Instala explícitamente cada toolchain cuando el objetivo no sea JavaScript o TypeScript.\n\n    Conserva la salida estructurada y el código de salida\n\n   bash\n !/usr/bin/env bash\nset -uo pipefail\n\nresult=$ lingua run ./scripts/healthcheck.ts --json \nstatus=$?\n\nprintf '%s\\n' \"$result\" | jq .\nif    status != 0   ; then\n  printf 'Lingua falló con código %d\\n' \"$status\"  &2\nfi\nexit \"$status\"\n   \n\nNo agregues  || true  a un gate salvo que la falla sea deliberadamente informativa. El JSON explica la falla; el código de salida decide si la automatización continúa.\n\n    Ofrece recuperación de runtime sin analizar texto humano\n\n   bash\nresult=$ lingua run ./worker.py --json \nstatus=$?\n\nif    status == 3   ; then\n  printf '%s\\n' \"$result\" | jq ' reason, recovery '  &2\nfi\nexit \"$status\"\n   \n\nEl código 3 indica que una capacidad no está disponible. El objeto  recovery  puede incluir runtime, ejecutable, comando o guía de instalación y comando de verificación.\n\n    Valida todos los artefactos Capsule\n\n   bash\n !/usr/bin/env bash\nset -euo pipefail\n\nwhile IFS= read -r -d '' capsule; do\n  lingua capsule validate \"$capsule\" --quiet\ndone     find artifacts -name ' .capsule.json' -type f -print0 \n   \n\nEsto valida estructura y límites sin ejecutar el código guardado.  -print0  mantiene como un solo elemento los nombres que contienen espacios;  set -e  se detiene ante el primer artefacto inválido.\n\n    Exige una repetición exacta de una Capsule\n\n   bash\nlingua capsule replay ./artifacts/release-check.capsule.json \\\n  --timeout 60000 \\\n  --json \\\n  | jq -e '.ok == true and .comparison.matches == true'\n   \n\nReplay puede terminar con código 0 cuando el programa se ejecutó correctamente, pero produjo algo diferente del resultado registrado.  jq -e  convierte la comparación exacta en una política explícita de CI. Repite únicamente Capsules confiables.\n\n    Construye una imagen pequeña de contenedor\n\n   dockerfile\nFROM node:24-bookworm-slim\n\nRUN npm install --global @linguacode/cli@1.5.1\nWORKDIR /workspace\nENTRYPOINT  \"lingua\" \nCMD  \"--help\" \n   \n\n   bash\ndocker build -t local/lingua-cli .\ndocker run --rm -i local/lingua-cli utility json-format --quiet \\\n    fixtures/payload.json\n   \n\nMonta código confiable y el toolchain necesario cuando uses  lingua run . El contenedor es el límite de aislamiento; Lingua no es por sí mismo un sandbox del sistema operativo.\n\n   Usa patrones nativos de cada shell\n\n    Configura autocompletado en una estación de trabajo\n\n   bash\nlingua completion --dry-run\nlingua completion\n   \n\nEl primer comando muestra cada shell detectado y archivo de destino. El segundo pide confirmación una sola vez. Las instalaciones de Homebrew ubican automáticamente los archivos de Bash, Zsh y Fish.\n\n    Conserva el código de salida en PowerShell\n\n   powershell\n$result = lingua run .\\scripts\\check.ts --json | ConvertFrom-Json\n$status = $LASTEXITCODE\n\n$result | ConvertTo-Json -Depth 8\nif  $status -ne 0   \n  Write-Error \"Lingua falló con código $status\"\n \nexit $status\n   \n\nCaptura  $LASTEXITCODE  inmediatamente después de  lingua ; otro comando nativo puede reemplazarlo.\n\n    Formatea un archivo en PowerShell\n\n   powershell\nGet-Content .\\config\\app.json -Raw |\n  lingua utility json-format --option indent=4 --quiet |\n  Set-Content .\\config\\app.formatted.json -Encoding utf8\n\nif  $LASTEXITCODE -ne 0    exit $LASTEXITCODE  \n   \n\nEscribe primero en un segundo archivo. Revísalo o compáralo antes de reemplazar el original.\n\n   Descubre qué admite tu versión instalada\n\nEl registro instalado es la fuente de verdad cuando un script debe funcionar con diferentes versiones del CLI:\n\n   bash\nlingua list utilities --json \\\n  | jq -r '.utilities   |  .id,  .optionKeys | join \",\"    | @tsv'\n\nlingua --help\nlingua utility --help\nlingua run --help\n   \n\nPrefiere descubrir las opciones en vez de adivinarlas. Para automatización estable, fija la versión del CLI e incluye el lockfile o la metadata inmutable del instalador. "},{"href":"/es/cli/automation","title":"Automatiza con salida estable","description":"Usa envelopes JSON, modo quiet, códigos, completions y ejecución limitada para crear scripts y jobs de CI confiables.","group":"automation","searchText":"Automatiza con salida estable Usa envelopes JSON, modo quiet, códigos, completions y ejecución limitada para crear scripts y jobs de CI confiables. ci automatización json quiet código de salida completion bash zsh fish sin color El CLI separa los datos en stdout de los diagnósticos humanos en stderr. Los códigos estables,  --json  y la ejecución limitada lo convierten en un bloque confiable para CI.\n\n   Elige texto o JSON deliberadamente\n\nEl modo normal funciona mejor cuando la salida de Lingua será la entrada del siguiente programa:\n\n   bash\nlingua utility json-format --input raw.json --quiet   normalized.json\n   \n\nEl modo JSON funciona mejor cuando un script necesita estado y metadatos:\n\n   bash\nresult=$ lingua run ./check.ts --json  || status=$?\nprintf '%s\\n' \"$result\" | jq .\nexit \"$ status:-0 \"\n   \n\nLa salida estructurada nunca contiene secuencias ANSI, incluso con  --color=always .\n\n   Usa las familias de códigos de salida\n\n| Código | Significado | Respuesta típica |\n| --- | --- | --- |\n| 0 | correcto | continúa |\n| 1 | argumentos o entrada inválidos | corrige la invocación o artefacto |\n| 2 | error del runtime o timeout | revisa la salida del programa |\n| 3 | capacidad ausente o no compatible | instala o elige un runtime |\n| 4 | error interno inesperado | conserva diagnósticos y repórtalo |\n\n   Evita jobs bloqueados\n\n   bash\nlingua run ./integration-check.py --timeout 90000 --json\n   \n\nEl rango permitido es 100–300000 ms y el valor predeterminado es 30000 ms. El timeout y Ctrl+C terminan el árbol de procesos.\n\n   Instala autocompletado\n\nHomebrew instala automáticamente los archivos de Bash, Zsh y Fish. Con los\ndemás canales, permite que Lingua detecte los shells compatibles en  PATH ,\nmuestre cada archivo de destino y pida confirmación una sola vez:\n\n   bash\nlingua completion\nlingua completion --dry-run\nlingua completion install --yes   aprobación no interactiva explícita\n   \n\nEl instalador marca el shell actual, configura los directorios estándar de\nusuario para Bash y Fish, y mantiene un único bloque delimitado en  .zshrc \npara Zsh. Desde CI o un pipe no escribe nada sin  --yes .\n\nTambién puedes generar manualmente un script determinista:\n\n   bash\nlingua completion bash\nlingua completion zsh\nlingua completion fish\n   \n\nLa generación es determinista y no usa red, por lo que un script de instalación puede ejecutarla sin contactar servicios.\n\nConsulta  Recetas prácticas para el desarrollo diario  /es/cli/recipes  para\nver patrones completos de GitHub Actions, hooks de Git, scripts de paquete,\nMake, Docker, Bash y PowerShell. "},{"href":"/es/cli/ai-agents","title":"Verifica código generado por IA con un agente","description":"Instala la skill portable de Lingua y convierte ejecuciones locales, validaciones de Capsules y utilidades en evidencia estructurada y honesta.","group":"automation","searchText":"Verifica código generado por IA con un agente Instala la skill portable de Lingua y convierte ejecuciones locales, validaciones de Capsules y utilidades en evidencia estructurada y honesta. agente agentes ia verificación codex claude code copilot skill plugin json evidencia mcp Lingua ya ofrece la parte importante para los agentes que pueden usar una terminal: un CLI local\ncon JSON estable, códigos de salida deterministas, output acotado y fallos de runtime explícitos.\nLa skill portable  lingua-verify  enseña al agente a usar ese contrato en lugar de adivinar si el\ncódigo generado funcionó.\n\nLa integración contiene solo instrucciones. No agrega servicios en segundo plano, servidores MCP,\nhooks, credenciales ni instaladores automáticos.\n\n   Verifica los prerrequisitos\n\nLa skill contiene instrucciones, no el CLI ni los runtimes de cada lenguaje. Necesitas:\n\n- un cliente de agentes que pueda ejecutar comandos locales de terminal;\n- acceso HTTPS a GitHub mientras instalas la skill;\n- Lingua CLI 1.3.0 o posterior en  PATH ;\n- el runtime de línea de comandos utilizado por el código que vas a ejecutar.\n\n| Cliente                  | Requisitos de instalación                                                              |\n| ------------------------ | -------------------------------------------------------------------------------------- |\n| VS Code + GitHub Copilot | VS Code actualizado, acceso a Copilot, Git y  chat.plugins.enabled: true               |\n| Codex                    |  $skill-installer  incluido, acceso de red a GitHub y una carpeta de skills escribible |\n| Claude Code              | Claude Code actualizado con  claude plugin , Git y acceso HTTPS a GitHub               |\n\n   Instala primero el CLI\n\nEn macOS, Homebrew instala el CLI y Node.js 24:\n\n   bash\nbrew install johnny4young/tap/lingua-cli\nlingua --version\n   \n\nEn Windows, Linux o macOS con Node.js 24 y npm:\n\n   bash\nnpm install -g @linguacode/cli\nlingua --version\n   \n\nLa fórmula de Homebrew instala Node.js 24. La opción npm requiere Node.js 24.x, npm y una ubicación\nglobal escribible cuyo directorio de binarios esté en  PATH . No uses un  sudo npm install  sin\nrevisar para ocultar un problema de permisos; corrige el prefijo de npm o usa una instalación de\nNode limitada a tu usuario.\n\nLos archivos independientes para Windows x64 y Linux x64 pueden ejecutar utilidades y validar\nCapsules sin una instalación separada de Node. Ejecutar o reproducir JavaScript o TypeScript todavía\nrequiere Node.js 24 en  PATH . La skill requiere Lingua CLI 1.3.0 o posterior, comprueba la versión y\nnunca instala software por ti.\n\nLa ejecución también necesita el runtime del objetivo:\n\n| Objetivo                | Runtime en  PATH                                           |\n| ----------------------- | ---------------------------------------------------------- |\n| JavaScript / TypeScript | Node.js 24.x                                               |\n| Python                  |  .venv  del proyecto,  PYTHON ,  python3 ,  python  o  py  |\n| Go                      |  go                                                        |\n| Archivo/proyecto Rust   |  rustc  /  cargo                                           |\n| Ruby                    |  ruby                                                      |\n| Lua                     |  lua                                                       |\n\n   Instala la Agent Skill\n\n    VS Code y GitHub Copilot\n\nEjecuta   Chat: Install Plugin From Source   desde la paleta de comandos e ingresa:\n\n   text\nhttps://github.com/johnny4young/lingua\n   \n\nRevisa el repositorio y confirma que confías en él antes de activar el plugin. VS Code descubre el\n plugin.json  de la raíz y el directorio  skills/lingua-verify . Si el comando no aparece, actualiza\nVS Code, confirma tu acceso a GitHub Copilot y activa  chat.plugins.enabled .\n\n    Codex\n\nInvoca el instalador de skills incluido y pídele instalar el directorio público:\n\n   text\n$skill-installer\nInstala skills/lingua-verify desde https://github.com/johnny4young/lingua\n   \n\nLa skill instalada queda disponible en el siguiente turno de Codex. Después menciona\n $lingua-verify  o pídele a Codex verificar un script local confiable con Lingua.\n\n    Claude Code\n\nAgrega el marketplace de Lingua e instala el plugin nativo. Los comandos son iguales en terminales\nde macOS, Linux y Windows:\n\n   bash\nclaude plugin marketplace add https://raw.githubusercontent.com/johnny4young/lingua/main/.claude-plugin/marketplace.json --scope user\nclaude plugin install lingua@linguacode --scope user\n   \n\nDespués de instalarlo desde una terminal, inicia una sesión nueva de Claude Code o ejecuta\n /reload-plugins  dentro de la sesión actual. Invoca la skill con namespace como\n /lingua:lingua-verify  o describe una tarea de verificación que coincida. Claude administra el\ncaché, las actualizaciones y la desinstalación:\n\n   bash\nclaude plugin update lingua@linguacode\nclaude plugin uninstall lingua@linguacode\n   \n\nPara probar el plugin desde un checkout local, sin instalarlo ni cambiar tu configuración personal:\n\n   bash\nclaude --plugin-dir ./skills\n   \n\nDespués invoca  /lingua:lingua-verify . El marketplace público resuelve la rama predeterminada del\nrepositorio, así que no permite instalar la cabecera de un pull request hasta que se integre. Si un\nentorno administrado bloquea marketplaces de terceros, un administrador puede revisar y copiar\n skills/lingua-verify  al directorio de skills de Claude aprobado; esa alternativa pierde el ciclo\nnativo de actualización y desinstalación.\n\n   Dale al agente una tarea acotada\n\nLos mejores prompts nombran el objetivo confiable y la evidencia que quieres:\n\n   text\nUsa Lingua para ejecutar ./scripts/normalize.ts con --check como argumento del programa.\nReporta el runtime exacto, código de salida, stdout, stderr, duración y cualquier truncamiento.\n   \n\n   text\nValida ./artifacts/run.capsule.json sin ejecutarlo. Si es válido, detente antes del replay.\n   \n\n   text\nUsa la utilidad json-format de Lingua sobre ./fixtures/payload.json y reporta los fallos estructurados.\n   \n\nLa skill elige el comando más limitado:\n\n| Objetivo                                 | Comando                                        |\n| ---------------------------------------- | ---------------------------------------------- |\n| Ejecutar un archivo o proyecto confiable |  lingua run  objetivo  --json                  |\n| Validar sin ejecutar                     |  lingua capsule validate  archivo  --json      |\n| Reproducir una captura confiable         |  lingua capsule replay  archivo  --json        |\n| Descubrir transformaciones               |  lingua list utilities --json                  |\n| Aplicar una transformación               |  lingua utility  id  --input  archivo  --json  |\n\nNo reemplaza los gates de lint, tipos o pruebas del repositorio.\n\n   Lee la evidencia, no solo el código de salida\n\nEl agente comprueba el código de salida y el cuerpo JSON:\n\n| Salida | Significado                                                                                 |\n| ------ | ------------------------------------------------------------------------------------------- |\n|  0     | El comando terminó; revisa el resultado estructurado antes de afirmar que quedó verificado. |\n|  1     | Argumentos o entrada inválidos.                                                             |\n|  2     | Fallo del runtime, timeout, detención o salida distinta de cero.                            |\n|  3     | Capacidad no compatible o runtime ausente.                                                  |\n|  4     | Fallo interno no clasificado.                                                               |\n\nUn replay puede terminar correctamente mientras  comparison.matches  sea  false . Eso es una\ndivergencia reproducible del output, no una coincidencia.\n\n   Mantén explícito el límite de ejecución\n\n lingua run  y  lingua capsule replay  se ejecutan con los permisos de tu usuario del sistema\noperativo. Lingua evita interpolar mediante shell, filtra variables heredadas, limita el output y\ncontrola el timeout, pero no es un sandbox del sistema operativo.\n\n- Ejecuta solo un objetivo confiable dentro del workspace activo.\n- No permitas que un agente instale Lingua o un runtime ausente silenciosamente.\n- No envíes secretos mediante  --env .\n- Prefiere validar una Capsule cuando no sea necesario ejecutar.\n- Coloca el código no confiable en un sandbox o contenedor bajo tu control.\n\n   Por qué no es otro servidor MCP\n\nEl CLI ya es el camino más corto para agentes de código con acceso a una terminal. La skill agrega\nconocimiento del workflow y evidencia honesta sin crear otro proceso ni ampliar permisos. El MCP\nlocal existente en Lingua Desktop sigue siendo la opción de solo lectura para exponer un proyecto\naprobado explícitamente a un cliente MCP de confianza.\n\nUn futuro adaptador MCP por stdio solo debería existir si el descubrimiento estructurado de\nherramientas resulta más útil que este camino basado en el CLI. Exponer ejecución también exigiría\nun diseño de permisos separado. "},{"href":"/es/cli/troubleshooting","title":"Resuelve problemas del CLI","description":"Corrige command-not-found, toolchains ausentes, timeouts, argumentos, Capsules, color y salida sin ocultar fallas.","group":"automation","searchText":"Resuelve problemas del CLI Corrige command-not-found, toolchains ausentes, timeouts, argumentos, Capsules, color y salida sin ocultar fallas. problemas PATH comando no encontrado runtime ausente timeout argumentos inválidos color salida Empieza por el código de salida exacto y el motivo estable dentro de  error ...   o del envelope JSON. Así puedes distinguir una entrada inválida, un error de ejecución y una capacidad ausente.\n\n   No se encuentra el comando lingua\n\nSi trabajas desde el código fuente, compila y enlaza desde la raíz:\n\n   bash\npnpm run build:cli\npnpm link --global\ncommand -v lingua\nlingua --version\n   \n\nSi  pnpm link --global  funciona pero el shell no encuentra el comando, revisa  pnpm bin --global  y agrega ese directorio al  PATH . Reinicia el shell después de modificar su perfil.\n\n   Falta un runtime\n\nLingua ahora muestra el nombre del runtime, una acción de instalación para tu\nplataforma, un comando de verificación y esta guía cuando  lingua run  no\nencuentra un toolchain. En macOS puedes corregirlo directamente con:\n\n   bash\nbrew install python    Python\nbrew install go        Go\nbrew install rust      Rust y Cargo\nbrew install ruby      Ruby\nbrew install lua       Lua\n   \n\nConfirma que el mismo shell encuentre el toolchain:\n\n   bash\nnode --version\npython3 --version\ngo version\nrustc --version\nruby --version\nlua -v\n   \n\nUna app de escritorio y un login shell pueden heredar valores PATH diferentes. El CLI usa el entorno de la terminal que lo inició, así que valida desde esa terminal exacta.\n\nEn modo  --json , revisa  run.recovery   también disponible como  recovery  en\nel nivel superior  para obtener  runtime ,  executable ,  installCommand \nopcional,  installGuide  y  verifyCommand  sin analizar el texto humano.\n\n   Lingua rechaza una opción de mi programa\n\nSepara los dos dominios de argumentos:\n\n   bash\nlingua run ./server.ts --timeout 60000 -- --json --port 4000\n   \n\nAntes de  -- , las opciones pertenecen a Lingua. Después, cada token pertenece a tu programa.\n\n   El comando agotó el tiempo\n\nAumenta el límite dentro del rango 100–300000 ms:\n\n   bash\nlingua run ./slow-analysis.py --timeout 120000\n   \n\nSi el objetivo es un servidor permanente, ejecuta directamente el comando del framework.  lingua run  está diseñado para tareas que terminan.\n\n   La salida quedó truncada\n\nCada stream stdout y stderr tiene un presupuesto de 1 MiB. Reduce la salida detallada, escribe resultados grandes a un archivo desde el programa o divide el trabajo.  --json  no aumenta el límite.\n\n   Los logs de CI contienen códigos de color\n\n   bash\nNO COLOR=1 lingua run ./check.ts\nlingua run ./check.ts --color=never\n   \n\n --color=never  tiene prioridad explícita. JSON y completions siempre salen sin estilos.\n\n   Una Capsule valida, pero replay produce otro resultado\n\nLa validación demuestra que el archivo cumple el esquema; no garantiza que el programa sea determinista. El tiempo, valores aleatorios, dependencias locales, respuestas de red y versiones del toolchain pueden cambiar la salida. Revisa  comparison  en modo JSON en vez de tratar cada diferencia como error del CLI. "},{"href":"/es/cli/reference","title":"Referencia de comandos y opciones","description":"Consulta todos los comandos, opciones, límites, modos de salida y códigos estables del CLI de Lingua.","group":"reference","searchText":"Referencia de comandos y opciones Consulta todos los comandos, opciones, límites, modos de salida y códigos estables del CLI de Lingua. referencia comando flag opción códigos de salida ayuda versión color quiet json Esta referencia sigue el mismo catálogo estructurado que genera  lingua --help . El build del website falla si su snapshot del catálogo se separa del código fuente del CLI.\n\n   Comandos\n\n| Comando | Propósito |\n| --- | --- |\n|  lingua utility  utility-id   | Ejecuta un adaptador de utilidad compartido. |\n|  lingua capsule validate  file   | Valida una  RunCapsuleV1  sin ejecutarla. |\n|  lingua capsule replay  file   | Verifica y repite una Capsule confiable de una sola fuente. |\n|  lingua capsule verify  file   | Comparación estricta del source capturado; comando de build desde source, aún no publicado. |\n|  lingua run  file-or-directory   | Ejecuta un archivo o proyecto convencional. |\n|  lingua list utilities  | Imprime el registro actual de utilidades. |\n|  lingua completion  bash\\|zsh\\|fish\\|install   | Detecta e instala autocompletado o genera el script de un shell. |\n|  lingua --version  | Imprime la versión del CLI integrada en el build. |\n|  lingua --help  | Imprime la ayuda de terminal. |\n\n   Opciones\n\n| Opción | La usa | Significado |\n| --- | --- | --- |\n|  --input  file   |  utility  | Lee la entrada de la utilidad desde un archivo. |\n|  --option key=value  |  utility  | Repítela para pasar opciones del adaptador. |\n|  --stdin  file   |  run  | Envía el contenido del archivo como stdin. |\n|  --timeout  ms   |  run ,  capsule replay ,  capsule verify  | Detiene después de 100–300000 ms. |\n|  --env NAME=value  |  run ,  capsule replay ,  capsule verify  | Repítela para agregar una variable explícita. |\n|  --json  | comandos con datos | Emite un documento JSON estructurado. |\n|  --quiet  | comandos con datos | Oculta diagnósticos de Lingua, no la salida del comando. |\n|  --yes  |  completion  | Aprueba los cambios detectados sin pedir confirmación. |\n|  --dry-run  |  completion  | Muestra shells y archivos de destino sin escribir. |\n|  --color  auto\\|always\\|never   | todos | Controla los estilos de diagnósticos humanos. |\n|  --  |  run  | Envía cada token restante al programa. |\n|  --help ,  -h  | todos | Muestra ayuda. |\n|  --version ,  -v  | nivel principal | Imprime la versión del CLI. |\n\n   Códigos de salida\n\n| Código | Nombre | Significado |\n| --- | --- | --- |\n| 0 |  ok  | El comando terminó correctamente. |\n| 1 |  userInputError  | Los argumentos, la entrada, el archivo o la forma son inválidos. |\n| 2 |  runtimeError  | La ejecución falló, agotó el tiempo, se detuvo o devolvió un código no cero. |\n| 3 |  unsupportedCapability  | El runtime, modo, toolchain o salida no es compatible. |\n| 4 |  internal  | Una excepción inesperada llegó al límite del CLI. |\n| 5 |  verificationFailed  | La verificación estricta detectó diferencias. |\n| 6 |  verificationInconclusive  | La evidencia no permite establecer un pass estricto. |\n\n   Contrato de salida\n\nLos errores humanos usan una forma fácil de buscar:\n\n   text\nlingua run: error missing-runtime : Required runtime \"lua\" is not available on PATH.\n   \n\nCon  --json , el mismo motivo estable aparece en stdout:\n\n   json\n \n  \"ok\": false,\n  \"reason\": \"missing-runtime\",\n  \"detail\": \"Required runtime \\\"lua\\\" is not available on PATH.\"\n \n   \n\nLas guías prácticas documentan los envelopes correctos específicos. Los códigos existentes nunca cambian de número.\n\n   Verificación estricta del source capturado  sin publicar \n\n lingua capsule verify  file  --timeout  ms  --env NAME=value --json  está disponible en builds desde el nuevo source, no en el CLI 1.5.1 publicado. Revisa  lingua capsule verify --help  antes de usarlo. Compara exactamente status, stdout y stderr; no verifica un archivo modificado, seguridad, ejecución hermética ni equivalencia entre motores. Solo acepta baselines exitosos de texto con evidencia completa, y las grabaciones de Python, Go y Ruby web son inconclusas porque el motor de la app es distinto del runtime del CLI.  ok  es verdadero únicamente para verdict  pass ; las diferencias terminan con código 5 y la evidencia inconclusa con 6. Los errores de entrada, capacidades, runtime e internos conservan los códigos 1–4. Replay conserva su contrato de salida basado únicamente en ejecución.\n\n\n    Casos de regresión  sin publicar, compilaciones desde código \n\n lingua capsule verify  file  --target  file  --json \n\n lingua capsule verify-suite  suite  --root  directory  --json \n\n --target  file   ejecuta el archivo relativo guardado actual igual que el código capturado  mismo modo de runtime y directorio de trabajo del baseline ;  --root  directory   limita los destinos de la suite y usa el directorio actual por defecto. La suite v1 contiene baselines completos sin cambios, ejecuta hasta 20 casos/4 MiB en serie con un presupuesto total de cinco minutos y devuelve verdict estricto por caso. Importar o mostrar una vista previa nunca ejecuta código. Revisa la ayuda para detectar soporte; la versión pública 1.5.1 no incluye estos comandos.  \"schemaVersion\":1,\"title\":\"lingua — local code runner CLI\",\"commands\":  \"id\":\"utility\",\"topLevel\":\"utility\",\"invocation\":\"lingua utility  utility-id   --input  file    --json   --quiet   --option key=value ... \",\"summary\":\"Run a focused developer utility from a pipe or file.\",\"description\":\"Uses the same shared utility adapters as the desktop app without loading Electron or a renderer.\",\"flags\": \"input\",\"option\",\"json\",\"quiet\",\"color\",\"help\" ,\"examples\":  \"command\":\"echo ' \\\"a\\\":1 ' | lingua utility json-format\",\"description\":\"Format piped JSON.\" , \"command\":\"echo 'cada 3 dias 8am' | lingua utility cron-phrase\",\"description\":\"Turn a plain-words schedule  English or Spanish  into a cron expression.\" , \"command\":\"lingua utility base64-encode --input README.md\",\"description\":\"Encode a file without opening the app.\"   , \"id\":\"capsule-validate\",\"topLevel\":\"capsule\",\"invocation\":\"lingua capsule validate  file   --json   --quiet \",\"summary\":\"Validate a RunCapsuleV1 file without executing it.\",\"description\":\"Checks size, JSON shape, schema compatibility, and required fields through the same validator used by Lingua.\",\"flags\": \"json\",\"quiet\",\"color\",\"help\" ,\"examples\":  \"command\":\"lingua capsule validate ./run.capsule.json\",\"description\":\"Validate a capsule for a person reading terminal output.\" , \"command\":\"lingua capsule validate ./run.capsule.json --json\",\"description\":\"Return a stable machine-readable result.\"   , \"id\":\"capsule-replay\",\"topLevel\":\"capsule\",\"invocation\":\"lingua capsule replay  file   --timeout  ms    --env NAME=value ...   --json   --quiet \",\"summary\":\"Verify and replay the single source stored in a Run Capsule.\",\"description\":\"Verifies the recorded source hash, executes through the matching local runtime, and compares the fresh result with the recording.\",\"flags\": \"timeout\",\"env\",\"json\",\"quiet\",\"color\",\"help\" ,\"examples\":  \"command\":\"lingua capsule replay ./run.capsule.json --json\",\"description\":\"Replay and inspect the comparison envelope.\"   , \"id\":\"capsule-verify\",\"topLevel\":\"capsule\",\"invocation\":\"lingua capsule verify  file   --target  file    --timeout  ms    --env NAME=value ...   --json   --quiet \",\"summary\":\"Strictly verify captured source or an explicit current file against recorded streams.\",\"description\":\"Returns pass, fail, or inconclusive. Stream drift exits 5, incomplete evidence exits 6, and failed or timed-out runs keep exits 2-3. Execution uses the local CLI runtime, not a hermetic sandbox.\",\"flags\": \"target\",\"timeout\",\"env\",\"json\",\"quiet\",\"color\",\"help\" ,\"examples\":  \"command\":\"lingua capsule verify ./run.capsule.json --json\",\"description\":\"Fail a CI gate when recorded stdout/stderr differs.\"   , \"id\":\"capsule-verify-suite\",\"topLevel\":\"capsule\",\"invocation\":\"lingua capsule verify-suite  suite   --root  directory    --timeout  ms    --env NAME=value ...   --json   --quiet \",\"summary\":\"Serially verify current files against independent Capsule baselines.\",\"description\":\"Suite v1 allows 20 cases and 4 MiB, relative in-root targets and a five-minute total execution budget. Opening or importing a suite never executes it.\",\"flags\": \"root\",\"timeout\",\"env\",\"json\",\"quiet\",\"color\",\"help\" ,\"examples\":  \"command\":\"lingua capsule verify-suite ./regression.lingua-suite.json --root . --json\",\"description\":\"Check current saved files, without updating expectations.\"   , \"id\":\"run\",\"topLevel\":\"run\",\"invocation\":\"lingua run  file-or-directory   --stdin  file    --timeout  ms    --env NAME=value ...   --json   --quiet   -- args... \",\"summary\":\"Run a source file or conventional project root.\",\"description\":\"Executes trusted code with installed host toolchains, bounded output, a parent-owned timeout, and no shell interpolation.\",\"flags\": \"stdin\",\"timeout\",\"env\",\"json\",\"quiet\",\"color\",\"separator\",\"help\" ,\"examples\":  \"command\":\"lingua run ./script.py --stdin input.txt -- --verbose\",\"description\":\"Run Python with file-backed stdin and a forwarded argument.\" , \"command\":\"lingua run ./my-project --timeout 60000\",\"description\":\"Detect and run a conventional project root.\"   , \"id\":\"list-utilities\",\"topLevel\":\"list\",\"invocation\":\"lingua list utilities  --json   --quiet \",\"summary\":\"Discover utility ids, input kinds, output kinds, and options.\",\"description\":\"Prints the live utility registry so people and scripts do not need to guess adapter names or supported options.\",\"flags\": \"json\",\"quiet\",\"color\",\"help\" ,\"examples\":  \"command\":\"lingua list utilities --json\",\"description\":\"Inspect the registry from a script.\"   , \"id\":\"completion\",\"topLevel\":\"completion\",\"invocation\":\"lingua completion  bash|zsh|fish|install   --yes   --dry-run \",\"summary\":\"Install completions interactively or print one shell script.\",\"description\":\"With no target or with install, detects Bash, Zsh, and Fish, shows the target files, and asks before writing. A shell target prints deterministic network-free source.\",\"flags\": \"yes\",\"dry-run\",\"color\",\"help\" ,\"examples\":  \"command\":\"lingua completion\",\"description\":\"Detect supported shells and offer to install their completions.\" , \"command\":\"lingua completion install --yes\",\"description\":\"Install every detected completion without prompting.\"    ,\"flags\":  \"id\":\"target\",\"syntax\":\"--target  file \",\"summary\":\"Execute an explicit current relative file instead of captured source.\",\"commands\": \"capsule-verify\"  , \"id\":\"root\",\"syntax\":\"--root  directory \",\"summary\":\"Resolve suite targets inside this directory; defaults to cwd.\",\"commands\": \"capsule-verify-suite\"  , \"id\":\"input\",\"syntax\":\"--input  file \",\"summary\":\"Read utility input from a file instead of stdin.\",\"commands\": \"utility\"  , \"id\":\"stdin\",\"syntax\":\"--stdin  file \",\"summary\":\"Forward a file as program stdin.\",\"commands\": \"run\"  , \"id\":\"timeout\",\"syntax\":\"--timeout  ms \",\"summary\":\"Stop run or replay after 100–300000 ms.\",\"commands\": \"run\",\"capsule-replay\",\"capsule-verify\",\"capsule-verify-suite\"  , \"id\":\"env\",\"syntax\":\"--env NAME=value\",\"summary\":\"Repeat to add an explicit child-process environment value.\",\"commands\": \"run\",\"capsule-replay\",\"capsule-verify\",\"capsule-verify-suite\"  , \"id\":\"option\",\"syntax\":\"--option key=value\",\"summary\":\"Repeat to pass an adapter option.\",\"commands\": \"utility\"  , \"id\":\"json\",\"syntax\":\"--json\",\"summary\":\"Emit a stable structured JSON body instead of plain text.\",\"commands\": \"utility\",\"capsule-validate\",\"capsule-replay\",\"capsule-verify\",\"capsule-verify-suite\",\"run\",\"list-utilities\"  , \"id\":\"quiet\",\"syntax\":\"--quiet\",\"summary\":\"Suppress Lingua diagnostics while preserving command output.\",\"commands\": \"utility\",\"capsule-validate\",\"capsule-replay\",\"capsule-verify\",\"capsule-verify-suite\",\"run\",\"list-utilities\"  , \"id\":\"yes\",\"syntax\":\"--yes\",\"summary\":\"Approve detected shell-completion changes without prompting.\",\"commands\": \"completion\"  , \"id\":\"dry-run\",\"syntax\":\"--dry-run\",\"summary\":\"Show detected shells and target files without writing.\",\"commands\": \"completion\"  , \"id\":\"color\",\"syntax\":\"--color  auto|always|never \",\"summary\":\"Control diagnostic color. The default is auto.\",\"commands\": \"utility\",\"capsule-validate\",\"capsule-replay\",\"capsule-verify\",\"capsule-verify-suite\",\"run\",\"list-utilities\",\"completion\"  , \"id\":\"separator\",\"syntax\":\"--\",\"summary\":\"Forward every remaining token to the executed program unchanged.\",\"commands\": \"run\"  , \"id\":\"help\",\"syntax\":\"--help, -h\",\"summary\":\"Show help.\",\"commands\": \"utility\",\"capsule-validate\",\"capsule-replay\",\"capsule-verify\",\"capsule-verify-suite\",\"run\",\"list-utilities\",\"completion\"  , \"id\":\"version\",\"syntax\":\"--version, -v\",\"summary\":\"Print the CLI version.\",\"commands\":    ,\"exitCodes\":  \"code\":0,\"name\":\"ok\",\"summary\":\"Command completed successfully.\" , \"code\":1,\"name\":\"userInputError\",\"summary\":\"Arguments, input, file, or shape are invalid.\" , \"code\":2,\"name\":\"runtimeError\",\"summary\":\"Execution failed, timed out, stopped, or exited non-zero.\" , \"code\":3,\"name\":\"unsupportedCapability\",\"summary\":\"Runtime, mode, toolchain, or output is unsupported.\" , \"code\":4,\"name\":\"internal\",\"summary\":\"An unexpected exception reached the CLI boundary.\" , \"code\":5,\"name\":\"verificationFailed\",\"summary\":\"Strict verification detected output drift.\" , \"code\":6,\"name\":\"verificationInconclusive\",\"summary\":\"Strict verification could not establish complete evidence.\"   "}]

CLI de Lingua

Automatiza con salida estable

Usa envelopes JSON, modo quiet, códigos, completions y ejecución limitada para crear scripts y jobs de CI confiables.

Buscar en la documentación del CLI

Presiona / para buscar

Explorar guías del CLI

Instala el CLI con Homebrew en macOS, usa @linguacode/cli mediante npm o npx, o compílalo desde el código fuente. Fija una versión para automatización.

El CLI separa los datos en stdout de los diagnósticos humanos en stderr. Los códigos estables, --json y la ejecución limitada lo convierten en un bloque confiable para CI.

Elige texto o JSON deliberadamente

El modo normal funciona mejor cuando la salida de Lingua será la entrada del siguiente programa:

lingua utility json-format --input raw.json --quiet > normalized.json

El modo JSON funciona mejor cuando un script necesita estado y metadatos:

result=$(lingua run ./check.ts --json) || status=$?
printf '%s\n' "$result" | jq .
exit "${status:-0}"

La salida estructurada nunca contiene secuencias ANSI, incluso con --color=always.

Usa las familias de códigos de salida

Código	Significado	Respuesta típica
0	correcto	continúa
1	argumentos o entrada inválidos	corrige la invocación o artefacto
2	error del runtime o timeout	revisa la salida del programa
3	capacidad ausente o no compatible	instala o elige un runtime
4	error interno inesperado	conserva diagnósticos y repórtalo

Evita jobs bloqueados

lingua run ./integration-check.py --timeout 90000 --json

El rango permitido es 100–300000 ms y el valor predeterminado es 30000 ms. El timeout y Ctrl+C terminan el árbol de procesos.

Instala autocompletado

Homebrew instala automáticamente los archivos de Bash, Zsh y Fish. Con los demás canales, permite que Lingua detecte los shells compatibles en PATH, muestre cada archivo de destino y pida confirmación una sola vez:

lingua completion
lingua completion --dry-run
lingua completion install --yes # aprobación no interactiva explícita

El instalador marca el shell actual, configura los directorios estándar de usuario para Bash y Fish, y mantiene un único bloque delimitado en .zshrc para Zsh. Desde CI o un pipe no escribe nada sin --yes.

También puedes generar manualmente un script determinista:

lingua completion bash
lingua completion zsh
lingua completion fish

La generación es determinista y no usa red, por lo que un script de instalación puede ejecutarla sin contactar servicios.

Consulta Recetas prácticas para el desarrollo diario para ver patrones completos de GitHub Actions, hooks de Git, scripts de paquete, Make, Docker, Bash y PowerShell.