superhq  by superhq-ai

Orchestrate AI coding agents in secure, isolated sandboxes

Created 2 months ago
270 stars

Top 95.2% on SourcePulse

GitHubView on GitHub
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> SuperHQ is a sandboxed AI agent orchestration platform built with Rust and GPUI. It enables developers and researchers to run multiple AI coding agents (e.g., Claude Code, Codex) concurrently in isolated virtual machine environments with full terminal access. A secure auth gateway manages API credentials, offering a robust solution for safe AI agent experimentation.

How It Works

Built with Rust and GPUI for performance, SuperHQ uses the shuru-sdk for sandboxed VM orchestration. Agents run in isolated VMs with dedicated filesystems, networking, and resource limits. A secure auth gateway acts as a reverse proxy, injecting API credentials without exposing them to the sandbox, enhancing security and managing OAuth tokens.

Quick Start & Requirements

Install via Homebrew (brew tap superhq-ai/tap && brew install --cask superhq) or download the .dmg. Requires macOS 14+ on Apple Silicon and ~500 MB disk space for the Shuru runtime. macOS Gatekeeper may require manual override ("Open Anyway"). Supported agents include Claude Code (Anthropic API key), OpenAI Codex (OpenAI/OpenRouter API keys or ChatGPT Plus/Pro OAuth), and Pi (Anthropic/OpenAI API keys or ChatGPT Plus/Pro OAuth).

Highlighted Details

  • Sandboxed Workspaces: Isolated VMs with dedicated filesystem, networking, and resource controls.
  • Multi-Agent Support: Concurrent execution of Claude Code, OpenAI Codex, and custom agents.
  • Secure Auth Gateway: Prevents direct exposure of API keys/OAuth tokens.
  • Review Panel: Unified diff view for agent file changes.
  • Keyboard-First Navigation: Efficient workspace/tab switching via shortcuts.

Maintenance & Community

No specific details on contributors, community channels, or roadmap were provided in the README.

Licensing & Compatibility

Licensed under the GNU Affero General Public License v3.0 (AGPL v3.0). This strong copyleft license requires careful review for commercial use or integration with closed-source applications.

Limitations & Caveats

This is a "very early alpha" release, expecting rough edges, missing features, and breaking changes. It is not production-ready and is limited to macOS 14+ on Apple Silicon.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
29 stars in the last 30 days

Explore Similar Projects

Starred by Jared Palmer Jared Palmer(SVP at GitHub; Founder of Turborepo; Author of Formik, TSDX), Shawn Lewis Shawn Lewis(Cofounder of Weights & Biases), and
4 more.

arrakis by abshkbh

0%
816
Sandboxing solution for AI agent code execution and computer use
Created 1 year ago
Updated 1 year ago
Feedback? Help us improve.