[{"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 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\n @linguacode/cli  ya está publicado en npm. No tiene dependencias 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 máquinas sin Node puedes usar los archivos independientes  lingua-cli- -linux-x64.tar.gz  y  -windows-x64.tar.gz  que vienen adjuntos a cada  GitHub Release  https://github.com/johnny4young/lingua/releases/latest  estable.\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-  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. "},{"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   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/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\n    Bash\n\n   bash\nmkdir -p ~/.local/share/bash-completion/completions\nlingua completion bash   ~/.local/share/bash-completion/completions/lingua\n   \n\n    Zsh\n\n   zsh\nmkdir -p ~/.zfunc\nlingua completion zsh   ~/.zfunc/ lingua\nfpath= ~/.zfunc $fpath \nautoload -Uz compinit && compinit\n   \n\n    Fish\n\n   fish\nmkdir -p ~/.config/fish/completions\nlingua completion fish   ~/.config/fish/completions/lingua.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. "},{"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\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\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 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  | Genera código de autocompletado para el 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  | Detiene después de 100–300000 ms. |\n|  --env NAME=value  |  run ,  capsule replay  | 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|  --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\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.  \"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\":\"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\":\"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\",\"summary\":\"Generate a deterministic shell completion script.\",\"description\":\"Prints network-free Bash, Zsh, or Fish completion source without ANSI styling.\",\"flags\": \"color\",\"help\" ,\"examples\":  \"command\":\"lingua completion zsh   ~/.zfunc/ lingua\",\"description\":\"Install the Zsh completion file.\"    ,\"flags\":  \"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\"  , \"id\":\"env\",\"syntax\":\"--env NAME=value\",\"summary\":\"Repeat to add an explicit child-process environment value.\",\"commands\": \"run\",\"capsule-replay\"  , \"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\",\"run\",\"list-utilities\"  , \"id\":\"quiet\",\"syntax\":\"--quiet\",\"summary\":\"Suppress Lingua diagnostics while preserving command output.\",\"commands\": \"utility\",\"capsule-validate\",\"capsule-replay\",\"run\",\"list-utilities\"  , \"id\":\"color\",\"syntax\":\"--color  auto|always|never \",\"summary\":\"Control diagnostic color. The default is auto.\",\"commands\": \"utility\",\"capsule-validate\",\"capsule-replay\",\"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\",\"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.\"   "}]

CLI de Lingua

Valida y repite Run Capsules

Revisa una RunCapsuleV1, repite capturas confiables de una sola fuente y entiende los límites de integridad y Workspace.

Buscar en la documentación del CLI

Presiona / para buscar

Explorar guías del CLI

El CLI se publica en npm como @linguacode/cli. Instálalo de forma global, ejecútalo con npx o compílalo desde el código fuente.

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.

Valida sin ejecutar

lingua capsule validate ./run.capsule.json
lingua capsule validate ./run.capsule.json --json

La 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.

Úsala como gate de carga o build:

for capsule in build/*.capsule.json; do
  lingua capsule validate "$capsule" --quiet || exit 1
done

Repite una fuente confiable

lingua capsule replay ./run.capsule.json
lingua capsule replay ./run.capsule.json --timeout 60000 --json

Replay 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.

Un comando correcto todavía puede devolver comparison.matches: false. Eso es evidencia útil de reproducibilidad, no un error del runtime.

Conoce el límite de confianza

El 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.

Las 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.

Workaround para Capsule Workspace

CapsuleWorkspaceV1 puede transportar archivos de texto adicionales seleccionados explícitamente para revisarlos en la app. El CLI no reconstruye ni repite ese wrapper multiarchivo.

Si la Capsule anidada funciona por sí sola, extrae y repite esa única fuente.
Si depende de archivos vecinos, usa lingua run <directorio-del-proyecto> sobre el proyecto real.