@nyxur/opencode

Cliente de OpenCode adaptado para Termux/Android: binario integrado (engine v1.18.18), setup guiado, agente XZP y skills completas. Listo para usar tras un único comando.

Fork no oficial de OpenCode (licencia MIT). El motor y el código original pertenecen a sus autores; este paquete añade la adaptación para Termux/Android.

Requisitos

• Termux en Android (aarch64 recomendado)
• Node.js 18+ (se instala automáticamente con pkg install nodejs)

Instalación

npm install -g @nyxur/opencode

Configuración (primer arranque)

opencode setup

El setup instala paso a paso, en este orden:

1. Base del sistema — pkg update + pkg upgrade
2. Skills — git, python3, curl, ripgrep, jq, yq, unzip, tar
3. Motor glibc — glibc-repo y glibc-runner por separado (instalarlos juntos falla: los repos parecen no existir)
4. Binario arm64 — descargado del release oficial (v1.18.18) y verificado
5. @nyxur/xzp — CLI de navegación y contexto de proyecto
6. Skills del paquete — update-opencode se copia a ~/.config/opencode/skills/

Si la descarga del binario falla, el sistema ejecuta automáticamente el script de recuperación (setup-opencode.sh) sin volver a descargar opencode (variable SKIP_OPENCODE_INSTALL=1).

Inicio rápido

opencode                # inicia el agente
opencode --agent xzp    # con el agente XZP
opencode --bypass       # permisos totales
opencode --version      # versión de paquete y engine

Comandos disponibles

| Comando | Descripción | |---|---| | opencode setup | Instalación interactiva del sistema | | opencode --agent <nombre> | Usar un agente específico | | opencode --no-banner | Omitir el banner animado | | opencode --bypass | Iniciar con permisos totales | | /doctor | Diagnóstico completo (/doctor --fix repara) | | /fix-perms | Reparar permisos del sistema | | /clean | Limpiar caché y temporales | | /version | Información de versión (--json) | | /changelog | Historial de cambios | | /help | Mostrar la ayuda completa |

Agentes

| Comando | Descripción | |---|---| | /agents | Listar agentes configurados | | /create-agent | Crear un agente personalizado | | /delete-agent | Eliminar un agente existente | | /rename-agent | Renombrar un agente existente | | /import-agents | Importar agentes desde archivos .md |

Actualizar

La actualización se hace desde dentro de opencode, pidiendo a la IA que ejecute la skill update-opencode (o escribiendo update-opencode). El flujo automático:

1. Compara la versión instalada con la última disponible en npm/GitHub.
2. Descarga el binario arm64 del release oficial y lo reemplaza.
3. Ejecuta npm install -g @nyxur/opencode@latest @nyxur/xzp@latest.
4. Verifica que paquete y engine coincidan.

Agente XZP

El paquete incluye el agente XZP, preconfigurado con 30 reglas para Termux/Android e integración nativa con @nyxur/xzp:

• Navegación de archivos (xzp -a)
• Contexto de proyecto (xzp context --json)
• Shell segura aislada (xzp -r)
• Copia/pegado entre Termux y Linux (xzp -c, xzp -p)
• Árbol de directorios (xzp -t .)
• Diagnóstico del entorno (xzp doctor)

Solución de problemas

| Problema | Causa | Solución | |---|---|---| | Motor no encontrado | Falta glibc-runner | opencode setup o pkg install glibc-repo -y && pkg install glibc-runner -y | | El engine no coincide con el binario | Versiones desalineadas | Ejecuta la skill update-opencode dentro de opencode | | El setup se queda en la descarga del binario | Red interrumpida | El sistema reintenta 3 veces y usa setup-opencode.sh como fallback | | /doctor marca checks en rojo | Componentes rotos | opencode doctor --fix repara automáticamente | | Permisos denegados al ejecutar | binario sin +x | opencode /fix-perms |

Si nada funciona, ejecuta desde dentro de opencode: update-opencode.

Características

| Característica | Detalle | |---|---| | Binario integrado | Engine v1.18.18 (arm64, verificado) | | Motor glibc | glibc-repo + glibc-runner por separado | | Multi-arquitectura | arm64, x64, arm | | Modelo por defecto | opencode/deepseek-v4-flash-free (gratis, 200K context) | | Actualización | Vía skill update-opencode dentro de la interfaz | | Recuperación | Script setup-opencode.sh como fallback |

Roadmap

• [x] Binario integrado en el paquete
• [x] Setup interactivo guiado
• [x] Sistema de recuperación (fallback a script)
• [x] Skill de actualización dentro de opencode
• [ ] Compresión del binario para npm y git
• [ ] Plugins de terceros

Contribuir

1. Fork del repositorio
2. Rama con la funcionalidad: git checkout -b feature/nombre
3. Commit y push: git commit -m "feat: descripción"
4. Pull request

Licencia

Distribuido bajo la licencia MIT.

El motor y el código de OpenCode original están sujetos a la licencia MIT del proyecto OpenCode y a sus autores. Este paquete solo añade la adaptación para Termux/Android.

Autor

farllirs — GitHub · npm

Nota: Este proyecto es un fork modificado y no oficial. Ver UNOFFICIAL.md.