Ir para o conteúdo principal

A CLI para agentes de IA · Windows · Linux · macOS

10 comandos.
Um só zap.

Seu agente de IA gasta turnos improvisando shell: Git aqui, manifestos ali, DNS, TLS, HTTP, varreduras de disco, caça a duplicados — e cada sistema operacional escreve de um jeito. O QZX faz esse trabalho em um único comando multiplataforma e devolve respostas acionáveis. Legíveis para você. JSON estruturado para o seu agente.

Veja a corrida
Chamadas de ferramenta
21 → 318 idas e voltas a menos
Shell que seu agente escreve
28× menos664 → 24 tokens
Mais rápido
1,9×26,4 s → 13,6 s

Medido em três diagnósticos do dia a dia, na mesma máquina e no mesmo dia. Como medimos

QZX / Exemplo registrado
qzx diagnoseProject . --json

Entenda antes de editar

Um briefing do projeto, em um comando.

TecnologiaPython
Pacote declaradohttpx
1 achado

Repositório Git não detectado.

Próximas verificaçõespytest · ruffConfiguradas · não executadas
Inspecionar o JSON 
{
    "success": true,
    "details": {
        "technologies": [
            "Python"
        ],
        "dependencies": {
            "unique_declared_package_count": 1,
            "unique_packages": [
                "httpx"
            ]
        },
        "version_control": {
            "status": "not_repository"
        },
        "file_scan": {
            "scanned_file_count": 3,
            "scan_complete": true
        },
        "summary": {
            "issue_count": 1,
            "verification": {
                "release_readiness": "not_assessed"
            }
        },
        "validation": {
            "tests": {
                "status": "configured_not_run"
            },
            "lint": {
                "status": "configured_not_run"
            }
        }
    }
}

Amostra registrada: project-doctor. Campos selecionados do resultado real.

Exemplo registrado · 2026-10-08QZX 0.2.2.0.15 / Windows

Resultados registrados pelo pipeline de documentação. JSON exibido como trechos revisados. Explore o contrato de resultados

Instale. Verifique. Pronto.Alpha 0.2.2.0.15
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json
Guia de instalação PyPI ↗ Mais exemplos
Prefere uma instalação isolada?

Use o pipx para manter o QZX separado das dependências Python do seu projeto.

Gratuito e de código aberto · Sem conta · Alejandro Sánchez

O mesmo vocabulário em todas as máquinas.

WindowsLinuxmacOS

Em casa no terminal do seu agente.

CodexClaude CodeGemini CLI

Medido, não imaginado

As mesmas evidências.
Um único comando.

Executamos cada diagnóstico de duas formas na mesma máquina: com os comandos nativos que um agente digitaria, uma chamada de ferramenta por vez, e com o único comando do QZX. Escolha uma tarefa e veja a corrida.

Sem QZX · PowerShell10 comandos · 10,3 s
  1. git -C '.' status --short --branch
  2. git -C '.' log --oneline -5
  3. git -C '.' remote -v
  4. Get-ChildItem '.' -Recurse -File | Where-Object FullName -notmatch '\\.git\\' | Group-Object Extension | Sort-Object Count -Descending | Select-Object -First 10 Name,Count
  5. Get-ChildItem '.' -File | Where-Object Name -in 'pyproject.toml','setup.py','setup.cfg','requirements.txt','package.json','Cargo.toml','go.mod','composer.json' | Select-Object Name
  6. Get-Content './pyproject.toml'
  7. Get-ChildItem '.' -File | Where-Object Name -in 'pytest.ini','tox.ini','ruff.toml','.ruff.toml','Makefile','noxfile.py' | Select-Object Name
  8. python --version
  9. Get-ChildItem '.' -Recurse -File | Where-Object FullName -notmatch '\\.git\\' | Sort-Object Length -Descending | Select-Object -First 10 FullName,Length
  10. Get-ChildItem '.' -Recurse -File -Include *.py | Select-String -Pattern 'TODO|FIXME' | Measure-Object | Select-Object Count
…e com outra sintaxe no Linux (10) e no macOS (10)

Linux

  1. git status --short --branch
  2. git log --oneline -5
  3. git remote -v
  4. find . -type f -not -path './.git/*' | sed -n 's/.*\.//p' | sort | uniq -c | sort -rn | head
  5. ls pyproject.toml setup.py setup.cfg requirements.txt package.json Cargo.toml go.mod 2>/dev/null
  6. cat pyproject.toml
  7. ls pytest.ini tox.ini ruff.toml .ruff.toml Makefile noxfile.py 2>/dev/null
  8. python3 --version
  9. find . -type f -not -path './.git/*' -printf '%s %p\n' | sort -rn | head
  10. grep -rIn --include='*.py' -E 'TODO|FIXME' . | wc -l

