> ## Documentation Index
> Fetch the complete documentation index at: https://forgekit-docs-mintlify-9e781f1d.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

<CodeGroup>
  ```bash Plugin (Claude Code / Codex) theme={null}
  /plugin marketplace add CodeWithJuber/forgekit
  /plugin install forgekit
  ```

  ```bash npm (any tool) theme={null}
  npm install -g @codewithjuber/forgekit
  ```

  ```bash No registry theme={null}
  npm install -g github:CodeWithJuber/forgekit
  ```
</CodeGroup>

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

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

<Steps>
  <Step title="हर टूल का कॉन्फ़िग निकालें">
    ```bash theme={null}
    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
    अब **समान** नियम पढ़ते हैं, प्रत्येक अपनी नेटिव फ़ाइल से।
  </Step>

  <Step title="सेटअप की हेल्थ-चेक करें">
    ```bash theme={null}
    forge doctor
    ```

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

  <Step title="बाद में कोई नियम बदलें">
    `source/rules.json` संपादित करें (या एक प्रति-रेपो `.forge/rules.json` रखें), फिर पुनः कंपाइल करें:

    ```bash theme={null}
    forge sync
    ```

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

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

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

```bash theme={null}
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
```

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

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

```bash theme={null}
forge substrate "<task>" --json   # machine-readable verdict
forge impact <symbol-or-file>     # the blast radius on its own
```

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

```bash theme={null}
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/` में दावों के रूप में उतरा।
यह प्रूफ-कैरीइंग मेमोरी है — अब यह लाभ देना शुरू करती है:

```bash theme={null}
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
```

<Card title="आगे बढ़ते रहें" icon="arrow-right" href="/hi/concepts/pre-action-gate">
  पढ़ें कि प्री-एक्शन गेट अपने चरणों को एक ही वर्डिक्ट में कैसे संयोजित करता है।
</Card>