superhq-ai/shuru

해결하는 문제

Shuru는 AI 에이전트가 호스트 머신의 보안이나 안정성을 위협하지 않고 코드를 실행하고, 패키지를 설치하며, 도구를 실행할 수 있는 안전하고 격리된 환경을 제공합니다. 매 실행마다 초기화되는 일회성 microVM을 제공함으로써 로컬 시스템이 "더러워지는" 문제를 해결합니다.

작동 방식

macOS에서는 Apple의 Virtualization.framework를, Linux (ARM64)에서는 KVM 백엔드를 사용하여 경량 Linux VM을 부팅합니다. 게스트의 쓰기 작업에는 tmpfs 오버레이 계층을 사용하여 기본적으로 호스트가 영향을 받지 않도록 하며, 디렉토리 마운트를 위해 VirtioFS를 지원합니다. 시크릿 관리를 위한 프록시가 포함되어 있어 실제 API 키가 VM 게스트 내부로 유입되지 않도록 보장합니다.

대상 사용자

Claude Code, Cursor, Copilot과 같은 도구를 사용하여 AI 에이전트를 구축하며, 제어된 환경에서 안전하고 프로그래밍 방식으로 코드를 실행해야 하는 개발자.

주요 특징

• 일회성 샌드박스 (Ephemeral Sandboxes): 모든 실행은 일회용이며, 루트 파일 시스템이 자동으로 초기화됩니다.
• 체크포인트 (Checkpoints): 디스크 상태를 저장하고 재사용하여 매번 의존성을 다시 설치할 필요가 없습니다.
• 안전한 시크릿 (Secure Secrets): API 키는 HTTPS 요청 시 프록시에 의해 대체되며, 실제 키는 호스트에 안전하게 보관됩니다.
• 네트워크 제어 (Network Control): 호스트별 허용 목록을 포함하여 네트워크 액세스에 대한 세밀한 제어를 제공합니다.
• TypeScript SDK: Node.js/Bun 패키지를 통한 샌드박스의 프로그래밍 방식 제어.
• 포트 포워딩 (Port Forwarding): 전체 네트워크 액세스 권한 없이 vsock을 통해 게스트 서비스를 호스트에 노출합니다.