LuD1161/agentjail

어떤 프로젝트인가요?

핵심 기능

• 01에이전트의 모든 도구 호출을 실행 전에 OPA Rego 정책에 따라 검사
• 02설명과 함께 허용, 확인 요청, 거부 판정을 반환
• 03`agentjail run`을 통해 파일 시스템 접근을 제한하는 OS 샌드박스 추가
• 04선택적으로 트래픽을 확인할 수 있는 기본 거부 방식의 네트워크 허용 목록
• 05명시적으로 선택한 시크릿만 세션에 전달하는 자격 증명 브로커
• 06로컬 재생 뷰어, 터미널 대시보드, 비용 보고서

활용 사례

• 강제 푸시나 재귀 삭제 같은 파괴적인 명령을 코딩 에이전트가 실행하지 못하게 방지
• 실수로 .env 파일이나 클라우드 자격 증명이 에이전트 컨텍스트에 유출되는 상황 방지
• 세션 중 에이전트가 데이터를 전송할 수 있는 호스트 제한
• 세션 재생을 통해 에이전트의 작업 내역과 그 이유 검토

빠른 시작

1. 1

   먼저 minisign 설치 (macOS)

   brew install minisign
2. 2

   Homebrew로 AgentJail 설치

   brew install LuD1161/tap/agentjail
3. 3

   보호 상태 확인

   agentjail doctor
4. 4

   OS 샌드박스를 적용해 AgentJail을 통해 에이전트 실행

   agentjail run -- codex

사용 전 알아둘 점

• !macOS와 Linux만 지원합니다.
• !훅만으로는 협력적 검사만 수행하며 파일 시스템 격리 경계가 되지는 않습니다. OS 샌드박스를 사용하려면 agentjail run을 통해 실행해야 합니다.
• !일부 보호 기능은 데몬을 사용할 수 있는지와 플랫폼별 샌드박스 지원 범위에 따라 달라집니다.

포함된 컬렉션

토픽

자주 묻는 질문

agentjail은(는) 무엇인가요?

Claude Code, Codex, Cursor 같은 코딩 에이전트의 각 도구 호출을 실행 전에 로컬에서 검사하는 정책 가드레일입니다. AgentJail은 Claude Code, Codex, Cursor 같은 코딩 에이전트를 위한 안전 계층입니다. 설치 후 지원되는 각 에이전트에 hook을 등록해, 모든 도구 호출(셸 명령, 파일 읽기 및 수정, MCP 호출)이 실행되기 전에 Open Policy Agent(OPA) Rego 규칙에 따라 평가되도록 합니다. 판정은 허용, 확인 요청, 거부로 내려지며, 지속 실행되는 로컬 데몬과 판정 캐시를 통해 검사 속도를 유지합니다.

agentjail은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

agentjail은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

agentjail은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. agentjail의 마지막 커밋은 2026년 9월 24일입니다.

agentjail은(는) 어디에 사용할 수 있나요?

강제 푸시나 재귀 삭제 같은 파괴적인 명령을 코딩 에이전트가 실행하지 못하게 방지 실수로 .env 파일이나 클라우드 자격 증명이 에이전트 컨텍스트에 유출되는 상황 방지 세션 중 에이전트가 데이터를 전송할 수 있는 호스트 제한 세션 재생을 통해 에이전트의 작업 내역과 그 이유 검토

agentjail는 어떻게 설치하나요?

먼저 minisign 설치 (macOS): brew install minisign Homebrew로 AgentJail 설치: brew install LuD1161/tap/agentjail 보호 상태 확인: agentjail doctor OS 샌드박스를 적용해 AgentJail을 통해 에이전트 실행: agentjail run -- codex

agentjail은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/LuD1161/agentjail