Saltar al contenido principal

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

10 comandos.
Un solo zap.

Tu agente de IA quema turnos improvisando shell: Git por aquí, manifiestos por allá, DNS, TLS, HTTP, escaneos de disco, búsqueda de duplicados… y cada sistema operativo lo escribe distinto. QZX hace ese trabajo en un solo comando multiplataforma y te devuelve respuestas accionables. Legibles para ti. JSON estructurado para tu agente.

Mira la carrera
Llamadas a herramientas
21 → 318 idas y vueltas menos
Shell que escribe tu agente
28× menos664 → 24 tokens
Más rápido
1,9×26,4 s → 13,6 s

Medido en tres diagnósticos cotidianos, en la misma máquina y el mismo día. Cómo lo medimos

QZX / Ejemplo registrado
qzx diagnoseProject . --json

Entiende antes de editar

Un informe del proyecto, en un comando.

TecnologíaPython
Paquete declaradohttpx
1 hallazgo

No se detectó un repositorio Git.

Próximas comprobacionespytest · ruffConfiguradas · sin ejecutar
Inspeccionar el 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"
            }
        }
    }
}

Muestra registrada: project-doctor. Campos seleccionados del resultado real.

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

Resultados registrados por el pipeline de documentación. JSON mostrado como extractos revisados. Explora el contrato de resultados

Instala. Verifica. Listo.Alpha 0.2.2.0.15
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json
Guía de instalación PyPI ↗ Más ejemplos
¿Prefieres una instalación aislada?

Usa pipx para mantener QZX separado de las dependencias de Python de tu proyecto.

Gratis y de código abierto · Sin cuenta · Alejandro Sánchez

Un mismo vocabulario en cada máquina.

WindowsLinuxmacOS

Como en casa en la terminal de tu agente.

CodexClaude CodeGemini CLI

Medido, no imaginado

La misma evidencia.
Un solo comando.

Ejecutamos cada diagnóstico de dos formas en la misma máquina: con los comandos nativos que escribiría un agente, una llamada a la vez, y con el único comando de QZX. Elige una tarea y mira la carrera.

Sin 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
…y se escribe distinto en Linux (10) y 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 que unir antes de la primera edición.

Con QZX · cualquier SO1 comando · 8,0 s
qzx diagnoseProject .
  • Tecnologías
  • Dependencias
  • Entorno
  • Tests y lint
  • Estado de Git
  • Análisis del código
  • Archivos grandes
  • Hallazgos

1,3× más rápido. Un solo informe con hallazgos y las próximas comprobaciones.

La animación está acelerada; los segundos mostrados son los tiempos reales medidos.

Cómo lo medimos: el 2026-10-08, en Windows 11 10.0.26200 con QZX 0.2.2.0.14. Cada comando nativo se ejecutó en un proceso nuevo de PowerShell 7, como una llamada separada del agente, con selecciones de columnas mínimas que favorecen al lado nativo. Tokens contados con tiktoken o200k_base. Las variantes de Linux y macOS se muestran como referencia y no se cronometraron. Los resultados de QZX además traen conclusiones —puntajes, la capa que falla, recomendaciones— que la salida nativa deja para que tu agente las razone.

Cómo funciona

Tu agente pide una vez. QZX se encarga de la plataforma.

QZX es una CLI de Python de código abierto. Tú o tu agente llaman a un comando documentado; QZX hace el trabajo específico de Windows, Linux o macOS y responde con la misma forma en todas partes: un resumen legible para personas y JSON estructurado con --json para programas.

  1. Instala

    Un paquete de PyPI, con pip o pipx. Sin cuenta, sin servidor, sin servicio en segundo plano.

  2. Pide la tarea

    Llama al comando por su nombre, por ejemplo qzx inspectPort 3000. Se escribe igual en todos los sistemas compatibles.

  3. Lee o procesa

    Las personas reciben un resumen. Los agentes añaden --json, comprueban success, leen message y usan la evidencia tipada.

Diagrama que muestra a Codex, Claude Code, Gemini CLI y scripts llamando a un mismo comando QZX en Windows, Linux y macOS, y recibiendo los campos compartidos success, message, output y meta.
Un comando documentado puede cubrir trabajo compatible en varios equipos mientras el núcleo compartido del resultado sigue siendo predecible. Los límites de cada plataforma y la evidencia propia de cada comando se muestran de forma explícita.

Una docena de tareas cotidianas

