AI 코딩 에이전트에는 보안 경계가 없습니다. Gryph가 그 경계를 만듭니다.

모두가 YOLO 모드로 실행합니다. Gryph는 가드레일을 적용하고 감사 추적을 유지합니다.

GitHub stars Downloads License Release

AI 코딩 에이전트(Claude Code, Cursor, Windsurf, Gemini CLI, OpenCode)는 어떤 파일이든 읽고, 어디든 쓰고, 개발자 머신에서 임의의 명령을 실행할 수 있습니다. 이들은 세션당 수십 번의 도구 호출을 실행합니다. 이들이 할 수 있는 일에는 경계가 없고, 문제가 생겼을 때 남는 감사 추적도 없습니다.

Gryph가 이를 해결합니다. Gryph는 에이전트에 훅을 걸고, 실시간으로 동작을 block, warn, guide하는 YAML 정책 규칙을 적용하며, 모든 이벤트를 검토와 감사를 위해 로컬 SQLite 데이터베이스에 기록합니다. 모든 데이터는 로컬에 남습니다. 클라우드도, 텔레메트리도 없습니다.

문제

개발자가 Claude Code에 모듈 리팩터링을 요청합니다. 90초 동안 47번의 도구 호출이 실행됩니다. 그러고 나서 테스트가 실패합니다.

에이전트는 변경하기 전에 어떤 파일을 읽었는가?
예상치 못한 셸 명령을 실행했는가?
설정 파일, 시크릿, CI 파이프라인을 건드렸는가?
파일은 변경 전과 후에 어떤 모습이었는가?

Gryph가 없다면 개발자는 추측만 할 수밖에 없습니다. Gryph가 있으면 gryph logs가 모든 것을 보여줍니다.

빠른 시작

# Install Gryph with one command
curl -fsSL https://raw.githubusercontent.com/safedep/gryph/main/install.sh | sh

# Setup gryph for available agents
gryph install                    # hooks into all detected agents
gryph status                     # verify setup

# ... use your AI agent normally ...
gryph logs                       # see what happened

기타 설치 방법

# Homebrew (macOS/Linux)
brew install safedep/tap/gryph

# npm
npm install -g @safedep/gryph

# Go
go install github.com/safedep/gryph/cmd/gryph@latest

macOS, Linux, Windows용 사전 빌드된 바이너리는 GitHub Releases 페이지에서 이용할 수 있습니다.

팁: 파일 diff와 원시 이벤트를 보려면 logging.level을 full로 설정하세요: gryph config set logging.level full. 자세한 내용은 Configuration을 참조하세요.

지원 에이전트

에이전트	훅 지원
Claude Code	전체 (PreToolUse, PostToolUse, Notification)
Codex	전체 (PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop)
Command Code	전체 (PreToolUse, PostToolUse, Stop, SessionStart)
Cursor	전체 (파일 읽기/쓰기, 셸 실행, MCP 도구)
Devin CLI	전체 (PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop, SessionEnd)
Gemini CLI	전체 (BeforeTool, AfterTool, Notification)
OpenCode	전체 (tool.execute, 세션 이벤트)
Pi Agent	전체 (tool_call, tool_result, 세션 이벤트)
Windsurf	전체 (파일 읽기/쓰기, 명령, MCP 도구)

참고: Codex 훅을 사용하려면 Codex 구성(~/.codex/config.toml)에서 codex_hooks 기능 플래그를 활성화해야 합니다:
[features]
codex_hooks = true

참고: Devin CLI는 기본적으로 ~/.claude/settings.json에서 Claude Code 훅도 로드합니다(read_config_from.claude). 두 에이전트 모두에 gryph 훅이 설치된 경우, 하나의 Devin 세션이 devin 이벤트와 claude-code 이벤트를 모두 내보냅니다. 하나의 스트림만 유지하려면 Devin 사용자 구성에서 read_config_from.claude를 비활성화하세요.

명령 하나로 감지된 모든 에이전트에 훅이 설치됩니다. 에이전트별 설정은 필요하지 않습니다.

