Catálogo canónico

Documentación de comandos QZX

Este catálogo documenta el checkout de desarrollo actual e identifica qué capacidades también están presentes en el wheel publicado de PyPI 0.2.2.0.2. Los nombres usan camel case con inicial minúscula y se aceptan sin distinguir mayúsculas.

Texto legible por defecto

Ejecuta qzx <comando> para obtener texto legible. Usa --json cuando el consumidor necesite el objeto estructurado completo.

Canal explícito

Cada referencia indica si el comando está incluido en PyPI 0.2.2.0.2 o si solo existe en el checkout de desarrollo 0.2.2.0.2.

Evidencia delimitada

Las capturas observadas aparecen únicamente cuando fueron registradas. Las demás páginas muestran el contrato base sin inventar campos específicos.

Ver transcripciones completas Revisar compatibilidad Entender mutaciones y confianza

Configuración de la CLI

Variables de entorno

QZX lee estas variables del entorno del proceso. Un valor definido en la terminal afecta a los comandos iniciados desde esa sesión; al eliminarlo, QZX vuelve al comportamiento predeterminado.

Precaución: QZX_SAFETY=YOLO desactiva una barrera de recuperación para todos los comandos de alto riesgo de la sesión. No la conviertas en una configuración permanente.

Seguridad y respaldos

Controlan la protección previa a operaciones de alto riesgo y el archivo que QZX crea antes de modificar datos.

QZX_SAFETYAlto riesgo

Con YOLO omite globalmente la aprobación y el respaldo de seguridad de los comandos de alto riesgo. Equivale a usar --yolo en cada operación y debe limitarse a sesiones controladas.

Valores: YOLO
Predeterminado: protección activa

QZX_BACKUPS_PATH

Cambia el directorio donde QZX guarda los respaldos automáticos. Las rutas con ~ y variables del sistema se expanden antes de crear el archivo.

Valores: ruta de directorio
Predeterminado: ~/QZX-Backups

QZX_BACKUPS_FORMAT

Elige el contenedor del respaldo. ZIP y TAR.GZ admiten compresión; TAR conserva los datos sin comprimir.

Valores: ZIP · TAR.GZ · TAR
Predeterminado: ZIP

QZX_BACKUPS_COMPRESSION

Ajusta la compresión. 0 almacena sin comprimir y 9 prioriza el menor tamaño; en formato TAR el valor efectivo siempre es store.

Valores: store · fastest · fast · normal · maximum · 0–9
Predeterminado: fastest

Privacidad, diagnóstico e integraciones

Configuran la telemetría seudónima de la CLI, su estado local y servicios opcionales.

QZX_TELEMETRY

Usa 0 para desactivar la telemetría de activación o 1 para activarla explícitamente. QZX_TELEMETRY=1 tiene prioridad sobre DO_NOT_TRACK=1.

Valores: 0 · 1
Predeterminado: 1 (activada)

DO_NOT_TRACK

Desactiva la telemetría cuando vale 1, salvo que QZX_TELEMETRY la active o desactive explícitamente.

Valores: 1
Predeterminado: sin definir

QZX_TELEMETRY_STATE_DIR

Cambia la ubicación del estado local seudónimo de telemetría; resulta útil en instalaciones portables y pruebas.

Valores: ruta de directorio
Predeterminado: directorio de datos del sistema

QZX_TELEMETRY_DEBUG

Escribe diagnósticos de entrega de telemetría en stderr. No cambia el resultado del comando.

Valores: 1 · true · yes · on · enabled
Predeterminado: desactivada

GEMINI_API_TOKENSecreto

Credencial requerida por generateContent. También puede cargarse desde un archivo .env; trátala como secreto y no la publiques ni la incluyas en el control de versiones.

Valores: token de API
Predeterminado: sin definir

Ejemplos por terminal

Las asignaciones exportadas duran hasta que cierres la sesión o elimines la variable. Sustituye los valores según tu política.

Linux / macOS / POSIX

QZX_TELEMETRY=0 qzx Welcome
export QZX_BACKUPS_FORMAT=TAR.GZ
export QZX_BACKUPS_COMPRESSION=fastest

Windows PowerShell

$env:QZX_TELEMETRY = "0"
$env:QZX_BACKUPS_FORMAT = "TAR.GZ"
$env:QZX_BACKUPS_COMPRESSION = "fastest"

93 comandos documentados

Referencia indexable por comando

Cada enlace abre una página SSR con sintaxis, parámetros, disponibilidad, riesgos, ejemplos y evidencia de implementación.

93 incluidos en PyPI 0.2.2.0.20 solo en el checkout de desarrollo 0.2.2.0.2