codex-bridge
Puente de aplicación en Rust que conecta una interfaz web/CLI con el servidor de aplicaciones de OpenAI Codex, permitiendo gestionar tareas y sesiones desde múltiples dispositivos sin depender de la app ChatGPT como intermediario.
Ficha actualizada 22 sept 2026, 16:18 · upstream 21 sept 2026, 4:14 · release v0.3.2
Qué es codex-bridge
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
codex-bridge es un daemon local escrito en Rust que actúa como proxy seguro entre clientes (Web UI o CLI) y el servidor backend de Codex. Proporciona una lista de tareas compartida persistente, permitiendo continuar sesiones desde múltiples dispositivos mientras mantiene el contexto en el repositorio local. El sistema soporta dos modos de despliegue: standalone (recomendado), donde supervisa un app-server independiente vía socket Unix, y un modo avanzado para macOS que interfiere con la app ChatGPT Desktop para gestionar su ciclo de vida sin parchear el bundle.
La arquitectura incluye componentes como codexctl (cliente CLI), una interfaz web responsiva construida con Vite embebida en tiempo de compilación, y un simulador Rust/WASM para demos. El sistema maneja colas de tareas, control de herramientas en vivo, transcripción de voz opcional con whisper.cpp local, y gestión segura de descargas mediante tickets efímeros que evitan endpoints públicos anónimos.
El protocolo typed local mantiene el historial y metadatos sin depender de relays externos como ChatGPT app. Incluye soporte para Cloudflare Access, proxies inversos autenticados y configuración vía TOML con permisos restrictivos (0700/0600) para sockets y directorios.
- Gestión remota de sesiones de Codex desde navegadores web o CLI sin exponer el servidor directamente
- Supervisión y control de tareas en ejecución (cola, pausa, interrupción) desde múltiples dispositivos
- Despliegue en homelabs o NAS con acceso seguro mediante proxies inversos autenticados o Cloudflare Access
- Transcripción de voz local privada utilizando whisper.cpp como fallback para entornos offline
- Gestión de rollouts y actualizaciones del servidor de aplicaciones desde una interfaz centralizada
- Escrito en Rust con embebido de frontend Vite, garantizando rendimiento y seguridad tipo compilación estática
- Soporte nativo para sockets Unix y gestión segura de sesiones sin autenticación básica persistente
- Capacidad de interposición sobre la app ChatGPT Desktop en macOS para gestionar su ciclo de vida atómico
- Implementación de tickets efímeros para descargas que expiran tras 5 minutos, mitigando riesgos de acceso no autorizado
- Protocolo typed local que mantiene el historial y metadatos sin depender de relays externos como ChatGPT app
- Requiere instalación manual de dependencias (Cargo binaries) y configuración de sockets Unix en entornos Linux/macOS
- El modo standalone no permite escritura directa en sesiones ocupadas por otros clientes sin liberar el lock explícitamente
- La interfaz web embebida requiere reconstrucción del frontend antes de recompilar el binario Rust tras cambios en UI
- Las descargas de archivos están limitadas a 16 MiB y requieren resolución de workspace para evitar escapes de ruta
- No incluye Dockerfile ni soporte nativo para contenedores, requiriendo instalación manual en cada host
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.
Desplegar como servicio systemd o launchd con permisos restrictivos (0700/0600). Usar loopback por defecto y exponer solo tras autenticación o proxy seguro. Configurar config.toml para definir socket, caché y opciones de voz. En macOS, usar install-macos.sh --web-ui para standalone o añadir --desktop para interposición avanzada. Validar siempre que el listener esté en 127.0.0.1 si se usa autenticación básica.
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.