Enfoque

Xzp no busca reemplazar la shell. Su objetivo es recortar trabajo repetitivo:

• detectar contexto de proyecto sin reconstruirlo a mano
• buscar y recorrer estructura con menos comandos auxiliares
• mantener portapapeles, favoritos y atajos persistidos
• abrir shells guiadas para Android storage o proyectos seguros
• exponer salidas legibles en texto y consumibles en JSON

Estado de la versión 1.1.0

La 1.1.0 consolida lo que la 1.0.1 dejó abierto e introduce las primeras funciones que entran en fase beta activa. La base visual, el modo agente y los flujos de contexto se estabilizan; el navegador Android y el sistema de idiomas avanzan como capacidades en progreso real.

Novedades principales

• navegador Android visual con movilidad tipo tree — flechitas, Enter/Esc y Ctrl+G (beta)
• sistema de localización con co_es, en y ru — cobertura parcial (beta)
• modo agente con defaults más estables, contexto persistido y mejor orientación a JSON
• ayuda, menú y pantallas TTY con una presentación más clara y más agradable de leer
• mejores flujos para contexto, diagnóstico, reportes y accesos seguros

Parches y mejoras

• endurecimiento de rutas, nombres persistidos y manejo de errores
• mejoras de empaquetado, ayuda principal y verificación de versión
• ajustes de portapapeles, reportes Markdown/JSON y contratos de salida
• cobertura de pruebas más amplia para comandos clave y utilidades compartidas

Instalación

npm i -g @nyxur/xzp

Ejecución local:

node ./bin/xzp --help

Comandos principales

| Categoría | Comando | Descripción | | :--- | :--- | :--- | | Interfaz | xzp -m | Menú interactivo | | Agente | xzp --agent-status | Estado del modo agente | | Contexto | xzp -x --profile | Contexto y perfil del proyecto | | Exploración | xzp -b "api client" --semantic | Búsqueda por patrón | | Árbol | xzp -t . --depth 3 --summary | Árbol y resumen | | Auditoría | xzp --doctor | Diagnóstico del entorno | | Inspección | xzp --inspect | Inspección rápida del proyecto actual | | Acceso | xzp -a | Navegador Android / acceso Linux | | Shell segura | xzp -r | Shell segura por lenguaje | | Reporte | xzp --report-error | Preparación de reporte de fallo |

Modo Agente

Xzp puede operar con defaults más estables para automatización:

xzp --agent-on
xzp --agent-status
xzp --agent-context

Al activarse, prioriza JSON en comandos compatibles y genera un contexto persistido en:

~/.config/xzp/agents/xzp-agent-context.md

Ese archivo existe para que un agente use primero comandos de Xzp antes de caer en combinaciones repetitivas de shell.

Configuración

El estado de usuario se guarda en:

~/.config/xzp/config.json

Desde ahí se controlan:

• funciones activas
• favoritos y atajos seguros
• historial reciente
• exclusiones de búsqueda
• modo de plataforma
• preferencias visuales
• locale por defecto

Funciones Beta

Las siguientes funciones están activas pero en desarrollo continuo. Su comportamiento puede cambiar entre versiones menores.

Navegador Android

xzp -a abre un navegador visual de carpetas sobre el storage de Android. La movilidad es tipo tree: solo se navega entre carpetas, sin mezclar archivos en la vista.

↑/↓ move  ·  Enter/→ enter  ·  Esc/← up  ·  Ctrl+G use path

| Acción | Resultado | | :--- | :--- | | ↑ / ↓ | moverse entre carpetas de la lista | | Enter o → | entrar a la carpeta seleccionada | | Esc o ← | subir al directorio padre | | Ctrl+G | activar/desactivar el navegador; usa la ruta actual |

Al seleccionar Use this folder, Xzp abre una shell en esa ruta y copia el path al clipboard interno. La vista pagina el contenido cuando hay muchas carpetas (Page 1/2, Page 2/2...) y filtra entradas no navegables para mantener la lista limpia.

Ejemplo: usas xzp -a Por Defecto Ya Va A Venir Activado Cuando Elijas Tu Carpeta Y Termines De Usarla Y Quieres Volver A Activar El Modo De Navegación Usas CRL + G

Sistema de idiomas

Xzp incluye soporte inicial para tres locales: co_es (español colombiano), en (inglés) y ru (ruso). El locale activo se configura en ~/.config/xzp/config.json.

Estado actual: la cobertura es parcial. Varios comandos y acciones aún muestran texto en el idioma base (co_es) independientemente del locale configurado. La traducción completa está en progreso y se irá extendiendo en versiones siguientes.

{
  "locale": "en"
}

Si encontrás texto sin traducir en en o ru, es esperado en esta fase.

Localización

La base de mensajes compartidos se carga desde data/locales/co_es.json. co_es es el locale inicial y sirve como referencia para las demás variantes.

Documentación interna

• .internal-docs/CORTE_CONTEXTO_ACTUAL.md: estado técnico resumido
• .internal-docs/PLAN_CONTINUACION.md: dirección de trabajo y prioridades
• .internal-docs/ANDROID_NAVIGATION_MODE.md: criterio del modo Android
• .internal-docs/RELEASE_CHECKLIST.md: control previo a publicación
• .internal-docs/registro/: notas internas de versión y resumen de releases
• REYES.md: arquitectura y bloques de evolución

Desarrollo

npm test

Si vas a tocar comandos, prioriza mantener dos contratos:

• salida legible en texto para uso humano
• salida estable en JSON para automatización