SuperHQ

¿Qué es SuperHQ?

SuperHQ ejecuta agentes de codificación con IA dentro de “sandboxes reales” aislados para que trabajen en un entorno controlado en lugar de directamente en tu máquina local. Orquesta Claude Code, OpenAI Codex y agentes personalizados, cada uno en su propia microVM.

El propósito principal es ayudarte a ejecutar de forma segura cambios de código impulsados por agentes: tu proyecto se monta en el sandbox (en /workspace), los cambios se capturan en una superposición hasta que los apruebes, y puedes inspeccionar una revisión de diff unificado antes de que nada toque los archivos locales.

Características clave

• Aislamiento por microVM para cada agente: Cada uno de Claude Code, Codex y agentes personalizados se ejecuta en su propia microVM, manteniendo el espacio de trabajo contenido.
• Entorno completo de usuario Linux vía VM Debian: El sandbox es una VM Debian con herramientas de paquetes como apt, más npm y pip, para que el agente instale y ejecute dependencias.
• Espacio de trabajo del proyecto montado en /workspace: Tu proyecto se monta en el sandbox; las ediciones del agente apuntan a esta ruta montada.
• Cambios en superposición con compuerta de aprobación: Los cambios realizados en la VM permanecen en una superposición hasta que los apruebes en el panel de revisión.
• Revisión de diff unificado antes de aplicar localmente: Puedes ver un diff unificado de lo que cambió el agente y elegir qué conservar o descartar.
• Reenvío de puertos opt-in: Los puertos se pueden reenviar del sandbox al host solo cuando lo habilites (útil para servidores de desarrollo, bases de datos y APIs).
• Punto de control y rebobinado: Puedes detener y guardar el estado de la VM, reanudar después; también bifurcar un punto de control para crear una rama nueva.

Cómo usar SuperHQ

1. Instala SuperHQ en macOS con los comandos Homebrew proporcionados (brew tap superhq-ai/tap y brew install --cask superhq).
2. Crea un nuevo espacio de trabajo para tu proyecto (la UI indica la creación de espacios de trabajo y cambio rápido con atajos de teclado).
3. Inicia un agente (la interfaz lista Claude Code, OpenAI Codex y soporte para agentes personalizados) para realizar tareas de codificación dentro del sandbox.
4. Revisa cambios en el panel de revisión: inspecciona el diff unificado y aprueba o descarta cambios antes de que se apliquen a tus archivos locales.
5. Usa controles de sandbox de apoyo según necesites: habilita reenvío de puertos solo cuando necesites acceso a un servicio en la VM, y usa puntos de control para pausar/reenudar o bifurcar una rama limpia.

Casos de uso

• Refactorizaciones seguras impulsadas por agentes para un repo local: Ejecuta un agente para modificar código en una VM Debian aislada, revisa el diff unificado y aprueba solo las partes que quieres aplicar a tu proyecto local.
• Tareas con muchas dependencias sin ensuciar tu máquina: Deja que el agente instale y ejecute herramientas usando el entorno Debian del sandbox (apt, npm, pip) en lugar de instalar paquetes directamente en tu host.
• Depuración con servidores de desarrollo temporales: Habilita reenvío de puertos opt-in para acceder a servicios (por ejemplo, un servidor de desarrollo o API) que corren dentro del sandbox mientras inspeccionas el comportamiento.
• Experimentos iterativos con puntos de control: Guarda el estado de un espacio de trabajo, prueba un enfoque, luego rebobina o bifurca el punto de control para crear una nueva rama en otra dirección.
• Ejecutar flujos de trabajo personalizados con agentes personalizados: Usa la opción “agentes personalizados” cuando tengas una configuración más allá de Claude Code o Codex, manteniendo la ejecución en sandboxes microVM por agente.

Preguntas frecuentes

• ¿Qué aísla SuperHQ? Cada ejecución de agente (Claude Code, Codex o un agente personalizado) se ejecuta en su propio sandbox microVM.

• ¿Dónde vive mi proyecto durante las ejecuciones de agentes? Tu proyecto se monta en el sandbox en /workspace.

• ¿Cómo se aplican los cambios a mis archivos locales? Las ediciones del agente se mantienen en una superposición hasta que las apruebes en el panel de revisión. Se muestra un diff unificado para que conserves o descartes cambios antes de que nada toque los archivos locales.

• ¿Puede el sandbox exponer servicios a mi host? Sí, pero el reenvío de puertos es opt-in, habilitado solo cuando eliges exponer puertos del sandbox al host.

• ¿Cómo funcionan los puntos de control? Puedes detener un espacio de trabajo y guardar el estado completo de la VM, reanudar en segundos después, y bifurcar un punto de control para iniciar una rama nueva.

Alternativas

• Flujos de trabajo de agentes locales (ejecutar agentes directamente en tu máquina): Son más simples, pero generalmente carecen del aislamiento en microVM descrito, la aprobación por etapas y el modelo de superposición en sandbox.
• Entornos de desarrollo contenedorizados (p. ej., configuraciones de agentes basadas en Docker): Los contenedores pueden aislar dependencias y herramientas, pero el flujo específico de superposición-aprobación y el comportamiento de microVM con puntos de control/rebobinado pueden diferir.
• Sandboxes remotos o plataformas de ejecución de código alojadas: Pueden ofrecer aislamiento, pero los flujos de trabajo y dónde se revisan/aplican los cambios de código pueden variar respecto al montaje local de proyecto de SuperHQ en /workspace con aprobación de diffs unificados.
• Asistentes de codificación con IA integrados en el IDE sin sandboxing: Se centran en la asistencia de codificación en el editor; pueden no ofrecer aislamiento por agente en VM, revisión de diffs antes de aplicar a archivos locales ni reenvío de puertos opcional ligado a un runtime de sandbox.