coipond/coi

해결하는 문제

Coi는 AI 코딩 에이전트(Claude Code 또는 Codex 등)를 실행하기 위한 안전하고 격리된 환경을 제공하여 호스트 머신을 위험으로부터 보호합니다. 에이전트가 민감한 자격 증명, SSH 키, 환경 변수에 접근하는 것을 방지하면서도, 제어된 Linux 컨테이너 내에서 완전한 root 권한과 시스템 수준의 기능을 사용할 수 있도록 합니다.

작동 원리

Coi는 Incus 시스템 컨테이너를 사용하여 가상 머신처럼 작동하지만 몇 초 만에 시작되는 가볍고 완전한 OS 환경을 생성합니다. 프로젝트 디렉토리를 컨테이너에 마운트하면서 호스트의 파일 소유권이 올바르게 유지되도록 보장합니다. 호스트를 보호하기 위해 커널 수준의 모니터링을 구현하여 리버스 셸이나 데이터 유출과 같은 위협이 감지되면 자동으로 컨테이너를 일시 중지하거나 종료하며, 네트워크 송신 제어를 위해 nftables를 사용합니다.

대상 사용자

• AI 코딩 에이전트에 완전한 머신 접근 권한(root, Docker, 패키지 관리자)을 부여하면서도 호스트 보안을 유지하고 싶은 개발자.
• 동일한 프로젝트에 대해 여러 개의 격리된 에이전트를 병렬로 실행해야 하는 사용자.
• 설정 파일을 통해 표준화되고 지속 가능한 개발 환경을 공유하고자 하는 팀.

주요 특징

• 시스템 수준 격리: Incus를 사용하여 샌드박스 내에서 root 및 네이티브 Docker를 지원하는 완전한 OS를 제공합니다.
• 능동적 방어: 위협 심각도에 따라 세션을 자동으로 일시 중지하거나 종료하는 실시간 커널 수준 모니터링.
• 자격 증명 보호: 호스트 SSH 키와 토큰은 명시적으로 전달하지 않는 한 기본적으로 제외됩니다.
• 재사용 가능한 프로필: 이미지, 리소스 제한, 네트워크 모드에 대한 명명된 설정으로 단일 플래그로 적용 가능합니다.
• 코드화된 가드레일: git hooks 및 IDE 설정에 대한 읽기 전용 마운트를 통해 에이전트가 공급망 설정을 수정하지 못하도록 방지합니다.
• 헤드리스 오케스트레이션: CI/CD 또는 cron 작업을 위해 프롬프트를 완료까지 실행할 수 있으며, 보안 포렌식을 위한 JSONL 감사 로그를 제공합니다.