codex-mobile
Interfaz web móvil auto-alojada para controlar localmente tu CLI Codex. Soporta autenticación nativa (ChatGPT, API key, gateways personalizados). PWA con soporte offline, gestión de sesiones en ~/.codex y aprobaciones de escritura.
Ficha actualizada 22 sept 2026, 18:08 · upstream 22 sept 2026, 17:15 · release sin release detectada
Qué es codex-mobile
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
codex-mobile es una interfaz web auto-alojada que permite controlar tu instancia local de Codex CLI desde el móvil. Utiliza la arquitectura stdio/JSON-RPC 2.0 para comunicarse con el proceso codex app-server en tu máquina, sin actuar como agente ni servicio en la nube.
Soporta sesiones nativas de Codex almacenadas en ~/.codex, permitiendo continuar conversaciones iniciadas en móvil desde la terminal. Implementa PWA con Service Worker para funcionamiento offline, sincronización de mensajes vía IndexedDB y notificaciones Web Push. Soporta tres modos de autenticación: cuenta oficial ChatGPT, API key o gateways personalizados (custom base_url).
La seguridad se basa en tokens de 64 bits, handshake de emparejamiento de dispositivos y limitación de tasa por ventana. Por defecto solo escucha en 127.0.0.1; exponer requiere configuración explícita de whitelist de origen. Las políticas de aprobación (workspace-write) y sandbox se ejecutan localmente en el servidor Codex, sin bypass.
- Control remoto de CLI Codex desde móvil con sesiones persistentes
- Gestión de aprobaciones para escritura en workspace (on-request)
- Revisión de diffs y código con soporte offline PWA
- Integración con gateways personalizados o modelos self-hosted
- Continuar conversaciones iniciadas en terminal desde el móvil
- Arquitectura segura vía stdio sin exponer tráfico a servidores externos
- Compatibilidad nativa con CLI Codex local y sesiones ~/.codex
- PWA instalable con sincronización offline y notificaciones Web Push
- Soporte para autenticación API key o gateways personalizados (custom base_url)
- Gestión de aprobaciones y sandbox ejecutada por el servidor Codex local
- Requiere Node.js >= 20 y CLI Codex compatible con protocolo actual
- Acceso externo no habilitado por defecto (bind 127.0.0.1)
- Sin panel detallado de uso para API keys o gateways personalizados
- Dependiente de la versión de Codex CLI local para compatibilidad de protocolo
- Configuración manual requerida para whitelist de origen si se expone
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Node.js >= 20 y CLI Codex instalado localmente. Ejecutar npm run setup antes de iniciar para configurar workspace, bind address y token. Para acceso remoto, cambiar bind a 0.0.0.0 y configurar whitelist de origen en el wizard. Verificar compatibilidad con versión de Codex CLI usando npm run protocol:check. Instalar como PWA en móvil para soporte offline.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.