superhq-ai/shuru

해결하는 문제

Shuru는 AI 에이전트가 코드를 실행하고 패키지를 설치하며 도구를 실행할 수 있는 안전한 로컬 퍼스트 microVM 샌드박스를 제공합니다. 실행할 때마다 초기화되는 일시적이고 일회성인 환경을 제공하여 에이전트가 실수로 또는 의도적으로 호스트 시스템을 손상시키는 것을 방지합니다.

작동 방식

macOS에서는 Apple의 Virtualization.framework를, Linux ARM64에서는 KVM 백엔드를 사용하여 경량 Linux VM를 부팅합니다. 시스템은 guest 쓰기에 대해 tmpfs 오버레이 레이어를 사용하여 기본적으로 호스트 파일 시스템이 손상되지 않도록 유지하며, 디렉토리 마운트를 위해 VirtioFS를 지원합니다. 또한 비밀 정보 관리를 위한 프록시가 포함되어 있어, 특정 호스트로의 HTTPS 요청 중에만 실제 API 키가 교체되므로 키가 VM에 실제로 들어가지 않도록 보장합니다.

대상 사용자

호스트 머신을 위험에 빠뜨리지 않고 에이전트가 시스템 수준의 작업을 수행할 수 있도록 안전하고 격리된 환경이 필요한 AI 에이전트(Claude Code, Cursor 또는 Copilot과 같은 도구 사용) 구축 개발자.

주요 특징

• 일시적 샌드박싱: 실행할 때마다 Rootfs가 리셋되어 깨끗한 상태를 유지합니다.
• 체크포인트: 서로 다른 실행 간에 디스크 상태를 저장하고 재사용할 수 있습니다.
• 안전한 비밀 정보 주입: API 키는 프록시를 통해 교체되므로 VM에 절대 들어가지 않습니다.
• 네트워크 제어: 네트워크 액세스 및 허용된 호스트에 대한 세밀한 제어.
• TypeScript SDK: 전용 패키지를 통한 샌드박스의 프로그래밍 방식 제어.
• 에이전트 스킬: AI 에이전트와의 자동 통합을 위한 에이전트 스킬로 제공됩니다.