safedep/gryphAI कोडिंग एजेंट्स के लिए सुरक्षा परत। Claude Code, Cursor, Windsurf, Gemini CLI, OpenCode, Pi Agent और अन्य के साथ काम करता है।
हर कोई YOLO मोड में चलाता है। Gryph गार्डरेल लागू करता है और ऑडिट ट्रेल रखता है।
क्विक स्टार्ट · डेमो · समर्थित एजेंट्स · उपयोग के मामले · सुरक्षा नीति
AI कोडिंग एजेंट्स (Claude Code, Cursor, Windsurf, Gemini CLI, OpenCode) डेवलपर की मशीन पर कोई भी फ़ाइल पढ़ सकते हैं, कहीं भी लिख सकते हैं, और मनमाने कमांड चला सकते हैं। वे प्रति सत्र में दर्जनों टूल कॉल चलाते हैं। उनके काम करने पर कोई सीमाएँ नहीं हैं और कुछ गलत होने पर कोई ऑडिट ट्रेल भी नहीं होता।
Gryph इसे ठीक करता है। यह एजेंट्स में हुक करता है, YAML नीति नियम लागू करता है जो वास्तविक समय में कार्यों को block, warn, या guide करते हैं, और समीक्षा व ऑडिट के लिए हर इवेंट को स्थानीय SQLite डेटाबेस में लॉग करता है। सारा डेटा स्थानीय रहता है। कोई क्लाउड नहीं, कोई टेलीमेट्री नहीं।
एक डेवलपर Claude Code से एक मॉड्यूल रिफैक्टर करने के लिए कहता है। यह 90 सेकंड में 47 टूल कॉल चलाता है। फिर टेस्ट फेल हो जाते हैं।
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 पेज पर उपलब्ध हैं।
सुझाव: फ़ाइल डिफ़ और रॉ इवेंट देखने के लिए
logging.levelकोfullपर सेट करें:gryph config set logging.level full। विवरण के लिए कॉन्फ़िगरेशन देखें।
| एजेंट | हुक समर्थन |
|---|---|
| Claude Code | पूर्ण (PreToolUse, PostToolUse, Notification) |
| Codex | पूर्ण (PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop) |
| Command Code | पूर्ण (PreToolUse, PostToolUse, Stop, SessionStart) |
| Cursor | पूर्ण (file read/write, shell execution, MCP tools) |
| Devin CLI | पूर्ण (PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, Stop, SessionEnd) |
| Gemini CLI | पूर्ण (BeforeTool, AfterTool, Notification) |
| OpenCode | पूर्ण (tool.execute, session events) |
| Pi Agent | पूर्ण (tool_call, tool_result, session events) |
| Windsurf | पूर्ण (file read/write, commands, MCP tools) |
नोट: 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 नियम लिखें। सुरक्षा नीति देखें। |
| सुरक्षा समीक्षा | इवेंट्स को अपने SIEM में एक्सपोर्ट करें, या केंद्रीकृत डैशबोर्ड और खतरा पहचान अलर्ट के लिए OpenSearch observability example का उपयोग करें। |
| लागत और टोकन ट्रैकिंग | मॉडल और एजेंट्स में प्रति-सत्र टोकन उपयोग और अनुमानित लागत ट्रैक करें। दस्तावेज़ देखें |
| एजेंट्स की तुलना करें | यह देखने के लिए --agent से फ़िल्टर करें कि अलग-अलग एजेंट्स एक ही कार्य को कैसे करते हैं: कौन अधिक पढ़ता है, कौन अधिक कमांड चलाता है, कौन अधिक खर्च करता है। |
