Open‑Inspect (Background Agents)

정의 – AI 코딩 에이전트가 실제 개발 환경(Node, Python, git, 브라우저, VS Code)에서 백그라운드로 실행될 수 있게 해주는 오픈소스 플랫폼입니다. 사용자는 웹 UI, Slack, GitHub, Linear 또는 웹훅을 통해 세션을 시작하고, 에이전트가 작업을 처리하는 동안 다른 일을 할 수 있습니다.

핵심 아이디어

• 단일 테넌트, 신뢰된 팀 배포 – 모든 사용자가 동일한 조직에 속하며 테넌트 격리가 없습니다.
• 완전한 개발 샌드박스 – 각 세션은 Node 24, Python 3.12, git, 브라우저 자동화 등이 포함된 새로운 샌드박스를 받습니다.
• 멀티 모델 지원 – Anthropic Claude, OpenAI Codex, xAI Grok, OpenCode Zen 등을 세션별로 선택할 수 있습니다.
• 실시간 협업 – 여러 사람이 동일한 세션을 보고 프롬프트를 입력할 수 있으며, 커밋은 프롬프트를 입력한 사용자에게 귀속됩니다.
• 자동화 – cron 스타일 일정, Sentry 알림, GitHub 워크플로 트리거 또는 사용자 지정 웹훅으로 사람의 개입 없이 세션을 생성할 수 있습니다.

주요 기능

• 빠른 시작 – 스냅샷과 사전 빌드 이미지로 세션을 즉시 재개할 수 있습니다.
• 멀티 리포지토리 세션 – 최대 10개의 리포지토리를 나란히 복제할 수 있으며, 환경을 자체 시크릿 및 이미지와 함께 저장할 수 있습니다.
• 관리형 스킬 – 세션이 시작될 때 자동으로 주입되는 재사용 가능한 지침 번들(스킬)입니다.
• 하위 세션 – 에이전트가 별도의 샌드박스에서 실행되는 병렬 하위 세션을 생성할 수 있습니다.
• 클라이언트 통합 – 웹 UI (Next.js), Slack 봇, GitHub 봇(자동 리뷰, @멘션), Linear 봇, 일반 웹훅.
• 커밋 귀속 – git 커밋은 프롬프트를 발행한 사용자의 이름/이메일을 기록합니다.
• 보안 샌드박스 – AES-256-GCM 암호화 시크릿, 리포지토리별 또는 환경별 범위, 격리된 런타임.

아키텍처 개요

Clients (Web, Slack, GitHub, Linear, Webhooks)
   │
   ▼
Control Plane (Cloudflare Workers + Durable Objects)
   │   – session metadata, websockets, event streams, GitHub integration 저장
   │   – D1 DB는 리포지토리 범위의 시크릿 보관
   ▼
Data Plane (Sandbox Backend)
   │   – Supervisor → Harness (Claude / OpenCode) → Bridge
   │   – 전체 개발 환경 (Node, Python, git, browser automation)
   ▼
External services (GitHub, Slack, Linear, Sentry, etc.)

시작하기

1. docs/SETUP_GUIDE.md를 따라 로컬 개발 및 기여를 진행합니다.
2. docs/GETTING_STARTED.md (Cloudflare Workers + 선택한 샌드박스 인프라 – Modal, Daytona, E2B, OpenComputer 등)를 사용하여 배포합니다.
3. 첫 번째 팀을 만들고(가이드의 10단계) 세션을 테스트합니다.
4. 모델 문서에 설명된 대로 AI 모델 자격 증명(Claude Agent, OpenAI OAuth, Grok 구독)을 구성합니다.

일반적인 사용 사례

• 일상적인 코드 변경(의존성 업그레이드, 린트 수정)에 대한 자동 PR 생성.
• Sentry 알림 또는 GitHub Action 실패의 지속적인 트리아지.
• 예약된 유지 관리 작업(예: 야간 린트, 코드베이스 상태 점검).
• 인간이 AI 어시스턴트를 안내하는 협업 페어 프로그래밍.
• UI를 벗어나지 않고 다중 리포지토리 리팩토링의 빠른 프로토타이핑.

라이선스 – MIT.

크레딧 – Ramp의 Inspect에서 영감을 받았으며, Modal, Daytona, Vercel Sandbox, OpenComputer, E2B, Cloudflare Workers, OpenCode, Claude Agent SDK 및 Next.js로 구축되었습니다.