Sobre el proyecto
Cloudx es un puesto de trabajo local-primero para Codex CLI que se ejecuta en tu propia máquina de construcción Linux y se controla desde un navegador de escritorio o teléfono. El código, las credenciales, las herramientas de shell y el inicio de sesión de Codex permanecen en el host; el proyecto recomienda una tailnet privada y establece que no se admite la exposición a Internet pública. El README advierte que Cloudx puede generar terminales, enviar texto a shells y Codex, leer y editar archivos dentro de las raíces configuradas, e incrustar dashboards locales con URL que portan tokens, y que no autentica clientes LAN directos. Existe un bind explícito a 0.0.0.0 para una LAN de confianza con firewall.
La interfaz es adaptable tanto para escritorio como para teléfono. Los espacios de trabajo son ventanas con respaldo de servidor, con diseños de paneles independientes, directorios de trabajo predeterminados, búsqueda rápida por nombre y búsqueda de contexto asistida por IA. Los paneles se comportan de forma similar a tmux, con pestañas de plugin movibles, y las plantillas de diseño pueden guardar y reabrir una disposición de paneles/pestañas en una ruta de proyecto diferente.
Los plugins y herramientas descritos en el README incluyen: pestañas de terminal de Codex y shell estándar, con pegado de imágenes PNG/JPEG/WebP/GIF del portapapeles en pestañas de Codex guardadas bajo .cloudx/pasted-images e insertadas como referencias @ a archivos; un explorador de archivos con acciones de lectura/escritura expuestas por voz, búsqueda de archivos activos, configuración opcional de Git, insignias de archivos modificados y diffs renderizados por archivo; un gestor de worktree para crear o clonar un repositorio bare y gestionar worktrees de proyecto; un plugin web local para alojar dashboards; un plugin de Jira Cloud para dashboards de issues asignados agrupados por Epics, comentarios, transiciones, enlaces, enlaces del navegador y triggers de automatización por sondeo o manual; y un plugin de archivo de documentación para ingestar archivos, rutas, URL, playlists de YouTube, texto copiado y transcripciones de medios, con búsqueda, inspección de fuentes, invalidación, importaciones en cola e inyección automática de reglas/habilidades de Codex.
Una pestaña de Automatización compone eventos de trigger, hooks de plugin, primitivas y convertidores en graficos guardados, con primitivas de ejecución en Python y Bash y una API cloudx.call_hook. El control por voz utiliza audio del navegador, un servicio Faster Whisper local y un modelo de planner configurado. Cloudx sirve HTTPS en el puerto 3001 con un certificado autofirmado local para el acceso al micrófono.
Las terminales de Codex tienen valores predeterminados gestionados: Codex se ejecuta en modo --yolo explícito, las memorias locales y las Codex Apps están deshabilitadas, los Agent Plugins están deshabilitados, y solo se habilitan las habilidades seleccionadas por Cloudx, del sistema y empaquetadas en el Codex home generado de la pestaña. Al recargar la página se vuelve a adjuntar las pestañas de terminal en ejecución con un búfer de reproducción; reiniciar el servicio Cloudx finaliza esos procesos. Los modos de reanudación (picker, last, ID) utilizan sesiones compartidas.
Componentes del repositorio: apps/server (servidor Fastify, host de plugin, sesiones, terminales, proxy local-web, puente ASR, controlador de voz), apps/web (UI React/Vite), packages/plugin-api, packages/shared, services/asr (Faster Whisper), services/documentation-indexer (indexador FastAPI), un contenedor verificador sin red ni credenciales, y varios documentos que cubren el modelo de seguridad, configuración, motivación y proceso de contribución relacionado con IA. Los plugins también se pueden instalar como metadatos desde un repositorio de GitHub que contiene .cloudx-plugin/plugin.json; esa ruta no ejecuta código de plugin de terceros.
La instalación apunta a Ubuntu 22.04 o posterior mediante un install.sh guiado que muestra cada fase, instala paquetes del sistema y Node.js 22 cuando es necesario, verifica Git 2.36+, instala una versión fijada de Codex CLI, prepara entornos para ASR y documentation-indexer, escribe la configuración, detecta GPUs NVIDIA vía nvidia-smi, y puede instalar servicios a nivel de usuario. Se documentan las opciones --dry-run, --yes, --verbose, --update y --uninstall, junto con el inicio manual con npm ci/build/dev y un flujo de trabajo Vite dev que requiere admitir el origen exacto.
La configuración se basa en variables de entorno, cubriendo host y puerto de bind, orígenes de confianza, nivel de log, raíces permitidas, binario del asistente, URL/dispositivo/tipo de cómputo de ASR y límites de carga de audio, URL del indexador de documentación, host, puerto, tiempos de espera, capacidades de carga y directorio de datos, y el modelo de planner de voz. El README señala que el proyecto se construyó mediante flujos de trabajo intensivos asistidos por agentes, que es útil pero no un servicio endurecido, y se publica bajo licencia MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.