Inicio rápido para agentes de IA

Dale a un agente de IA un flujo predecible con QZX en cinco minutos

Instala el paquete publicado, descubre qué está disponible de verdad, comienza con comandos de solo lectura y solicita JSON que Codex, Claude Code, Gemini CLI u otro agente con terminal pueda interpretar sin adivinar columnas.

Comenzar Ver salidas registradas

Paso 1 · Instala e identifica

Verifica el paquete antes de delegar trabajo

Usa una compilación estándar de CPython que cumpla los metadatos del paquete. Estos comandos instalan la versión publicada actual, la identifican y preguntan a la instalación local por su catálogo real.

python -m pip install --upgrade qzx
qzx version --json
qzx qzxListCommands --json

El sitio puede documentar capacidades de desarrollo más nuevas que el wheel. Considera el catálogo instalado —no un artículo ni un prompt— como la fuente de verdad sobre lo que puede ejecutar este equipo. Revisa la compatibilidad de Python y plataformas.

Paso 2 · Lee antes de escribir

Ejecuta una comprobación pequeña y de solo lectura

qzx about --json
qzx getCurrentDate --json
qzx currentDir --json
qzx qzxHelp findFiles --json

Lo que el agente debe comprobar

  • El proceso termina correctamente y stdout contiene un único documento JSON válido.
  • success es booleano y message explica el resultado.
  • El comando solicitado aparece en qzxListCommands.
  • La página del comando indica si es de solo lectura, mutante, privilegiado o usa red.
  • Los valores propios del equipo siguen siendo reales; lo normalizado es la interfaz.

Paso 3 · Añade instrucciones duraderas

Un bloque de instrucciones que los agentes pueden seguir

Coloca una versión revisada de este bloque en el mecanismo de instrucciones que admita tu agente. Codex puede usar AGENTS.md, Claude Code usa CLAUDE.md y Gemini CLI usa GEMINI.md. La herramienta de terminal debe seguir habilitada conforme al modelo de permisos del producto.

## Política de comandos QZX

- Usa QZX solo cuando un comando documentado coincida con la tarea.
- Antes del primer uso, ejecuta `qzx version --json` y `qzx qzxListCommands --json`.
- Añade `--json` cuando otro programa o agente consuma el resultado.
- Comprueba tanto el código de salida del proceso como el campo `success`.
- Lee `message` y los campos del comando; no deduzcas éxito solo porque falten errores.
- Comienza con comandos de solo lectura.
- Antes de una mutación, revisa la página del comando, el preview/dry-run, la aprobación y el respaldo.
- Si QZX no modela la operación, usa una API nativa mantenida o el shell.
- QZX no es un sandbox y se ejecuta con los permisos del usuario actual.
OpenAI: contexto persistente con AGENTS.md Anthropic: memoria de Claude Code Gemini CLI: contexto GEMINI.md

Paso 4 · Elige la interfaz correcta

QZX es una capa útil, no todas las capas

Usa QZX CLI

Para una operación local documentada de sistema, archivos, desarrollo o red donde ayuden un comando multiplataforma y una salida estructurada.

Usa MCP

Cuando un host compatible con MCP necesite herramientas, recursos o prompts descubribles desde un servidor local o remoto, con ciclo de vida y autorización de protocolo.

Usa una API directa

Cuando el código de una aplicación necesite un SDK tipado mantenido, control dentro del proceso, autenticación propia del servicio o el contrato de dominio más fuerte.

Estas opciones pueden combinarse: un servidor MCP puede llamar a una CLI y una CLI puede usar una API del sistema operativo. La pregunta correcta es qué frontera ofrece al host el contrato más claro con la menor complejidad innecesaria. Lee la guía práctica de MCP vs CLI vs API.

Listo para delegar

Elige un comando de solo lectura y revisa el resultado real

El catálogo documenta disponibilidad, parámetros, propiedades de seguridad, contrato de resultado y si la salida mostrada es registrada o representativa.