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.
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.
Es 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.
Instálalo
@linguacode/cli ya está publicado en npm. No tiene dependencias y necesita Node 24.x:
npm install -g @linguacode/cli
lingua --help¿Prefieres no instalar nada? Ejecútalo una sola vez con npx:
npx @linguacode/cli --helpEn 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 estable.
Compílalo desde el código fuente
Si contribuyes al proyecto, o si sigues main antes de una release, compílalo desde el repositorio:
git clone https://github.com/johnny4young/lingua.git
cd lingua
corepack enable
pnpm install
pnpm run build:cli
node dist/cli/lingua.cjs --helpPara desarrollo local, agrega el comando lingua a tu PATH:
pnpm link --global
lingua --versionEste enlace apunta a tu checkout. Ejecuta pnpm run build:cli después de cambiar el código del CLI.
Ejecuta tu primer comando útil
Formatea JSON directamente desde otro programa:
curl -s https://api.github.com/repos/johnny4young/lingua \
| lingua utility json-formatTambién puedes ejecutar un archivo con el toolchain instalado en tu equipo:
lingua run ./scripts/check.ts -- --verboseTodo lo que aparece después de -- pertenece a tu programa, no a Lingua.
Elige el comando correcto
| Quieres… | Empieza con |
|---|---|
| transformar o inspeccionar un valor | lingua utility |
| ejecutar un archivo o proyecto convencional | lingua run |
| revisar una Capsule sin ejecutarla | lingua capsule validate |
| reproducir una ejecución capturada | lingua capsule replay |
| descubrir utilidades y sus opciones | lingua list utilities --json |
| activar autocompletado | lingua completion |
Un modelo mental seguro
El 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.
El CLI no necesita red. Tu programa sí puede usarla, y cada lenguaje requiere su toolchain local correspondiente.