macOS

  1. git status --short --branch
  2. git log --oneline -5
  3. git remote -v
  4. find . -type f -not -path './.git/*' | sed -n 's/.*\.//p' | sort | uniq -c | sort -rn | head
  5. ls pyproject.toml setup.py setup.cfg requirements.txt package.json Cargo.toml go.mod 2>/dev/null
  6. cat pyproject.toml
  7. ls pytest.ini tox.ini ruff.toml .ruff.toml Makefile noxfile.py 2>/dev/null
  8. python3 --version
  9. find . -type f -not -path './.git/*' -exec stat -f '%z %N' {} + | sort -rn | head
  10. grep -rIn --include='*.py' -E 'TODO|FIXME' . | wc -l

10 fragmentos para costurar antes da primeira edição.

Com QZX · qualquer SO1 comando · 8,0 s
qzx diagnoseProject .
  • Tecnologias
  • Dependências
  • Ambiente
  • Testes e lint
  • Estado do Git
  • Análise do código
  • Arquivos grandes
  • Achados

1,3× mais rápido. Um briefing com achados e as próximas verificações.

A animação é acelerada; os segundos mostrados são os tempos reais medidos.

Como medimos: em 2026-10-08, no Windows 11 10.0.26200 com QZX 0.2.2.0.14. Cada comando nativo rodou em um processo novo do PowerShell 7, como uma chamada de ferramenta separada do agente, com seleções enxutas de colunas que favorecem o lado nativo. Tokens contados com tiktoken o200k_base. As variantes de Linux e macOS são mostradas como referência e não foram cronometradas. Os resultados do QZX também trazem conclusões — pontuações, a camada com falha, recomendações — que a saída nativa deixa para o seu agente deduzir.

Como funciona

Seu agente pede uma vez. O QZX cuida da plataforma.

O QZX é uma CLI Python de código aberto. Você ou seu agente chamam um comando documentado; o QZX faz o trabalho específico de Windows, Linux ou macOS e responde no mesmo formato em todo lugar: um resumo legível para pessoas e JSON estruturado com --json para programas.

  1. Instale

    Um pacote do PyPI, com pip ou pipx. Sem conta, sem servidor, sem serviço em segundo plano.

  2. Peça a tarefa

    Chame o comando pelo nome, por exemplo qzx inspectPort 3000. A mesma grafia funciona em todos os sistemas compatíveis.

  3. Leia ou processe

    Pessoas recebem um resumo. Agentes adicionam --json, testam success, leem message e usam a evidência tipada.

Diagrama mostrando Codex, Claude Code, Gemini CLI e scripts chamando um mesmo comando QZX no Windows, Linux e macOS e recebendo os campos compartilhados success, message, output e meta.
Um comando documentado pode cobrir trabalho compatível em vários hosts enquanto o núcleo compartilhado do resultado continua previsível. Limites de plataforma e evidências específicas de cada comando ficam explícitos.

Uma dúzia de tarefas do dia a dia

Cada cartão mostra o que você ou seu agente digitariam sem o QZX — diferente no Windows, Linux e macOS — ao lado do único comando QZX para a mesma tarefa. Todos os comandos QZX abaixo são somente leitura e foram executados durante a preparação desta página.

Sistema

Quem está ocupando a porta 3000?

Livre ou ocupada, e o processo dono — inspecionado, nunca encerrado.

Sem QZX

WindowsGet-NetTCPConnection -LocalPort 3000 -State Listen | % { Get-Process -Id $_.OwningProcess }
Linuxss -ltnp 'sport = :3000'
macOSlsof -nP -iTCP:3000 -sTCP:LISTEN

Com QZX

qzx inspectPort 3000
Documentação do comando

Rede

Este certificado TLS está saudável?

Datas de validade, confiança da cadeia, cobertura do nome, versão TLS e dias restantes, como campos.

Sem QZX

WindowsSem OpenSSL por padrão: é preciso escrever um script .NET com SslStream
Linux · macOSopenssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -dates -subject -ext subjectAltName

Com QZX

qzx checkSslCertificate example.com
Documentação do comando

Rede

O que dizem os registros DNS?

A, AAAA, MX, TXT, NS e CNAME em uma chamada e um resultado.

Sem QZX

Windows'A','AAAA','MX','TXT','NS','CNAME' | % { Resolve-DnsName example.com -Type $_ }
Linux · macOSfor t in A AAAA MX TXT NS CNAME; do dig +short example.com $t; done

Com QZX

qzx checkDns example.com
Documentação do comando

Arquivos

Quais arquivos são duplicatas exatas?

Tamanho, SHA-256 e confirmação byte a byte. Nada é apagado.

Sem QZX

