इस प्रोजेक्ट के बारे में

guard-and-guide एक CLI सुरक्षा टूल है जो AI कोडिंग एजेंट्स को खतरनाक ऑपरेशन्स को एग्जीक्यूट करने से बचाता है। यह Claude Code या Gemini CLI में एक प्री-एग्जीक्यूशन हुक के रूप में रजिस्टर करके काम करता है, टूल कॉल्स को रन होने से पहले इंटरसेप्ट करता है, और एक TOML फाइल में परिभाषित कॉन्फ़िगरेबल नियमों को लागू करता है। जब एक एजेंट एक नियम के रेगेक्स पैटर्न के साथ मिलता है, तो टूल रिक्वेस्ट को इनकार करता है और गाइडेंस आउटपुट करता है जो बताता है कि क्यों और सुरक्षित विकल्प का सुझाव देता है। यह सरल इनकार से अधिक प्रभावी है क्योंकि कोडिंग एजेंट्स अक्सर प्रतिबंधों के माध्यम से जारी रहते हैं, एब्सोल्यूट पाथ्स, वैकल्पिक कमांड्स, या अन्य वर्कअराउंड्स का प्रयास करके। नियम्स में कैनोनिकल टूल नाम (Bash, File, Read, Write, Edit) शामिल हैं जो रेगेक्स पैटर्न के साथ जोड़े गए हैं। File एलियास Read, Write, और Edit ऑपरेशन्स को कवर करता है। एक टाइपिकल नियम `git push` या `.env` फाइलों तक पहुंच को ब्लॉक कर सकता है, एजेंट को उपयोगकर्ता से पूछने के लिए निर्देश देता है। इंस्टॉलेशन Nix (`nix profile install github:kawarimidoll/guard-and-guide`) या Cargo (`cargo install --git https://github.com/kawarimidoll/guard-and-guide`) के माध्यम से उपलब्ध है। सेटअप में `~/.config/guard-and-guide/rules.toml` बनाना और हुक कॉन्फ़िगरेशन को या तो `~/.claude/settings.json` (PreToolUse) या `~/.gemini/settings.json` (BeforeTool) में जोड़ना शामिल है। Copilot CLI समर्थन योजना बनाई गई है। टूल Rust में लिखा गया है और MIT लाइसेंस के तहत लाइसेंस प्राप्त है।