SuperHQ

Что такое SuperHQ?

SuperHQ запускает ИИ-агенты для кодирования в изолированных «реальных песочницах», чтобы они работали в контролируемой среде, а не напрямую на вашей локальной машине. Он управляет Claude Code, OpenAI Codex и кастомными агентами, каждый — в своей microVM.

Основная цель — безопасно выполнять изменения кода от агентов: проект монтируется в песочницу (в /workspace), изменения сохраняются в overlay до вашего одобрения, и вы можете просмотреть unified diff перед тем, как что-то затронет локальные файлы.

Ключевые возможности

• Изоляция microVM для каждого агента: Каждый из Claude Code, Codex и кастомных агентов работает в своей microVM, изолируя рабочее пространство.
• Полная Linux-среда через Debian VM: Песочница — это Debian VM с инструментами вроде apt, плюс npm и pip, чтобы агент мог устанавливать и запускать зависимости.
• Монтируемое рабочее пространство проекта в /workspace: Ваш проект монтируется в песочницу; правки агента направлены на этот путь.
• Изменения в overlay с портом одобрения: Изменения в VM остаются в overlay, пока вы не одобрите их в панели ревью.
• Просмотр unified diff перед локальным применением: Вы видите unified diff изменений агента и выбираете, что сохранить или отбросить.
• Опциональный проброс портов: Порты пробрасываются из песочницы на хост только при вашем включении (полезно для dev-серверов, баз данных и API).
• Чекпоинты и откат: Можно остановить и сохранить состояние VM, позже возобновить; также форкнуть чекпоинт для новой ветки.

Как использовать SuperHQ

1. Установите SuperHQ на macOS с помощью Homebrew-команд (brew tap superhq-ai/tap и brew install --cask superhq).
2. Создайте новое рабочее пространство для проекта (UI показывает создание и быстрый переключение горячими клавишами).
3. Запустите агента (интерфейс перечисляет Claude Code, OpenAI Codex и поддержку кастомных агентов) для задач кодирования в песочнице.
4. Просмотрите изменения в панели ревью: изучите unified diff и одобрите или отбросьте изменения перед применением к локальным файлам.
5. Используйте вспомогательные контролы песочницы по необходимости: включите проброс портов только для доступа к сервисам в VM, чекпоинт — для паузы/возобновления или форка чистой ветки.

Сценарии использования

• Безопасный рефакторинг от агента для локального репо: Запустите агента для правок кода в изолированной Debian VM, просмотрите unified diff и одобрите только нужные части для локального проекта.
• Задачи с зависимостями без засорения машины: Пусть агент устанавливает и запускает инструменты в Debian-среде песочницы (apt, npm, pip), а не на хосте.
• Отладка с временными dev-серверами: Включите опциональный проброс портов для доступа к сервисам (например, dev-серверу или API) в песочнице при изучении поведения.
• Итеративные эксперименты с чекпоинтами: Сохраните состояние пространства, попробуйте подход, затем откатитесь или форкните чекпоинт для новой ветки.
• Запуск кастомных workflow с кастомными агентами: Используйте опцию «custom agents» для агентов за пределами Claude Code или Codex, сохраняя выполнение в per-agent microVM-песочницах.

FAQ

• Что изолирует SuperHQ?

  Каждый запуск агента (Claude Code, Codex или кастомный) выполняется в своей microVM-песочнице.

• Где находится мой проект во время работы агента?

  Проект монтируется в песочницу по пути /workspace.

• Как изменения применяются к локальным файлам?

  Правки агента хранятся в overlay до одобрения в панели ревью. Показывается unified diff, чтобы вы могли сохранить или отбросить изменения перед касанием локальных файлов.

• Может ли песочница предоставлять сервисы хосту?

  Да, но проброс портов опциональный и включается только при вашем выборе экспозиции портов из песочницы на хост.

• Как работают чекпоинты?

  Можно остановить пространство и сохранить полное состояние VM, возобновить через секунды, форкнуть чекпоинт для свежей ветки.

Альтернативы

• Локальные рабочие процессы агентов (запуск агентов напрямую на вашей машине): Они проще, но обычно не имеют описанной изоляции microVM, контроля одобрения и модели overlay-песочницы.
• Контейнеризованные среды разработки (например, Docker-based настройки агентов): Контейнеры изолируют зависимости и инструменты, но конкретный поток overlay-одобрения и поведение checkpoint/rewind microVM могут отличаться.
• Удалённые песочницы или платформы хостинга выполнения кода: Они обеспечивают изоляцию, но рабочие процессы и места просмотра/применения изменений кода могут отличаться от монтирования локального проекта SuperHQ в /workspace с одобрением unified diff.
• ИИ-помощники для кодирования, интегрированные в IDE, без песочницы: Они фокусируются на помощи в редакторе; они могут не предоставлять изоляцию VM на агента, просмотр diff перед применением к локальным файлам или опциональный проброс портов, привязанный к runtime песочницы.