WindowsGet-ChildItem Pictures -Recurse -File | Get-FileHash | Group-Object Hash | ? Count -gt 1
Linuxfind Pictures -type f -exec sha256sum {} + | sort | uniq -w64 -D
macOSfind Pictures -type f -exec shasum -a 256 {} + | sort | awk 'seen[$1]++'

Com QZX

qzx findDuplicateFiles Pictures
Documentação do comando

Arquivos

Quais são os maiores arquivos aqui?

Filtre por tamanho e data, ordene e limite, com metadados estruturados de cada arquivo.

Sem QZX

WindowsGet-ChildItem Downloads -Recurse -File | ? Length -gt 100MB | Sort-Object Length -Desc | Select-Object -First 20
Linuxfind Downloads -type f -size +100M -printf '%s %p\n' | sort -nr | head -20
macOSfind Downloads -type f -size +100M -exec stat -f '%z %N' {} + | sort -nr | head -20

Com QZX

qzx findFiles Downloads "*" --min-size 100MiB --sort-by size --descending true --limit 20
Documentação do comando

Arquivos

Este download confere com o checksum?

SHA-256 por padrão, MD5 ou SHA-1 quando você pedir — o mesmo verbo em todos os sistemas.

Sem QZX

WindowsGet-FileHash release.zip -Algorithm SHA256
Linuxsha256sum release.zip
macOSshasum -a 256 release.zip

Com QZX

qzx calculateFileHash release.zip
Documentação do comando

Desenvolvimento

Em que estado está este repositório?

Branch, remoto, alterações pendentes e commits recentes em um retrato estruturado.

Sem QZX

Qualquer sistemagit branch --show-current; git remote -v; git status --porcelain; git log -5 --oneline

Com QZX

qzx getGitStatus
Documentação do comando

Desenvolvimento

Mostre a estrutura deste projeto.

Uma árvore limitada: ASCII para você, JSON para seu agente, sem seguir links simbólicos.

Sem QZX

Windowstree /F src
Linuxtree -L 3 src
macOSbrew install tree && tree -L 3 src

Com QZX

qzx getProjectTree src 3
Documentação do comando

Desenvolvimento

Onde esta variável de ambiente é usada?

Referências no código mais os modelos .env e .env.example, em um único relatório.

Sem QZX

WindowsGet-ChildItem -Recurse -File -Include *.py,*.js,*.ts,.env* | Select-String DATABASE_URL
Linux · macOSgrep -rn DATABASE_URL --include='*.py' --include='*.js' --include='*.ts' --include='.env*' .

Com QZX

qzx traceEnvVar DATABASE_URL
Documentação do comando

Desenvolvimento

Existem importações circulares?

Segue as importações de módulos recursivamente e nomeia cada ciclo encontrado.

Sem QZX

Qualquer sistemaSem equivalente nativo: instale uma ferramenta separada, específica de cada linguagem

Com QZX

qzx traceCircularImports src
Documentação do comando

Sistema

O que está consumindo memória?

Os processos que mais usam memória, com os mesmos campos em todos os sistemas.

Sem QZX

WindowsGet-Process | Sort-Object WS -Descending | Select-Object -First 10
Linuxps aux --sort=-%mem | head -n 11
macOSps aux -m | head -n 11

Com QZX

qzx listProcesses null memory 10
Documentação do comando

Sistema

Qual python é executado — e o PATH está quebrado?

Cada ocorrência no PATH, com entradas quebradas e duplicadas sinalizadas.

Sem QZX

Windowswhere.exe python; $env:Path -split ';' | ? { $_ -and -not (Test-Path $_) }
Linux · macOSwhich -a python; echo "$PATH" | tr ':' '\n' | while read d; do [ -d "$d" ] || echo "$d"; done

Com QZX

qzx checkSystemPath python
Documentação do comando

Explore os 89 comandos

Por que desenvolvedores e equipes migram

Rápido. Confortável. E com potência de sobra.

Menos turnos, menos shell, mais resultado

Cada chamada de ferramenta é mais um turno do modelo. O QZX condensa diagnósticos de várias etapas em um só, então seu agente escreve 28× menos shell (664 → 24 tokens) e evita 18 idas e voltas — com as conclusões já calculadas.

21 → 3

Mais rápido de ponta a ponta

Um processo em vez de uma cadeia de shells. 1,9× mais rápido em nossos três diagnósticos e 3,0× quando um site está fora do ar.

3,0×

Um vocabulário, três sistemas

Pare de ramificar prompts por sistema operacional.

Resolve-DnsNamedigopenssl s_clientqzx diagnoseWebsite

89 comandos publicados e contando

Sistema, rede, arquivos, Git, desenvolvimento, armazenamento e scaffolding de projetos — uma única instalação.

Explore as ferramentas

Seguro por padrão

Os diagnósticos são somente leitura. Comandos que alteram algo mostram uma prévia primeiro e mantêm suas barreiras de backup e aprovação.

