Original em inglês: https://argusic.com/subject/zx
zx
Uma ferramenta para escrever scripts melhores
Executafonte: GitHubpágina do projetoJavaScriptApache-2.0commit 65fc542d88ba
JavaScript, licença Apache-2.0. O projeto se descreve como: bash, child process, cli, exec, javascript, nodejs, pipe e shell.
zx executa. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 66 minutos e encontrou 7 erros, corrigindo todos sem ajuda, e a sessão inteira foi gravada.
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.
O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido
Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 100 de 100 (a média das pontuações das execuções deste projeto).
Visão geral
Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.
O que foi medido
Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.
O que deu errado, nas palavras do agent
As palavras do próprio agent, das piores para as menores, nunca reescritas como conselho.
- 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
- Tempo de instalação
- 66 minutos
- Da máquina limpa até o fim
- 67 minutos
- Erros encontrados e corrigidos
- 7 encontrados, 7 corrigidos sem ajuda humana
- Como o resultado foi comprovado
- 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 exato testado
- 65fc542d88ba
- Imagem do container
- sha256:cdd920bce783
O que não foi medido
A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.
- Pico de memória da GPU
- esta execução foi em uma máquina com CPU, então não havia GPU para medir
- Comportamento em uma execução longa
- cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
O fim da gravação
As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.
- `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…
Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.
Como foi testado
Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.
Pontos fortes e limites
Fatos medidos, não opiniões. Como este conteúdo é escrito.
O que deu certo
- Chegou a um estado de execução em uma máquina limpa, com a sessão gravada.
- Recuperou-se de todos os 7 erros sem que uma pessoa interviesse, o que indica que as falhas estão documentadas o suficiente para serem resolvidas.
- Executou sem GPU, então não precisa de uma para iniciar.
- Licença Apache-2.0, segundo a plataforma onde o projeto está hospedado.
- Medido 2 vezes, então o resultado não é um caso isolado.
O que não deu certo, ou não se sabe
- Levou 66 minutos para instalar, mais devagar que a mediana dos 11 projetos comparáveis que a Argusic mediu.
Dos 12 projetos de bash que a Argusic instalou e cronometrou, zx foi o 12º mais rápido a chegar a um estado de execução, e 8 de 12 chegaram a esse estado.
Para que é uma escolha razoável
- Testar em um laptop ou em um servidor pequeno: ele chegou a um estado de execução sem GPU.
Também testados, na mesma área
Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.
Histórico de execuções
Tópicos (de GitHub)
Incorporar o selo
Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.
[](https://argusic.com/subject/zx)Perguntas
- zx executa?
- Sim. zx executa. A Argusic o instalou e iniciou em uma máquina limpa em 66 minutos, encontrando 7 erros no caminho, e gravou a sessão.
- Como a Argusic testou zx?
- Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit 65fc542d88ba. Há 2 tentativas registradas, e a metodologia completa está na página da metodologia.
- Quanto custou testar zx?
- A execução que produziu este veredito custou US$ 0,36: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
- Quanto tempo leva para instalar zx?
- 66 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
- zx precisa de GPU?
- Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
- O que dá errado ao instalar zx?
- 7 coisas quebraram na execução registrada, e 7 foram corrigidas sem ajuda humana. Cada uma, com o tempo que custou, está listada nesta página.
- Como zx se compara às alternativas?
- Dos 12 projetos de bash que a Argusic instalou e cronometrou, zx foi o 12º mais rápido a chegar a um estado de execução, e 8 de 12 chegaram a esse estado.
- Onde estão as evidências de zx?
- Todas as 2 execuções registradas estão nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.