शीघ्र शुरुआत

uvx gac init   # अपना प्रोवाइडर, मॉडल और भाषा कॉन्फ़िगर करें
uvx gac  # LLM के साथ जेनरेट और कमिट करें

बस इतना ही! जेनरेट किए गए मैसेज की समीक्षा करें और y के साथ पुष्टि करें।

---

मुख्य विशेषताएं

33+ समर्थित प्रदाता

• Anthropic • Azure OpenAI • Cerebras • ChatGPT (OAuth) • Chutes.ai • Claude Code (OAuth)
• Crof.ai • DeepInfra • DeepSeek • Fireworks • Gemini • GitHub Copilot (OAuth) • Groq
• Kimi for Coding • Lilac • LM Studio • MiniMax.io • Mistral AI • Moonshot AI • Neuralwatt • Ollama
• Ollama Cloud • OpenAI • OpenCode Go • OpenRouter • Plexus Gateway • Qwen Cloud (CN & INTL)
• Replicate • Streamlake/Vanchin • Synthetic.new • Together AI • Wafer.ai • Z.AI (API & Coding Plans)
• Custom Endpoints (Anthropic/OpenAI)

🧠 स्मार्ट LLM विश्लेषण

• इरादा समझता है: कोड संरचना, लॉजिक, और पैटर्न का विश्लेषण करके आपके परिवर्तनों के पीछे के "क्यों" को समझता है, न कि केवल क्या बदला
• सिमेंटिक जागरूकता: रिफैक्टरिंग, बग फिक्सेस, फीचर्स, और ब्रेकिंग चेंजेस को पहचानता है संदर्भात्मक रूप से उपयुक्त मैसेज जेनरेट करने के लिए
• बुद्धिमान फिल्टरिंग: सार्थक परिवर्तनों को प्राथमिकता देता है जबकि जेनरेट किए गए फाइलों, डिपेंडेंसीज, और आर्टिफैक्ट्स को नजरअंदाज करता है
• बुद्धिमान कमिट ग्रुपिंग - --group के साथ संबंधित परिवर्तनों को स्वचालित रूप से कई लॉजिकल कमिट्स में समूहित करें

📝 कई मैसेज फॉर्मेट

• वन-लाइनर (-o flag): कन्वेंशनल कमिट फॉर्मेट का अनुसरण करते हुए सिंगल-लाइन कमिट मैसेज
• स्टैंडर्ड (default): इम्प्लीमेंटेशन विवरण समझाने वाले बुलेट पॉइंट्स के साथ सारांश
• वर्बोज (-v flag): प्रेरणा, तकनीकी दृष्टिकोण, और प्रभाव विश्लेषण सहित व्यापक स्पष्टीकरण
• 50/72 नियम (--50-72 फ्लैग): git log और GitHub UI में इष्टतम पठनीयता के लिए क्लासिक कमिट मैसेज फॉर्मेट लागू करें
• DCO/Signoff (--signoff फ्लैग): Developer Certificate of Origin अनुपालन के लिए Signed-off-by लाइन जोड़ें (Cherry Studio, Linux kernel और अन्य प्रोजेक्ट्स द्वारा आवश्यक)

🌍 बहुभाषी समर्थन

• 25+ भाषाएं: अंग्रेजी, चीनी, जापानी, कोरियाई, स्पैनिश, फ्रेंच, जर्मन, और 18+ और भाषाओं में कमिट मैसेज जेनरेट करें
• लचीला अनुवाद: टूल संगतता के लिए कन्वेंशनल कमिट प्रीफिक्सेस को अंग्रेजी में रखने का विकल्प चुनें, या उन्हें पूरी तरह से अनुवाद करें
• कई वर्कफ्लोज़: uvx gac language के साथ डिफ़ॉल्ट भाषा सेट करें, या एक बार के ओवरराइड के लिए -l <language> फ्लैग का उपयोग करें
• नेटिव स्क्रिप्ट समर्थन: CJK, सिरिलिक, थाई और अन्य सहित गैर-लैटिन स्क्रिप्ट्स के लिए पूर्ण समर्थन

💻 डेवलपर अनुभव

• इंटरैक्टिव फीडबैक: रीरोल के लिए r टाइप करें, एडिट करने के लिए e (डिफ़ॉल्ट रूप से इन-प्लेस TUI, या $GAC_EDITOR अगर सेट है), या सीधे make it shorter या focus on the bug fix जैसी अपनी फीडबैक टाइप करें
• इंटरैक्टिव प्रश्न: --interactive (-i) का उपयोग करके अपने परिवर्तनों के बारे में लक्षित प्रश्नों के उत्तर दें और अधिक संदर्भात्मक कमिट संदेश प्राप्त करें
• वन-कमांड वर्कफ्लोज़: uvx gac -ayp (सभी को स्टेज करें, ऑटो-कन्फर्म करें, पुश करें) जैसे फ्लैग्स के साथ पूर्ण वर्कफ्लोज़
• Git इंटीग्रेशन: प्री-कमिट और लेफ्थुक हुक्स का सम्मान करता है, महंगे LLM ऑपरेशन से पहले उन्हें चलाता है
• MCP सर्वर: Model Context Protocol के माध्यम से AI एजेंटों को कमिट टूल्स उपलब्ध कराने के लिए uvx gac serve चलाएं

