क्विकस्टार्ट

Forge इंस्टॉल करें, एक स्रोत से हर टूल का कॉन्फ़िग निकालें, और अपना पहला प्री-एक्शन गेट चलाएँ — लगभग 60 सेकंड में।

शून्य से लेकर एक कॉन्फ़िगर किए गए रेपो और अपने पहले सब्सट्रेट चेक तक लगभग एक मिनट में पहुँचें।

​

1. इंस्टॉल करें

Plugin (Claude Code / Codex)

/plugin marketplace add CodeWithJuber/forgekit
/plugin install forgekit

npm install -g @codewithjuber/forgekit

npm install -g github:CodeWithJuber/forgekit

प्लगइन पथ Claude Code और Codex के लिए अनुशंसित है — गार्ड्स स्वतः वायर हो जाते हैं और मर्ज करने के लिए कुछ नहीं है। पूरे मैट्रिक्स के लिए Installation देखें, जिसमें symlink dev सेटअप भी शामिल है।

​

2. एक रेपो कॉन्फ़िगर करें

1. हर टूल का कॉन्फ़िग निकालें

   cd ~/your-project
   forge init
   

   यह AGENTS.md, CLAUDE.md, .gemini/settings.json, .aider.conf.yml, और बाकी निकालता है — साथ ही वह .gitattributes यूनियन-मर्ज नियम जो लेजर के लिए ज़रूरी है। Claude Code, Codex, Cursor, Gemini, Aider, Copilot, Windsurf, Zed, और Continue अब समान नियम पढ़ते हैं, प्रत्येक अपनी नेटिव फ़ाइल से।

2. सेटअप की हेल्थ-चेक करें

   forge doctor
   

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

3. बाद में कोई नियम बदलें

   source/rules.json संपादित करें (या एक प्रति-रेपो .forge/rules.json रखें), फिर पुनः कंपाइल करें:

   forge sync
   

   sync idempotent है — यह केवल वही पुनर्लिखित करता है जो बदला है।

​

3. प्री-एक्शन गेट चलाएँ

सब्सट्रेट वह परत है जो मॉडल द्वारा कोड एडिट करने से पहले चलती है। एक कमांड पूरा गेट चलाता है:

forge substrate "Change verifyToken in src/auth.js to require length > 20; update tests"
#   → assumption verdict · cheapest capable model · predicted blast radius
#     (including files you didn't name) · scope clusters · verification checklist

Claude Code पर सब्सट्रेट हर प्रॉम्प्ट पर स्वचालित रूप से एक UserPromptSubmit हुक के माध्यम से चलता है — केवल सलाहकारी, साफ़ कार्यों पर मौन। हर दूसरा टूल एक नेटिव कॉन्फ़िग नियम पाता है साथ ही 19 MCP टूल्स जिन्हें वह स्वयं कॉल कर सकता है।

अगर forge substrate ASK FIRST कहता है, तो एडिट करने से पहले लौटाए गए प्रश्न पूछें। किसी भी परिवर्तनकारी बदलाव से पहले पूर्वानुमानित प्रभावित फ़ाइलें — ब्लास्ट रेडियस — पढ़ें।

forge substrate "<task>" --json   # machine-readable verdict
forge impact <symbol-or-file>     # the blast radius on its own

​

4. अतिरिक्त सुविधाएँ खोजें

forge atlas build          # index this repo's symbols → .forge/atlas.json
forge atlas query useAuth  # where is it defined? (cheaper than grep-and-read)
forge atlas has useAuth    # does it exist? "not found" = likely hallucinated
forge recall add "db port" "Postgres is on 5433 here, not 5432"
forge catalog              # the Start-Here index of everything

​

5. दूसरा दिन: लेजर सीख रहा है

सब्सट्रेट ने दिन एक में जो कुछ सीखा वह .forge/ledger/ में दावों के रूप में उतरा। यह प्रूफ-कैरीइंग मेमोरी है — अब यह लाभ देना शुरू करती है:

forge ledger stats                              # what the repo knows, by kind and trust
forge ledger blame <id-prefix>                  # who minted a claim, every oracle outcome
forge reuse query "<what you're about to build>"  # verified code you already have

आगे बढ़ते रहें

पढ़ें कि प्री-एक्शन गेट अपने चरणों को एक ही वर्डिक्ट में कैसे संयोजित करता है।