Cada tarjeta muestra lo que tú o tu agente escribirían sin QZX —distinto en Windows, Linux y macOS— junto al único comando QZX que hace el mismo trabajo. Todos los comandos QZX de abajo son de solo lectura y se ejecutaron al preparar esta página.

Sistema

¿Quién está ocupando el puerto 3000?

Libre u ocupado, y el proceso dueño: se inspecciona, nunca se mata.

Sin QZX

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

Con QZX

qzx inspectPort 3000
Documentación del comando

Red

¿Este certificado TLS está sano?

Fechas de validez, confianza de la cadena, cobertura del nombre, versión TLS y días restantes, como campos.

Sin QZX

WindowsSin OpenSSL por defecto: hay que escribir un script .NET con SslStream
Linux · macOSopenssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -dates -subject -ext subjectAltName

Con QZX

qzx checkSslCertificate example.com
Documentación del comando

Red

¿Qué dicen los registros DNS?

A, AAAA, MX, TXT, NS y CNAME en una sola llamada y un solo resultado.

Sin 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

Con QZX

qzx checkDns example.com
Documentación del comando

Archivos

¿Qué archivos son duplicados exactos?

Tamaño, SHA-256 y confirmación byte a byte. No se borra nada.

Sin 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]++'

Con QZX

qzx findDuplicateFiles Pictures
Documentación del comando

Archivos

¿Cuáles son los archivos más grandes aquí?

Filtra por tamaño y fecha, ordena y limita, con metadatos estructurados de cada archivo.

Sin 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

Con QZX

qzx findFiles Downloads "*" --min-size 100MiB --sort-by size --descending true --limit 20
Documentación del comando

Archivos

¿Esta descarga coincide con su checksum?

SHA-256 por defecto, MD5 o SHA-1 si lo pides: el mismo verbo en todos los sistemas.

Sin QZX

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

Con QZX

qzx calculateFileHash release.zip
Documentación del comando

Desarrollo

¿En qué estado está este repositorio?

Rama, remoto, cambios pendientes y commits recientes en una sola foto estructurada.

Sin QZX

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

Con QZX

qzx getGitStatus
Documentación del comando

Desarrollo

Muéstrame la estructura del proyecto.

Un árbol acotado: ASCII para ti, JSON para tu agente, sin seguir enlaces simbólicos.

Sin QZX

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

Con QZX

qzx getProjectTree src 3
Documentación del comando

Desarrollo

¿Dónde se usa esta variable de entorno?

Referencias en el código más las plantillas .env y .env.example, en un solo informe.

Sin 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*' .

Con QZX

qzx traceEnvVar DATABASE_URL
Documentación del comando

Desarrollo

¿Hay importaciones circulares?

Sigue las importaciones de módulos de forma recursiva y nombra cada ciclo que encuentra.

Sin QZX

Cualquier sistemaSin equivalente integrado: instala una herramienta aparte, específica de cada lenguaje

Con QZX

qzx traceCircularImports src
Documentación del comando

Sistema

¿Qué está consumiendo la memoria?

Los procesos que más memoria usan, con los mismos campos en todos los sistemas.

Sin QZX

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

Con QZX

qzx listProcesses null memory 10
Documentación del comando

Sistema

¿Qué python se ejecuta y está roto el PATH?

Cada coincidencia en el PATH, con las entradas rotas y duplicadas señaladas.

Sin 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

Con QZX

qzx checkSystemPath python
Documentación del comando

Explora los 89 comandos

Por qué desarrolladores y equipos se cambian

Rápido. Cómodo. Y con potencia de sobra.

Menos turnos, menos shell, más resultados

Cada llamada a una herramienta es otro turno del modelo. QZX condensa diagnósticos de varios pasos en uno, así tu agente escribe 28× menos shell (664 → 24 tokens) y se ahorra 18 idas y vueltas, con las conclusiones ya calculadas.

21 → 3

Más rápido de punta a punta

Un proceso en lugar de una cadena de shells. 1,9× más rápido en nuestros tres diagnósticos y 3,0× cuando un sitio web está caído.

3,0×

Un vocabulario, tres sistemas

Deja de ramificar tus prompts por sistema operativo.

Resolve-DnsNamedigopenssl s_clientqzx diagnoseWebsite

89 comandos publicados y contando

Sistema, red, archivos, Git, desarrollo, almacenamiento y scaffolding de proyectos: una sola instalación.

Explora las herramientas

Seguro por defecto