📊 उपयोग सांख्यिकी

uvx gac stats               # अवलोकन: कुल gac, स्ट्रीक, दैनिक/साप्ताहिक पीक, शीर्ष प्रोजेक्ट और मॉडल
uvx gac stats models        # मॉडल विवरण: gac, टोकन, विलंबता, गति, प्रति-कमिट विलंबता चार्ट
uvx gac stats projects      # प्रोजेक्ट विवरण: सभी रेपो में gac, कमिट, टोकन, प्रति gac औसत फ़ाइलें
uvx gac stats recent        # हालिया gac इतिहास: प्रति-gac टोकन, गति, विलंबता, फ़ाइलें (-n 20 अधिक के लिए)
uvx gac stats reset         # सभी आँकड़े रीसेट करें (पुष्टि आवश्यक)
uvx gac stats reset model <model-id>  # केवल एक विशिष्ट मॉडल के आँकड़े रीसेट करें

• अपने gac ट्रैक करें: जानें कि आपने gac के साथ कितने कमिट किए हैं, आपकी वर्तमान स्ट्रीक, पीक दैनिक/साप्ताहिक गतिविधि, और शीर्ष प्रोजेक्ट
• टोकन ट्रैकिंग: दिन, सप्ताह, प्रोजेक्ट और मॉडल के अनुसार कुल प्रॉम्प्ट और कम्प्लीशन टोकन — टोकन उपयोग के लिए भी उच्च स्कोर ट्रॉफी के साथ
• शीर्ष मॉडल: जानें कि आप कौन से मॉडल सबसे अधिक उपयोग करते हैं और प्रत्येक कितने टोकन की खपत करता है
• उच्च स्कोर उत्सव: 🏆 नए दैनिक, साप्ताहिक, टोकन, या स्ट्रीक रिकॉर्ड स्थापित करने पर ट्रॉफी; 🥈 उन्हें बराबरी करने पर
• सेटअप में ऑप्ट-इन: uvx gac init पूछता है कि क्या आप आँकड़े सक्षम करना चाहते हैं और स्पष्ट रूप से बताता है कि क्या संग्रहीत किया जाता है
• कभी भी ऑप्ट-आउट: GAC_DISABLE_STATS=true (या 1/yes/on) सेट करें अक्षम करने के लिए। false/0/no पर सेट करने (या हटाने) से आँकड़े सक्षम रहते हैं
• गोपनीयता प्राथमिकता: ~/.gac_stats.json में स्थानीय रूप से संग्रहीत। केवल गिनती, तिथियां, प्रोजेक्ट नाम और मॉडल नाम — कोई कमिट मैसेज, कोड, या व्यक्तिगत डेटा नहीं। कोई टेलीमेट्री नहीं

🛡️ बिल्ट-इन सुरक्षा

• स्वचालित रहस्य detectiion: कमिट करने से पहले API कीज, पासवर्ड, और टोकन के लिए स्कैन करता है
• इंटरैक्टिव सुरक्षा: संभावित संवेदनशील डेटा को कमिट करने से पहले स्पष्ट उपचार विकल्पों के साथ प्रॉम्प्ट करता है
• स्मार्ट फिल्टरिंग: उदाहरण फाइलों, टेम्प्लेट फाइलों, और प्लेसहोल्डर टेक्स्ट को नजरअंदाज करता है झूठी सकारात्मकताओं को कम करने के लिए

---

उपयोग के उदाहरण

बेसिक वर्कफ्लो

# अपने परिवर्तनों को स्टेज करें
git add .

# LLM के साथ जेनरेट और कमिट करें
uvx gac

# समीक्षा → y (कमिट) | n (रद्द करें) | r (रीरोल) | e (एडिट) | या फीडबैक टाइप करें

सामान्य कमांड्स

Command	Description
uvx gac	कमिट मैसेज जेनरेट करें
uvx gac -y	ऑटो-कन्फर्म (समीक्षा की आवश्यकता नहीं)
uvx gac -a	कमिट मैसेज जेनरेट करने से पहले सभी को स्टेज करें
uvx gac -S	इंटरैक्टिव रूप से स्टेज करने के लिए फाइलें चुनें
uvx gac -o	तुच्छ परिवर्तनों के लिए वन-लाइन मैसेज
uvx gac -v	प्रेरणा, तकनीकी दृष्टिकोण, और प्रभाव विश्लेषण के साथ वर्बोज फॉर्मेट
uvx gac -h "hint"	LLM के लिए संदर्भ जोड़ें (जैसे, uvx gac -h "bug fix")
uvx gac -s	स्कोप शामिल करें (जैसे, feat(auth):)
uvx gac -i	परिवर्तनों के बारे में प्रश्न पूछें बेहतर संदर्भ के लिए
uvx gac -g	परिवर्तनों को कई तार्किक कमिट्स में समूहित करें
uvx gac -p	कमिट और पुश करें
uvx gac model	AI प्रदाता और मॉडल बदलें
uvx gac stats	अपनी gac उपयोग सांख्यिकी देखें

