Core कमांड्स

Forge रेपो को init, sync, doctor, catalog, docs, और update से बूटस्ट्रैप और रखरखाव करें — साथ ही profile, settings, और reversible-uninstall फ़्लैग।

Core समूह एक रेपो को बूटस्ट्रैप करता है और उसे स्वस्थ रखता है।

​

forge init

इस रेपो का कॉन्फ़िग स्कैफ़ोल्ड करें — एक साझा स्रोत से हर टूल का कॉन्फ़िग निकालता है।

forge init

AGENTS.md, CLAUDE.md, .gemini/settings.json, .aider.conf.yml, और बाकी निकालता है (साथ ही Roo Code और VS Code के लिए MCP सर्वर कॉन्फ़िग), और लेजर के लिए आवश्यक .gitattributes यूनियन-मर्ज नियम।

forge init Forge के हुक्स और अनुमतियों को ग्लोबल ~/.claude/settings.json में भी मर्ज करता है, इसलिए यह लिखने से पहले मर्ज की घोषणा करता है। मर्ज idempotent है, मार्कर-गार्डेड है, और उपयोगकर्ता की प्रविष्टियों को कभी नहीं मिटाता।

​

Init फ़्लैग

फ़्लैग	यह क्या करता है
--profile <name>	इस रेपो के लिए पॉलिसी प्रोफ़ाइल चुनें। minimal या standard (डिफ़ॉल्ट) स्वीकार करता है। अमान्य मान किसी भी स्कैफ़ोल्ड, .forge/ राइट, या मर्ज से पहले ही निरस्त कर देता है।
--no-settings	ग्लोबल ~/.claude/settings.json मर्ज को पूरी तरह छोड़ दें — केवल प्रति-रेपो कॉन्फ़िग लिखा जाता है।
--remove-settings	किसी पिछले settings मर्ज को उलटें। Forge-आकार के हुक्स, अनुमतियाँ, statusline, और _forge मार्कर हटा दिए जाते हैं; पहले एक टाइमस्टैम्प वाला बैकअप लिखा जाता है, और आपकी अपनी प्रविष्टियाँ संरक्षित रहती हैं। install.sh --uninstall द्वारा भी आह्वान किया जाता है।
--settings-only	केवल ग्लोबल settings मर्ज करें — रेपो को न छुएँ। install.sh द्वारा हुक्स और अनुमतियाँ वायर करने के लिए उपयोग किया जाता है।

यदि settings मर्ज अस्वीकार किया जाता है या त्रुटि होती है, तो forge init सफलता की रिपोर्ट करने के बजाय exit 1 के साथ विफल होता है और कारण को stderr पर लिखता है।

​

पॉलिसी प्रोफ़ाइल

--profile वह रूलसेट चुनता है जिसे forge sync प्रत्येक टूल की नेटिव कॉन्फ़िग में कंपाइल करता है। केवल दो प्रोफ़ाइल समर्थित हैं:

• standard (डिफ़ॉल्ट) — पूरा पैक: साझा मेमोरी नियम, प्रभाव विश्लेषण, और संपूर्ण गार्डरेल हुक सेट।
• minimal — छोटे रेपो या योगदानकर्ता फ़ॉर्क के लिए एक हल्का रूलसेट।

पुराने नाम web-app, backend-service, library, और regulated standard के पदावनत उपनाम हैं। वे अभी भी काम करते हैं: forge init एक बार चेतावनी देता है, standard संग्रहीत करता है, और पुराने नाम धारण करने वाले मौजूदा कॉन्फ़िग standard के रूप में sync होते हैं। नए रेपो को सीधे standard का उपयोग करना चाहिए। कोई भी अन्य मान अमान्य है और Forge द्वारा रेपो को छूने से पहले ही निरस्त कर देता है।

forge init --profile minimal            # leaner ruleset
forge init --no-settings                # per-repo only, skip the global merge
forge init --remove-settings            # reverse a past global merge

​

forge sync

कैननिकल स्रोत को हर टूल की नेटिव कॉन्फ़िग फ़ाइलों में पुनः कंपाइल करें।

forge sync

Idempotent — यह केवल वही पुनर्लिखित करता है जो बदला है। source/rules.json या प्रति-रेपो .forge/rules.json संपादित करने के बाद इसे चलाएँ।

​

forge doctor

इंस्टॉल किए गए टूल्स, गार्ड्स, MCP ऑथ, और कॉन्फ़िग ड्रिफ्ट की हेल्थ-चेक।

forge doctor

टूल्स, गार्ड्स, MCP वायरिंग, कॉन्फ़िग ड्रिफ्ट, और अपडेट स्थिति पर पास/फ़ेल। हर पथ fail-open है। जब कोई कस्टम gateway कॉन्फ़िगर हो तो एक gateway models पंक्ति हल किए गए tier → model मैपिंग को प्रिंट करती है।

​

forge catalog

Start Here — हर टूल, क्रू, और गार्ड को एक-पंक्ति कारण के साथ सूचीबद्ध करें।

forge catalog

​

forge docs

Docs ↔ code ड्रिफ्ट।

forge docs check     # registry reconcile — commands, env vars, MCP tools, CHANGELOG
forge docs sync      # diff-driven stale-docs sweep

docs check CI को fail करता है जब कमांड्स, env vars, MCP टूल्स, या CHANGELOG कोड से ड्रिफ्ट करते हैं। docs sync diff को स्वीप करता है और UPDATED / STALE / VERIFIED-UNAFFECTED रिपोर्ट करता है।

​

forge update

तीनों इंस्टॉल मोड्स में सेल्फ़-अपडेट।

forge update              # apply the update (git checkout or npm/copy install)
forge update --check      # report whether a newer version is available
forge update --to <version>   # pin or downgrade to a specific version (v0.19+)

हर पथ fail-open है — ऑफ़लाइन, कोई upstream नहीं, या detached HEAD “unknown” लौटाता है, कभी कोई error नहीं। FORGE_NO_UPDATE_CHECK=1 doctor सूचना को शांत करता है।