Los diagnósticos son de solo lectura. Los comandos que cambian algo muestran primero una vista previa y conservan sus barreras de respaldo y aprobación.

Seguridad y telemetría

Un contrato en el que tu agente puede confiar

Cada resultado --json trae un success explícito y un message útil, además de evidencia tipada. Nada de raspar tablas ni adivinar por códigos de salida. El esquema es abierto y descargable.

Explora el contrato de resultados

Empieza con un problema real

Útil antes de tu próximo cambio.

Elige la tarea que tienes delante. Empieza con un diagnóstico de solo lectura y decide el siguiente paso.

Reemplaza 10 comandos

Haz familiar un proyecto desconocido.

Descubre tecnologías, dependencias, estado de Git y hallazgos concretos antes de que tu agente empiece a editar.

qzx diagnoseProject .
Explora el flujo de proyectos
Reemplaza 3 pipelines

Descubre qué está llenando tu disco.

Inspecciona capacidad, archivos grandes y evidencia de duplicados. Conoce tus opciones antes de eliminar nada.

qzx diagnoseStorage .
Explora el flujo de almacenamiento
Reemplaza 8 comandos

Ve más allá de «el sitio está caído».

Comprueba DNS, certificados y HTTP de una sola vez. Sigue la evidencia hasta la próxima comprobación.

qzx diagnoseWebsite <url>
Explora el flujo de sitios web

Un contrato abierto que otros pueden implementar

Respuestas en las que tu agente puede confiar, sin interpretar texto

Todo resultado JSON tiene un booleano explícito success y un message útil y no vacío. Después, cada comando añade evidencia tipada —aquí, una comprobación real de certificado— en lugar de un muro de texto que tu agente tenga que interpretar.

Lee la especificación Revisa la madurez del Núcleo Dorado Descarga el 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 }
}

Extracto de una ejecución real de qzx checkSslCertificate example.com --json del 8 de octubre de 2026.

Hecho para ambos lados del teclado

Para quien programa en la terminal. Para la empresa detrás de la flota.

Desarrolladores

Dale a tu agente una regla duradera: usa QZX primero.

  • Funciona con Codex, Claude Code, Gemini CLI y cualquier agente con terminal.
  • La misma instrucción sirve en tu laptop con Windows y en tu servidor Linux.
  • Salida legible cuando lo ejecutas tú; JSON estricto cuando lo hace tu agente.
Configura tu agente de IA en cinco minutos

Empresas

Estandariza cómo los agentes inspeccionan tus máquinas.

  • Un vocabulario de comandos auditable en Windows, Linux y macOS.
  • Evidencia estructurada que tu automatización puede registrar, comparar y usar.
  • Apache-2.0, sin cuenta, sin dependencia de proveedor. Integraciones a medida con su creador.
Cuéntanos tu caso de uso

Para profundizar

Guías para la decisión que hay detrás de la instalación

Configura tu agente de IA

Instala, verifica el catálogo real, empieza en solo lectura y dale a Codex, Claude Code o Gemini CLI una regla duradera basada en JSON.

¿MCP, CLI o API directa?

Compara descubrimiento, transporte, permisos, portabilidad y mantenimiento, sin fingir que una interfaz gana en todos los casos.

Cuándo usar QZX y cuándo no

Dónde un comando documentado supera al shell improvisado y dónde las APIs nativas siguen siendo mejor herramienta.

Modelo de seguridad y telemetría

Qué comandos pueden cambiar el estado, cómo funciona el modo de prueba, qué registra la telemetría y cómo desactivarla.

Evidencia de compatibilidad

Plataformas declaradas, requisitos de Python, estado actual de las pruebas y dependencias opcionales.

Elige QZX con los límites a la vista

QZX es una interfaz de comandos local, no un sandbox ni una garantía de paridad con las herramientas nativas. Prefiérelo cuando un comando documentado cubre la operación y un contrato de resultados consistente ayuda. Usa APIs nativas o el shell para lo que QZX no modela.

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

De la curiosidad a tu terminal

Que tu próximo comando sea de QZX.

Instala la versión publicada, ejecuta tu primera comprobación y deja que tu agente haga en una llamada lo que antes requería 10 llamadas.

Instalar QZX Prepara tu agente de IA
Apache-2.0Python >=3.11Compatibilidad de plataformasSeguridad y telemetríaCuándo usar QZX

Creado y mantenido por Alejandro Sánchez.

Trabaja con el creador ↗Apoya el desarrollo ↗