> ## 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.

# Core कमांड्स

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

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

## `forge init`

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

```bash theme={null}
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 द्वारा रेपो को छूने से पहले ही निरस्त कर देता है।

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

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

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

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

## `forge doctor`

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

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

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

## `forge catalog`

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

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

## `forge docs`

Docs ↔ code ड्रिफ्ट।

```bash theme={null}
forge docs check     # registry reconcile — commands, env vars, MCP tools, CHANGELOG
forge docs sync      # diff-driven stale-docs sweep
```

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

## `forge update`

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

```bash theme={null}
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 सूचना को शांत करता है।