실제 동작 보기

gryph logs --live를 사용하여 에이전트 작업이 발생하는 즉시 실시간 스트리밍:

사용 사례

시나리오	Gryph가 돕는 방법
전체 세션 재생	`git diff`는 최종 변경 사항만 보여줍니다. Gryph는 에이전트가 무엇을 읽었고, 무엇을 실행했으며, 무엇을 쓰고 되돌렸는지, 그리고 그 순서까지 전체 시퀀스를 보여줍니다.
보이지 않는 부작용 포착	에이전트는 git에 흔적을 남기지 않는 셸 명령(`npm install`, `curl`, `rm`)을 실행합니다. `gryph query --action exec`로 이들을 모두 확인할 수 있습니다.
민감한 파일 접근	Gryph는 `.env`, `.pem`, `.key` 및 유사한 파일에 대한 접근을 자동으로 표시합니다. 작업은 기록되지만 내용은 절대 저장되지 않습니다.
위험한 에이전트 작업 차단	파괴적인 명령을 차단하거나, 자격 증명을 유출하는 쓰기를 거부하거나, 에이전트 또는 프로젝트별로 동작 범위를 지정하는 YAML 규칙을 작성하세요. Security Policy를 참조하세요.
보안 검토	이벤트를 SIEM으로 내보내거나, 중앙 집중식 대시보드와 위협 탐지 알림을 위해 OpenSearch observability example을 사용하세요.
비용 및 토큰 추적	모델과 에이전트 전반에 걸쳐 세션별 토큰 사용량과 예상 비용을 추적합니다. 문서 보기
에이전트 비교	`--agent`로 필터링하여 서로 다른 에이전트가 동일한 작업에 접근하는 방식을 확인하세요: 어느 에이전트가 더 많이 읽고, 더 많이 실행하며, 더 많은 비용이 드는지.

동작 방식

Gryph는 AI 코딩 에이전트에 경량 훅을 설치합니다. 에이전트가 파일을 읽거나, 파일을 쓰거나, 명령을 실행할 때 훅이 Gryph로 JSON 이벤트를 전송합니다. 이벤트는 로컬 SQLite 데이터베이스에 저장되며 언제든지 쿼리할 수 있습니다. Gryph는 pre-tool 및 post-tool 이벤트 모두에 훅을 걸기 때문에 모든 에이전트 작업의 전체 수명 주기를 포착합니다.

보안 정책

로깅 외에도 Gryph는 에이전트 작업에 대해 YAML 정책을 적용할 수 있습니다. 규칙은 작업 유형, 파일 경로, 명령 패턴, 도구 이름, 에이전트, 프로젝트, 그리고 세션별 카운터에 대한 CEL 표현식을 기반으로 block, warn, guide, allow를 수행할 수 있습니다. 차단된 작업은 에이전트의 도구에 도달하지 않으며, 안내는 stderr 텍스트로 에이전트에게 전달되고, 모든 결정은 영구 저장됩니다.

gryph policy init          # write the example policy to the global config dir
gryph policy edit          # open it in $EDITOR and scaffold if missing
gryph policy validate
gryph policy test --action file_write --path ./secrets/db.env
gryph config set policy.enabled true

자세한 내용은 보안 정책을 참조하세요.

Gryph는 자체 훅, 정책 및 감사 추적도 보호합니다. gryph doctor는 각 자산의 보호 수준과 그에 따라 획득되는 프로필을 보여줍니다. guard 프로필에서 Gryph는 에이전트의 실수와 이를 변경하려는 단순한 시도를 방어하고, 훅 구성 변경을 탐지하며, 복구를 활성화한 경우 이를 복구합니다. 그러나 같은 사용자 권한의 단호한 공격자나 root를 막지는 못합니다. 한계와 주장할 수 있는 범위는 자기 보호를 참조하세요. 관리자는 gryph install --managed로 호스트의 모든 사용자를 위해 Gryph를 설치합니다. 관리형 설치 가이드를 참조하세요.

gryph

인기