Segurança e telemetria

Um contrato em que seu agente pode confiar

Todo resultado --json traz um success explícito e um message útil, além de evidências tipadas. Nada de raspar tabelas nem adivinhar por códigos de saída. O schema é aberto e baixável.

Explore o contrato de resultados

Comece com um problema real

Útil antes da sua próxima mudança.

Escolha a tarefa à sua frente. Comece com um diagnóstico somente leitura e depois decida o próximo passo.

Substitui 10 comandos

Torne familiar um projeto desconhecido.

Descubra tecnologias, dependências, estado do Git e achados concretos antes que seu agente comece a editar.

qzx diagnoseProject .
Explore o fluxo de projetos
Substitui 3 pipelines

Descubra o que está enchendo seu disco.

Inspecione capacidade, arquivos grandes e evidências de duplicados. Entenda suas opções antes de remover qualquer coisa.

qzx diagnoseStorage .
Explore o fluxo de armazenamento
Substitui 8 comandos

Vá além de “o site caiu”.

Verifique DNS, certificados e HTTP de uma só vez. Siga as evidências até a próxima verificação.

qzx diagnoseWebsite <url>
Explore o fluxo de sites

Um contrato aberto que outros podem implementar

Respostas em que seu agente pode confiar, sem interpretar texto

Todo resultado JSON tem um booleano explícito success e uma message útil e não vazia. Depois, cada comando acrescenta evidência tipada — aqui, uma verificação real de certificado — em vez de um bloco de texto que seu agente precisaria interpretar.

Leia a especificação Veja a prontidão do Golden Core Baixe o JSON Schema 
{
  "success": true,
  "message": "SSL certificate diagnostic for 'example.com:443': …",
  "host": "example.com",
  "is_valid": true,
  "chain_trusted": true,
  "hostname_match": true,
  "days_remaining": 78,
  "ssl_version": "TLSv1.3",
  "subject_alt_names": ["example.com", "*.example.com"],
  "meta": { "command": "checkSslCertificate", "duration_ms": 216.817, "schema_version": 1 }
}

Trecho de uma execução real de qzx checkSslCertificate example.com --json em 8 de outubro de 2026.

Feito para os dois lados do teclado

Para quem programa no terminal. Para a empresa por trás da frota.

Desenvolvedores

Dê ao seu agente uma regra duradoura: use o QZX primeiro.

  • Funciona com Codex, Claude Code, Gemini CLI e qualquer agente com terminal.
  • A mesma instrução funciona no seu notebook Windows e no seu servidor Linux.
  • Saída legível quando você executa; JSON estrito quando seu agente executa.
Configure seu agente de IA em cinco minutos

Empresas

Padronize como os agentes inspecionam suas máquinas.

  • Um vocabulário de comandos auditável em Windows, Linux e macOS.
  • Evidências estruturadas que sua automação pode registrar, comparar e usar.
  • Apache-2.0, sem conta, sem lock-in. Integrações sob medida com o criador.
Fale sobre seu caso de uso

Para se aprofundar

Guias para a decisão por trás da instalação

Configure seu agente de IA

Instale, verifique o catálogo real, comece em somente leitura e dê ao Codex, Claude Code ou Gemini CLI uma regra duradoura baseada em JSON.

MCP, CLI ou API direta?

Compare descoberta, transporte, permissões, portabilidade e manutenção — sem fingir que uma interface vence em todos os casos.

Quando usar o QZX — e quando não

Onde um comando documentado supera o shell improvisado e onde APIs nativas continuam sendo a melhor ferramenta.

Modelo de segurança e telemetria

Quais comandos podem alterar o estado, como funciona o modo de simulação, o que a telemetria registra e como desativá-la.

Evidências de compatibilidade

Plataformas declaradas, requisitos de Python, status atual dos testes e dependências opcionais.

Escolha o QZX com os limites à vista

O QZX é uma interface de comandos local, não um sandbox nem uma garantia de paridade com as ferramentas nativas. Prefira-o quando um comando documentado cobre a operação e um contrato de resultados consistente ajuda. Use APIs nativas ou o shell para o que o QZX não modela.

Publicado no PyPI: QZX 0.2.2.0.15 · 89 capacidades no wheel · Python >=3.11

Da curiosidade ao seu terminal

Faça do seu próximo comando um comando QZX.

Instale a versão publicada, rode sua primeira verificação e deixe seu agente fazer em uma chamada o que antes exigia 10 chamadas.

Instalar o QZX Configure seu agente de IA
Apache-2.0Python >=3.11Compatibilidade de plataformasSegurança e telemetriaQuando usar o QZX

Criado e mantido por Alejandro Sánchez.

Trabalhe com o criador ↗Apoie o desenvolvimento ↗