codex-gateway
Codex Gateway es un frontend web y gateway de conexión SSH autocontenido para la aplicación Codex. Permite gestionar sesiones, ejecutar agentes, visualizar estado del servidor y monitorizar recursos sin exponer credenciales a través del navegador.
Ficha actualizada 23 sept 2026, 4:29 · upstream 23 sept 2026, 4:11 · release sin release detectada
Qué es codex-gateway
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Codex Gateway es una interfaz web y punto de entrada de conexión SSH para el servidor oficial de Codex. No replica funcionalmente al servidor original ni ejecuta un runtime de agente en el navegador; la comunicación ocurre exclusivamente entre el navegador y el gateway. El gateway actúa como intermediario que conecta con máquinas remotas mediante SSH, gestiona el ciclo de vida del servidor codex oficial (inicialización, reinicios, actualizaciones), y renderiza visualmente los hilos, eventos, aprobaciones, cambios de archivos, imágenes, diffs y actividad de sub-agentes en una interfaz web.
El objetivo principal es permitir iniciar sesiones de Codex desde múltiples navegadores sin exponer credenciales SSH al navegador. Cuando múltiples clientes (Codex Desktop, otro cliente o el gateway) conectan a la misma instancia del servidor codex, deben observar un mismo flujo de estado. El gateway mantiene una única sesión SSH por host y sincroniza el estado de los hilos entre las pestañas del navegador.
La arquitectura centraliza la gestión de conexiones SSH, actualizaciones del servidor codex remoto, RPCs, terminal PTY directa y proxy HTTP/WebSocket sobre SSH. El frontend renderiza el estado del dominio desde el gateway sin mantener un historial duradero separado.
- Gestionar múltiples sesiones de Codex en diferentes navegadores desde una sola interfaz
- Monitoreo centralizado de hilos, GPU y recursos de entrenamiento/inferencia distribuidos por hosts
- Edición y visualización colaborativa de archivos (Markdown, LaTeX, imágenes, PDF) sin descargas
- Ejecución de comandos remotos en terminal PTY aislada por usuario o host
- Reconstrucción del estado de hilos tras reinicios de servidor codex o desconexión SSH temporal
- Visualización de progreso de objetivos y planificación estructurada con token/time tracking
- El gateway actúa como único punto de control para el ciclo de vida del servidor codex remoto, evitando conflictos entre clientes.
- Soporta múltiples hosts SSH mediante un pool de conexiones compartidas con persistencia de estado por usuario.
- Monitoreo cross-host de tmux permite observar paneles y sesiones en tiempo real desde una sola vista de usuario.
- El frontend renderiza el estado del servidor codex directamente desde la API sin mantener un historial duplicado.
- Soporta visualización de recursos GPU con atribución de PID, runtime y comandos ejecutados por cada trabajo.
- Permite abrir paneles de terminal SSH separados por usuario o host mediante conexiones PTY aisladas.
- El gateway no puede acceder directamente a servidores codex sin un proxy HTTP/WebSocket configurado, lo que limita la escalabilidad en entornos con muchos hosts.
- La sincronización de estado entre pestañas del navegador depende de la persistencia local y puede fallar si el servidor codex se reinicia o desconecta inesperadamente.
- El monitor de tmux requiere configuración manual por host y no detecta automáticamente paneles nuevos en sesiones existentes.
- No existe soporte nativo para SSH proxy (como OpenSSH ProxyCommand) ni para autenticación con claves SSH en el frontend.
- La visualización de archivos remotos depende del navegador cliente, lo que puede limitar la experiencia en navegadores no soportados.
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.
Instala el proyecto con Docker Compose. Configura un entorno seguro mediante .env y cambia la clave secreta por una aleatoria generada con openssl. Conecta el gateway a tu red de redex, inicia el servicio con docker compose up -d y accede al frontend en http://localhost:3000. Para gestionar múltiples hosts SSH, configura las credenciales en el archivo .env.example y añade cada host desde la configuración de usuario. El gateway utiliza un pool de conexiones SSH compartidas que persiste entre reinicios del servicio.
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.