perplexityai/numbat

어떤 프로젝트인가요?

핵심 기능

• 01훅, 플러그인, OTLP/HTTP 로그 익스포터를 통한 실시간 모니터링.
• 02기본 제공 CEL 규칙, 다단계 시퀀스 규칙, 사용자 지정 YAML 규칙을 이용한 로컬 탐지.
• 03지원되는 실행 전 훅에서 선택적으로 차단하며, 기본값은 꺼짐.
• 04지원되는 디스크 기반 세션 아티팩트에서 포렌식 재구성.
• 05와이어 형식용 JSON Schema가 포함된 버전 관리 NDJSON 기록.
• 06비밀 정보 마스킹을 지원하는 읽기 전용 아티팩트 스캔.
• 07SHA-256 매니페스트가 포함된 이식 가능한 케이스 번들.

활용 사례

• 개발자 워크스테이션에서 코딩 에이전트가 무엇을 읽고, 쓰고, 실행하는지 모니터링.
• 디스크에 저장된 아티팩트로 에이전트 세션을 사후 조사.
• 정책을 신중하게 설정한 뒤 SSH authorized_keys 쓰기와 같은 고위험 작업 일부를 차단.
• 검증 가능한 케이스 번들로 사고 증거를 공유.

빠른 시작

1. 1

   Go 1.26.9 이상에서 numbat 설치

   go install github.com/perplexityai/numbat/cmd/numbat@latest
2. 2

   감지된 에이전트 목록을 확인하고 해당 아티팩트 스캔(읽기 전용)

   numbat agents
3. 3

   Codex용 실시간 모니터링 훅 설치(기본값은 모니터링 전용)

   numbat hook install --agent codex --emit all

사용 전 알아둘 점

• !실시간 모니터링 범위는 에이전트와 표면에 따라 다르므로, 이를 신뢰하기 전에 커버리지 매트릭스를 확인하세요.
• !차단은 기본적으로 꺼져 있으며 제공되는 모든 규칙은 모니터링 전용입니다. 강제 적용하려면 자체 규칙을 작성하고 유지 관리해야 합니다.
• !훅은 설치 후와 업그레이드 후 호스트 신뢰성 검토가 필요하므로 운영 절차가 추가됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

numbat은(는) 무엇인가요?

로컬 탐지, 선택적 실행 전 차단, 세션 아티팩트 기반 포렌식 재구성을 통해 AI 에이전트 활동을 엔드포인트에서 파악합니다. numbat은 로컬 훅과 플러그인, OTLP/HTTP 로그 익스포터, 디스크에 저장된 세션 아티팩트를 통해 지원되는 데스크톱, CLI, IDE, 게이트웨이 에이전트를 관찰합니다. 실시간 활동과 저장된 활동을 하나의 이벤트 모델로 정규화하고, 동일한 CEL 규칙 엔진으로 평가하며, 탐지는 로컬에서 수행합니다. 기록은 stdout이나 로컬 파일에 쓸 수 있고, 선택적으로 HTTP를 통해 전송할 수도 있습니다.

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

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

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

활발히 유지보수 중. numbat의 마지막 커밋은 2026년 11월 4일입니다.

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

개발자 워크스테이션에서 코딩 에이전트가 무엇을 읽고, 쓰고, 실행하는지 모니터링. 디스크에 저장된 아티팩트로 에이전트 세션을 사후 조사. 정책을 신중하게 설정한 뒤 SSH authorized_keys 쓰기와 같은 고위험 작업 일부를 차단. 검증 가능한 케이스 번들로 사고 증거를 공유.

numbat는 어떻게 설치하나요?

Go 1.26.9 이상에서 numbat 설치: go install github.com/perplexityai/numbat/cmd/numbat@latest 감지된 에이전트 목록을 확인하고 해당 아티팩트 스캔(읽기 전용): numbat agents Codex용 실시간 모니터링 훅 설치(기본값은 모니터링 전용): numbat hook install --agent codex --emit all

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

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