Diagnóstico de proyecto
Comprende un código que no conoces
Muestra tecnologías, manifiestos de dependencias, estado de Git, cobertura del escaneo y hallazgos concretos antes de que un agente de IA empiece a editar.
qzx diagnoseProject .
QZX — Quick Zap Exchange
QZX: comandos multiplataforma predecibles para agentes de IA
Dale a un agente de IA o a una automatización evidencia estructurada antes de que cambie algo. Inspecciona un proyecto desconocido, diagnostica presión de espacio en disco o usa el mismo vocabulario documentado de sistema, archivos y desarrollo en Windows, Linux y macOS; añade --json cuando otro programa consuma el resultado.
QZX es totalmente gratis y de código abierto. Las donaciones son bienvenidas porque apoyan el desarrollo continuo, pero nunca desbloquean funciones ni cambian la experiencia del producto.
Instalar la Alpha publicada 0.2.2.0.8
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json
qzx listCommands file
qzx help findFiles- Primer éxito: Confirma QZX con una marca de tiempo ISO rápida y de solo lectura.
- Explora: Filtra el catálogo instalado para ver comandos relacionados con archivos.
- Comprende: Revisa parámetros, ejemplos, madurez y seguridad antes de ejecutar.
Estos comandos provienen del mismo contrato de onboarding versionado que viaja dentro del wheel y se verifica contra el checkout vigente, PyPI, GitHub y este sitio.
¿Prefieres una CLI aislada? pipx install qzx mantiene las dependencias Python de QZX separadas de los entornos de tus proyectos. Si pip muestra externally-managed-environment, usa esta ruta en lugar de forzar el Python del sistema.
El comando de instalación principal se genera desde el canal publicado vigente de QZX, así que no necesitas recordar las reglas de pre-releases de PyPI. QZX sigue siendo software Alpha; verifica la identidad instalada con qzx version --json.
Empieza con un problema real
Obtén evidencia útil antes de cambiar algo
La Alpha publicada ya incluye flujos completos de solo lectura para dos tareas comunes. Ejecuta uno como diagnóstico legible o añade --json cuando un agente o programa deba consumir la evidencia.
Diagnóstico de almacenamiento
Descubre qué está consumiendo el disco
Mide capacidad, muestra los archivos más grandes y verifica evidencia de duplicados sin borrar ni modificar nada.
qzx diagnoseStorage .
QZX es creado y mantenido por Alejandro Sánchez. Si la CLI gratuita resuelve parte de tu flujo pero necesitas una integración, automatización o implementación a medida, hay un camino directo para trabajar con su creador. El apoyo opcional ayuda a mantener el proyecto de código abierto.
Un resultado observado
Una interfaz documentada en lugar de tres ramas de fecha
La captura de QZX es stdout completo de una ejecución real en Windows 11 10.0.26200 con QZX 0.2.2.0.8 y CPython 3.13.13; no se inventaron campos.
Sin QZX
Windows PowerShell
(Get-Date).ToString("o")Linux
date --iso-8601=secondsmacOS
date +%Y-%m-%dT%H:%M:%S%zCon QZX
qzx getCurrentDateTime --output-format iso --json{
"success": true,
"message": "Current local date and time (ISO 8601): 2026-09-08T19:19:57.029830-05:00.",
"output": "2026-09-08T19:19:57.029830-05:00",
"output_format": "iso",
"date": {
"year": 2026,
"month": 9,
"month_name": "September",
"day": 8,
"day_of_week": "Tuesday",
"day_of_year": 251,
"iso_week": 37,
"iso_week_year": 2026,
"quarter": 3,
"is_leap_year": false
},
"time": {
"hour_24": 19,
"hour_12": 7,
"minute": 19,
"second": 57,
"microsecond": 29830,
"am_pm": "PM",
"timezone": "Hora est. Pacífico, Sudamérica",
"utc_offset": "-05:00"
},
"timestamp": 1788913197,
"iso_format": "2026-09-08T19:19:57.029830-05:00",
"meta": {
"command": "getCurrentDateTime",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 2.348,
"schema_version": 1
}
}Capturado el 8 de septiembre de 2026; la fecha y la duración cambian en cada ejecución. Ver la referencia y la evidencia.
Qué cambia la interfaz
Un contrato más pequeño para el trabajo compatible
Un vocabulario documentado
Usa el mismo nombre de comando en equipos compatibles en vez de mantener una instrucción diferente para cada shell.
Salida explícita para máquinas
Solicita JSON deliberadamente con --json e inspecciona success, message y los campos propios del comando.
Límites visibles
La disponibilidad, dependencias, mutaciones, respaldos y evidencia observada quedan documentadas en vez de insinuarse.
Un contrato abierto que otros pueden implementar
QZX Result Contract v1 vuelve descargable la promesa
El núcleo estable es deliberadamente pequeño: cada resultado JSON incluye un success booleano explícito y un message útil y no vacío. Cada comando añade evidencia tipada sin obligar a operaciones distintas a compartir un payload rígido.
{
"success": true,
"message": "Current local date and time returned in ISO 8601 format.",
"output": "2026-08-07T21:45:00-05:00",
"meta": {
"command": "getCurrentDateTime",
"duration_ms": 2.4,
"schema_version": 1
}
}Comienza en cinco minutos
Un primer flujo más seguro para agentes con terminal
Instala QZX, verifica el catálogo local real, comienza con comandos de solo lectura y ofrece a Codex, Claude Code, Gemini CLI u otro agente una política duradera centrada en JSON.
Abrir el inicio rápido para agentesGuía de arquitectura
¿MCP, CLI o API directa?
Compara descubrimiento, transporte, permisos, portabilidad y mantenimiento sin fingir que una interfaz gana en cualquier carga.
Leer la guía MCP vs CLI vs APICanal publicado
PyPI 0.2.2.0.8
El wheel oficial inspeccionado contiene 88 formas históricas de comandos que se normalizan en 88 capacidades del catálogo actual. Sus metadatos publicados declaran Python >=3.11.
Documentación de desarrollo
Checkout 0.2.2.0.8
El catálogo actual documenta 88 comandos: las 88 capacidades reconciliadas con el wheel y 0 capacidades solo de desarrollo. El checkout exige Python >=3.11.
QZX soporta CPython estándar 3.11 o posterior. Su matriz de certificación multiplataforma utiliza CPython 3.13.x estándar; las compilaciones experimentales free-threaded de CPython, PyPy y otras implementaciones no están certificadas. Consulta la evidencia de compatibilidad.
Elige QZX con sus límites a la vista
QZX es una interfaz de comandos local, no un sandbox ni una garantía de paridad nativa. Úsalo cuando una operación documentada cubra la necesidad y resulte útil un contrato consistente. Usa APIs nativas o el shell para capacidades que QZX no modela.