Herdr Sandbox

일회용 Windows Sandbox 개발 환경

기존 Windows 설치와 분리된 일회용 Windows Sandbox 인스턴스를 기동하여 컴파일, 테스트, 패키징, GUI 자동화를 수행합니다. 호스트의 정상 터미널을 유지하면서 RDP나 별도의 데스크톱 워크플로우 없이 작업할 수 있습니다.

반복 가능한 프로젝트 설정

`sandbox init –stack`으로 프로젝트별 툴 스택을 선택하고, 멱등한 PowerShell 프로파일을 프로젝트에 함께 보관할 수 있습니다. `sandbox plan`으로 변경 사항을 미리 확인하고, 호환되는 준비 게스트를 재사용하여 빠른 반복이 가능합니다.

명시적 영속성과 폐기 경계

소스, 선택형 워크트리/공유 모델 루트, 승인된 에이전트 구성, 검증된 패키지 캐시는 유지되고, 게스트 도구와 프로세스는 샌드박스가 닫히면 함께 사라집니다. 브라우저 자동화, TradingView, 오디오, 마이크는 명시적으로 활성화하지 않는 한 비활성 상태입니다.

에이전트 구성 동기화 및 자격 증명 전송(옵트인)

OpenCode, Claude Code, Codex, GitHub Copilot, Pi 등 에이전트 구성을 SSH를 통해 게스트로 전달하며, 각 자격 증명 전송은 별도의 옵트인 항목으로 제어됩니다.

Tailscale을 통한 모바일 접근

옵트인 모드에서 태블릿이나 휴대폰으로 Herdr에 접속해 알림 확인, 에이전트 응답, 프로젝트 명령 실행을 수행할 수 있는 모바일 SSH 프로파일을 제공합니다.

전제 조건 확인

Windows 10/11에서 Windows Sandbox가 활성화되어 있는지 확인하고, 호스트 PATH에 Herdr Win과 Windows OpenSSH Client(`ssh.exe`)가 있는지 점검합니다.

WinGet으로 설치

관리자 권한 PowerShell에서 다음 명령으로 Herdr Win과 Herdr Sandbox를 함께 설치하고, 이후 동일한 명령으로 업그레이드합니다.

winget install hdosys.herdr-win hdosys.herdr-sandbox
winget upgrade hdosys.herdr-win hdosys.herdr-sandbox

설치 확인

새 터미널을 열고 `herdr –version`과 `sandbox –version`을 실행하여 두 도구의 버전을 확인합니다.

전역 구성 검토

최초 `up` 전에 `sandbox config`을 실행하여 `%APPDATA%herdr-sandboxconfig.json`을 열고 메모리, 에이전트 구성 동기화, 패키지, 호스트 폴더 매핑 옵션을 검토합니다.

첫 프로젝트 실행

프로젝트 루트에서 스택을 선택하고, 계획을 확인한 뒤 게스트를 시작합니다.

sandbox init --stack go
sandbox plan
sandbox up

분리한 후에도 게스트는 준비 상태로 유지되므로 `sandbox status`, `sandbox attach`, `sandbox down` 명령으로 상태 확인과 재연결, 종료가 가능합니다. 헤드리스 환경에서는 `sandbox up –no-attach`로 실행한 뒤 실제 터미널에서 `sandbox attach`로 연결할 수 있습니다.

활용 예시

• Windows에서 네이티브로 컴파일/테스트/패키징해야 하는 프로젝트를 격리된 환경에서 반복 빌드
• 신뢰할 수 없는 스크립트나 외부 코드를 샌드박스 안에서 실행하여 호스트 환경 오염 방지
• Node/Playwright 등 스택을 선택해 헤드리스 브라우저 자동화를 수행하고, 작업 후 게스트를 폐기
• Tailscale 옵트인을 통해 모바일 디바이스에서 에이전트 알림 확인 및 명령 실행
• Android 스택으로 무선 디버깅 페어링을 구성해 에뮬레이터/디바이스 검증 진행

제한·라이선스·확인사항

• 게스트 프로세스는 Windows Sandbox 내부에서 관리자 권한을 가지므로, 마운트 폴더와 전송 자격 증명을 신중히 선택해야 합니다.
• 호스트 홈 루트, 일반 AppData, 선택되지 않은 저장소, 개인 SSH/GPG 키는 게스트에 매핑되지 않습니다.
• 다운로드와 캐시는 패키지 ID, 버전, 해시, 서명, 메타데이터를 기준으로 검증됩니다.
• Herdr Win 및 Herdr Sandbox 설치 프로그램은 현재 서명되어 있지 않으므로 직접 다운로드 시 GitHub SHA-256 다이제스트 확인이 권고됩니다.
• Windows Sandbox는 임의 USB 패스스루를 지원하지 않으므로 USB, fastboot, 복구 모드 등 작업에는 호스트 도구체인을 사용해야 합니다.
• Windows 운영체제에서만 동작하며, macOS나 Linux는 지원 대상이 아닙니다. CLI 기반 도구로 별도의 그래픽 사용자 인터페이스는 제공되지 않습니다.
• 라이선스는 Apache-2.0이며 자세한 조건은 GitHub 저장소의 LICENSE 파일에서 확인할 수 있습니다.