पावर यूजर उदाहरण

# एक कमांड में पूरा वर्कफ्लो
# अपनी कमिट सांख्यिकी देखें
uvx gac stats

# सभी प्रोजेक्ट के लिए आँकड़े
uvx gac stats projects

uvx gac -ayp -h "release preparation"

# स्कोप के साथ विस्तृत स्पष्टीकरण
uvx gac -v -s

# छोटे परिवर्तनों के लिए त्वरित वन-लाइनर
uvx gac -o

# किसी विशिष्ट भाषा में कमिट मैसेज जेनरेट करें
uvx gac -l hi

# परिवर्तनों को लॉजिकल रूप से संबंधित कमिट्स में समूहित करें
uvx gac -ag

# विस्तृत आउटपुट के साथ इंटरैक्टिव मोड विस्तृत स्पष्टीकरण के लिए
uvx gac -iv

# डीबग करें कि LLM क्या देखता है
uvx gac --show-prompt

# सुरक्षा स्कैन छोड़ें (सावधानी से उपयोग करें)
uvx gac --skip-secret-scan

# DCO अनुपालन के लिए signoff जोड़ें (Cherry Studio, Linux kernel, आदि)
uvx gac --signoff

इंटरैक्टिव फीडबैक सिस्टम

परिणाम से संतुष्ट नहीं? आपके पास कई विकल्प हैं:

# सिंपल रीरोल (कोई फीडबैक नहीं)
r

# कमिट मैसेज एडिट करें
e

# या बस अपनी फीडबैक सीधे टाइप करें!
make it shorter and focus on the performance improvement
use conventional commit format with scope
explain the security implications

# प्रॉम्प्ट को फिर से देखने के लिए खाली इनपुट पर Enter दबाएं

एडिट फीचर (e) आपको कमिट मैसेज को परिष्कृत करने देता है:

• डिफ़ॉल्ट (इन-प्लेस TUI): vi/emacs कीबाइंडिंग्स के साथ मल्टी-लाइन एडिटिंग — टाइपोस सुधारें, वर्डिंग एडजस्ट करें, पुनर्गठन करें
• GAC_EDITOR के साथ: आपका पसंदीदा एडिटर खोलता है (code, vim, nano, आदि) — खोजें/बदलें, मैक्रोज़ आदि सहित पूरी एडिटर शक्ति

VS Code जैसे GUI एडिटर्स स्वचालित रूप से हैंडल किए जाते हैं: gac --wait डालता है ताकि प्रोसेस तब तक ब्लॉक रहे जब तक आप एडिटर टैब बंद न करें। कोई अतिरिक्त कॉन्फ़िगरेशन आवश्यक नहीं।

---

कॉन्फिगरेशन

अपने प्रोवाइडर को इंटरैक्टिव रूप से कॉन्फिगर करने के लिए uvx gac init चलाएं, या एनवायरमेंट वेरिएबल्स सेट करें:

बाद में प्रोवाइडर या मॉडल बदलने की जरूरत है भाषा सेटिंग्स को छुए बिना? भाषा प्रॉम्प्ट को छोड़ने वाली स्ट्रीमलाइन फ्लो के लिए uvx gac model का उपयोग करें।

सभी उपलब्ध विकल्पों के लिए .gac.env.example देखें।

दूसरी भाषा में कमिट मैसेज चाहिए? Español, Français, 日本語, और अन्य सहित 25+ भाषाओं में से चुनने के लिए uvx gac language चलाएं।

कमिट मैसेज स्टाइल को कस्टमाइज़ करना चाहते हैं? कस्टम सिस्टम प्रॉम्प्ट्स लिखने पर मार्गदर्शन के लिए docs/CUSTOM_SYSTEM_PROMPTS.md देखें।

---

सहायता प्राप्त करना

• पूर्ण दस्तावेज़: USAGE.md - पूर्ण CLI रेफरेंस
• MCP सर्वर: docs/MCP.md - AI एजेंटों के लिए GAC को MCP सर्वर के रूप में उपयोग करें
• Claude Code OAuth: docs/CLAUDE_CODE.md - Claude Code सेटअप और प्रमाणीकरण
• ChatGPT OAuth: docs/CHATGPT_OAUTH.md - ChatGPT OAuth सेटअप और प्रमाणीकरण
• कस्टम प्रॉम्प्ट्स: CUSTOM_SYSTEM_PROMPTS.md - कमिट मैसेज स्टाइल को कस्टमाइज़ करें
• उपयोग सांख्यिकी: uvx gac stats --help देखें या पूरे डॉक्स
• समस्या निवारण: TROUBLESHOOTING.md - सामान्य समस्याएं और समाधान
• योगदान: CONTRIBUTING.md - डेवलपमेंट सेटअप और दिशानिर्देश

---