home-assistant-codex-persistence
Proyecto beta independiente que persiste el estado del agente Codex en Home Assistant Studio Code Server tras reinicios o actualizaciones de contenedores, manteniendo sesiones, credenciales GitHub CLI, proyectos y memorias locales sin modificar el núcleo de Home Assistant ni redistribuir…
Ficha actualizada 26 sept 2026, 10:16 · upstream 26 sept 2026, 10:12 · release sin release detectada
Qué es home-assistant-codex-persistence
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
home-assistant-codex-persistence es un instalador e integración de arranque para entornos Home Assistant que garantiza la persistencia del espacio de trabajo de Codex dentro de Studio Code Server. Mantiene sesiones, autenticaciones, configuración y herramientas disponibles tras reinicios o recreación de contenedores mediante una capa de persistencia reproducible entre el almacenamiento de Home Assistant y el estado local de Codex.
El proyecto no es un add-on oficial ni redistribuye Home Assistant, Studio Code Server, OpenAI Codex, GitHub CLI ni Visual Studio Code. Funciona como complemento independiente que conecta las rutas estándar del contenedor con almacenamiento persistente privado, validando autenticación en modo lectura y proporcionando perfiles de acceso explícitos para entornos protegidos donde sandbox bwrap no está disponible.
La documentación incluye guías de instalación, arquitectura, pruebas de ciclo de vida tras actualizaciones (6.0.1→7.0.0→7.1.1), evidencia de auditoría post-reinicio y procedimientos de recuperación. El proyecto opera bajo licencia MIT sin garantía y recomienda copias de seguridad del sistema antes de instalar.
- Recuperar sesiones de Codex, proyectos y memorias locales tras reinicio o actualización del add-on Studio Code Server
- Mantener autenticación persistente para GitHub CLI y credenciales HTTPS Git sin reautenticar tras cada ciclo de vida del contenedor
- Activar y preservar configuraciones de memorias locales gestionadas por Codex cuando el operador habilita la característica separada
- Auditar acceso en entornos protegidos donde bwrap no está disponible mediante perfiles explícitos de container-access
- Validar compatibilidad con actualizaciones de code-server (ej. 4.137.0) y mantener continuidad del espacio de trabajo tras migración de contenedores
- Persistencia verificada en actualizaciones reales de Studio Code Server desde 6.0.1 hasta 7.1.1 con supervivencia de sesiones, credenciales y proyectos
- Soporte para entornos sin bwrap mediante perfiles explícitos de acceso activados por el operador (danger-full-access/on-request/user)
- Validación de compatibilidad con code-server 4.137.0 y OpenAI Codex CLI 0.157.1 sin introducir CLIs personalizados
- Auditoría de lectura en modo supervisor tras reinicio completo del host Home Assistant OS
- Separación clara entre Core Knowledge y memorias locales, evitando mezcla de datos o funcionalidades no solicitadas
- Proyecto beta sin garantía; requiere copias de seguridad previas y prueba en infraestructura no crítica antes de producción
- Detección automática de chat remoto puede fallar en clientes iOS según evidencia del sistema de referencia
- Dependencia de Home Assistant OS y add-on Studio Code Server comunitario (no oficial)
- No incluye Docker, Dockerfile ni compose; requiere integración manual con almacenamiento persistente de HAOS
- Algunas funcionalidades como activación de memorias locales requieren habilitación explícita del operador mediante flags de Codex
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.
Instalar siguiendo la guía oficial en docs/INSTALLATION.md. Realizar copia de seguridad completa del sistema Home Assistant antes de instalar. Probar primero en infraestructura no crítica. Validar acceso explícito (danger-full-access/on-request/user) tras instalación. Verificar auditoría de lectura en modo supervisor post-reinicio. No usar comandos abreviados copiados de issues o discusiones.
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.