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.
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.
No se encuentra el comando lingua
Si trabajas desde el código fuente, compila y enlaza desde la raíz:
pnpm run build:cli
pnpm link --global
command -v lingua
lingua --versionSi 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.
Falta un runtime
Lingua ahora muestra el nombre del runtime, una acción de instalación para tu
plataforma, un comando de verificación y esta guía cuando lingua run no
encuentra un toolchain. En macOS puedes corregirlo directamente con:
brew install python # Python
brew install go # Go
brew install rust # Rust y Cargo
brew install ruby # Ruby
brew install lua # LuaConfirma que el mismo shell encuentre el toolchain:
node --version
python3 --version
go version
rustc --version
ruby --version
lua -vUna 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.
En modo --json, revisa run.recovery (también disponible como recovery en
el nivel superior) para obtener runtime, executable, installCommand
opcional, installGuide y verifyCommand sin analizar el texto humano.
Lingua rechaza una opción de mi programa
Separa los dos dominios de argumentos:
lingua run ./server.ts --timeout 60000 -- --json --port 4000Antes de --, las opciones pertenecen a Lingua. Después, cada token pertenece a tu programa.
El comando agotó el tiempo
Aumenta el límite dentro del rango 100–300000 ms:
lingua run ./slow-analysis.py --timeout 120000Si el objetivo es un servidor permanente, ejecuta directamente el comando del framework. lingua run está diseñado para tareas que terminan.
La salida quedó truncada
Cada 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.
Los logs de CI contienen códigos de color
NO_COLOR=1 lingua run ./check.ts
lingua run ./check.ts --color=never--color=never tiene prioridad explícita. JSON y completions siempre salen sin estilos.
Una Capsule valida, pero replay produce otro resultado
La 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.