box
Box es una interfaz móvil autoalojada para Claude Code y Codex que ejecuta sesiones de codificación persistentes en tu servidor propio, accesible desde el teléfono con UI nativa, voz y gestión de archivos.
Ficha actualizada 25 sept 2026, 8:54 · upstream 25 sept 2026, 8:43 · release v1.0.0
Qué es box
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Box es una interfaz móvil autoalojada para sesiones reales de Claude Code y Codex que se ejecutan en un servidor que controlas. A diferencia de los agentes alojados en la nube o gestionados por terceros, Box mantiene el filesystem local, las credenciales y el historial de sesiones en tu máquina, permitiendo trabajar de forma autónoma incluso cuando tu portátil está cerrado.
El sistema utiliza `dtach` para mantener las sesiones activas y `cloudflared` para exponer la interfaz sin abrir puertos directos. Soporta integraciones con Linear (con clon local por defecto), Slack, Google Workspace y servicios de voz como ElevenLabs o Deepgram. Las sesiones guardan su estado en ~/.claude y el store de Box, permitiendo reanudar trabajos días después.
La arquitectura está basada en Node.js 18+, con un servidor que se ejecuta detrás de un túnel Cloudflare por defecto. El instalador gestiona automáticamente las dependencias como git, dtach y cloudflared. La configuración se realiza mediante variables de entorno en .env, incluyendo tokens de acceso, claves API opcionales y configuraciones de integración.
- Ejecutar sesiones largas de codificación que continúan funcionando mientras el portátil está cerrado o en modo suspensión
- Gestionar tickets de Linear desde el móvil con delegación entre agentes Claude Code y Codex sin necesidad de cuenta externa
- Colaboración compartida mediante códigos de invitación que otorgan acceso a carpetas específicas y claves API publicadas por el equipo
- Integración con Slack para obtener contexto de canales, DMs y búsqueda de mensajes en tiempo real durante las sesiones
- Dictado de prompts complejos mediante voz usando ElevenLabs o Deepgram con soporte multilingüe (Mandarin con ElevenLabs)
- Gestión de múltiples repositorios y proyectos desde un único punto sin sandboxing, permitiendo navegación completa del filesystem local
- Sesiones persistentes que sobreviven a cierres de sesión o reinicios controlados mediante dtach
- Linear local por defecto con clon SQLite, eliminando la dependencia de una cuenta externa hasta que se desea conectarla
- Compartición granular de carpetas y claves API mediante códigos de invitación sin sandboxing, actuando como límite de confianza
- Soporte nativo para voz con ElevenLabs (mejor precisión, multilingüe) o Deepgram (más rápido, inglés)
- Integraciones opcionales con Google Workspace (Gmail/Calendar/Drive OAuth) y Slack (lectura de canales y búsqueda)
- Historial real de sesiones en ~/.claude y store de Box, permitiendo reanudar, bifurcar o buscar trabajos anteriores
- Requiere una máquina siempre encendida con acceso SSH; no es un servicio serverless ni escalable horizontalmente
- No incluye Docker ni Compose por defecto; el despliegue manual requiere gestionar procesos y dependencias directamente
- La integración de Linear local tiene límites en búsquedas y contexto comparado con una cuenta real conectada
- El túnel Cloudflare gratuito cambia la URL periódicamente en modo 'quick'; el modo 'named' requiere configuración adicional
- Las sesiones comparten el mismo usuario Unix; compartir acceso implica dar permisos de shell a los invitados
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Despliega en un VPS Linux o macOS siempre encendido. Ejecuta `git clone` y `./install.sh` o usa el script bootstrap para instalación rápida. Asegura que Node 18+, git, dtach y cloudflared estén instalados. Configura .env con CC_AUTH_TOKEN, PORT (default 7321), TUNNEL_MODE (quick/named/none) y claves API opcionales. Para producción, usa TUNNEL_MODE=named con un dominio propio. Revisa ~/.cc-mobile/prompt-overrides.json para personalizar prompts y ~/.claude/hooks/ para scripts personalizados.
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.