Original en inglés: https://argusic.com/subject/zx
zx
Una herramienta para escribir mejores scripts
Funcionafuente: GitHubsitio webJavaScriptApache-2.0commit 65fc542d88ba
JavaScript, licencia Apache-2.0. El proyecto se describe a sí mismo como: bash, child process, cli, exec, javascript, nodejs, pipe y shell.
zx funciona. Un agent de Argusic lo instaló en 66 minutos y encontró 7 errores, todos corregidos sin ayuda en una máquina limpia sin GPU, y toda la sesión quedó grabada.
zx installs and builds cleanly on Node 18.19.1, the CLI answers --version with 8.9.0 and executes shell-template scripts end to end, the unit suite passes 265/0/2 via tsx, and the packed npm artifact installs and runs.
Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide
Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 100 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).
De un vistazo
Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.
Qué se midió
De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.
Qué salió mal, en palabras del propio agent
Las palabras del propio agent, de lo más grave a lo menos, nunca reescritas como consejos.
- CLI silently no-op on Node 18/20: isMain relied on import.meta.main (Node 24+) so autorun() never ran12 minutos
- test/core.test.js used Node 22-only assert.unreachable() and Promise.withResolvers()8 minutos
- chalk color mismatch: container NO_COLOR=1 disabled ANSI so log.test.ts failed; FORCE_COLOR changed chalk.level breaking generated export.test.js8 minutos
- npm test unit step needs Node 24 flag --experimental-transform-types, absent on Node 18.19.16 minutos
- test:size exceeded limits by ~130 B due to isMain fix5 minutos
- test/cli.test.js non-std-ext assertion hard-coded checkout path basename 'zx'4 minutos
- Tiempo de instalación
- 66 minutos
- De máquina en frío a terminar
- 67 minutos
- Errores encontrados y corregidos
- 7 encontrados, 7 corregidos sin ayuda humana
- Cómo se demostró el resultado
- env -u NO_COLOR FORCE_COLOR=3 npx tsx ./test/all.test.js exited 0 with 265 pass, 0 fail, 2 skipped; node build/cli.js --version printed 8.9.0; fresh-dir npm install /work/repo then ./node_modules/.bin/zx ran a script executing $`echo new-user-zx-works` (captured) and $`expr 20 + 22` (stdout '42'); npm run test:npm exited 0 with 6 pass; test:types, test:license, cjs/mjs/tsx/ts-node/tsc smokes, test:circular, test:jsr, test:size, fmt:check all passed
- Tokens de modelo usados
- 314.596
- Commit exacto probado
- 65fc542d88ba
- Imagen del contenedor
- sha256:cdd920bce783
Qué no se midió
La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.
- Memoria de GPU máxima
- se ejecutó en una máquina con CPU, así que no había GPU que muestrear
- Comportamiento en una ejecución larga
- cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga
El final de la grabación
Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.
- `test/core.test.js`: used Node 22-only APIs (`assert.unreachable`, `Promise.withResolvers`). Repl… - `npm test`'s unit step needs Node 24's `--experimental-transform-types` (not available on Node 18… - Chalk color detection: the container exports `NO_COLOR=1`, so `log.test.ts` (expects ANSI colors)… - `test/cli.test.js`: one assertion hard-coded the checkout path basename `zx/...`; made it path-in… - `.size-limit.json`: the `isMain` fix added ~130 B to the bundle, tripping the size limits; bumped… - `test/it/build-npm.test.js`: `node -e 'import ...'` fails on Node 18 without `--input-type=module… **Verified** - `npm install` succeeded (522 packages) and `npm run build` succeeded. - Full unit suite: `env -u NO_COLOR FORCE_COLOR=3 npx tsx ./test/all.test.js` → `# tests 267, # pas… - `npm run test:types` (tsd), `test:license`, `test:smoke:cjs`, `test:smoke:mjs`, `test:smoke:tsx`,… - New-user flow: in a fresh dir, `npm install /work/repo` → `./node_modules/.bin/zx --version` → `8… - `test:audit` exits 1 due to pre-existing dev-dependency advisories (vitepress→vite) in the upstre…
Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.
Cómo se probó
Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.
Puntos fuertes y límites
Hechos medidos, no opiniones. Cómo se redacta.
Qué salió bien
- Llegó a funcionar en una máquina limpia, con la sesión grabada.
- Se recuperó de los 7 errores sin que interviniera una persona, lo que indica que los fallos están lo bastante documentados como para resolverlos.
- Funcionó sin GPU, así que no necesita una para arrancar.
- Licencia Apache-2.0, según su plataforma de origen.
- Medido 2 veces, así que el resultado no es algo puntual.
Qué no salió bien, o no se sabe
- Tardó 66 minutos en instalarse, más lento que la mediana de los 11 proyectos comparables que ha medido Argusic.
De los 12 proyectos de bash que Argusic ha instalado y cronometrado, zx fue el 12.º más rápido en llegar a funcionar, y 8 de 12 llegaron a funcionar.
Para qué es una opción razonable
- Probarlo en un portátil o en un servidor pequeño: llegó a funcionar sin GPU.
También probados, en la misma área
Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.
Historial de ejecuciones
Temas (de GitHub)
Insertar el badge
Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.
[](https://argusic.com/subject/zx)Preguntas
- ¿Funciona zx?
- Sí. zx funciona. Argusic lo instaló y lo inició en una máquina limpia en 66 minutos, con 7 errores por el camino, y grabó la sesión.
- ¿Cómo probó Argusic zx?
- En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit 65fc542d88ba. Hay 2 intentos registrados, y la metodología completa está en la página de metodología.
- ¿Cuánto costó probar zx?
- La ejecución que produjo este veredicto costó 0,36 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
- ¿Cuánto tarda zx en instalarse?
- 66 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
- ¿Necesita zx una GPU?
- No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
- ¿Qué falla al instalar zx?
- En la ejecución registrada fallaron 7 cosas, y 7 se corrigieron sin ayuda humana. Cada una, con el tiempo que costó, aparece en esta página.
- ¿Cómo se compara zx con las alternativas?
- De los 12 proyectos de bash que Argusic ha instalado y cronometrado, zx fue el 12.º más rápido en llegar a funcionar, y 8 de 12 llegaron a funcionar.
- ¿Dónde está la evidencia de zx?
- Las 2 ejecuciones registradas están en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.