finbarr/yolobox

해결하는 문제

AI 코딩 에이전트는 효과적으로 작동하기 위해 제한 없는 명령 실행이 필요하지만, 로컬 머신에 완전한 접근 권한을 부여하면 홈 디렉터리가 실수로 삭제되는 등의 심각한 보안 위험이 발생합니다. yolobox는 에이전트가 고권한으로 작동할 수 있는 안전한 사전 환경을 제공하여 호스트 시스템의 중요한 파일을 위험에 노출시키지 않습니다.

작동 방식

이 도구는 AI 에이전트(예: Claude Code, Codex, Gemini 등)를 컨테이너 내에서 실행합니다. 특정 프로젝트 디렉터리를 에이전트 환경에 마운트하지만, 명시적으로 허용하지 않는 한 홈 디렉터리는 격리됩니다. 지속 가능한 볼륨을 사용하여 세션 간에 도구와 설정을 유지하고, 에이전트가 사전 환경 상태를 이해하도록 도와주는 내장 가이드도 제공합니다. 보안을 더욱 강화하기 위해 네트워크 접근, 환경 변수, 프로젝트 디렉터리 권한을 제한할 수 있습니다.

대상 사용자

AI 코딩 에이전트를 사용하면서 주 작업 환경에서 파괴적인 실수를 걱정하지 않고 자율적으로 명령을 실행할 수 있는(‘yolo 모드’) 개발자.

주요 기능

• 다중 에이전트 지원: Claude, Codex, Kimi Code, Copilot 등 다양한 AI CLI에 대한 내장 단축키 제공.
• 프로젝트별 맞춤 설정: .yolobox.toml 설정 파일을 통해 추가 도구, 환경 변수, 또는 Dockerfile 조각을 추가 가능.
• 사전 구성된 환경: Node.js, Python, Go, Bun, Git, ripgrep 등 필수 개발 도구가 기본 이미지에 포함되어 있음.
• 세밀한 보안 제어: 네트워크 접근 없이, 프로젝트 마운트를 읽기 전용으로, 또는 비밀 파일을 제외하여 에이전트를 실행할 수 있는 옵션 제공.
• 지속 상태 유지: 이름 붙은 볼륨을 통해 sudo로 설치한 도구가 실행 간에 유지됩니다.