OpenSpec

इंस्टॉलेशन ​

अपनी मशीन पर openspec CLI इंस्टॉल करें, उसे अपडेट करें और अनइंस्टॉल करें।

इंस्टॉल करें ​

macOS या Linux पर, अपने टर्मिनल में:

bash
curl -fsSL https://openspec.dev/cli/install.sh | sh

Windows पर, PowerShell में:

powershell
irm https://openspec.dev/cli/install.ps1 | iex

यदि इंस्टॉलर export PATH=... पंक्ति प्रिंट करता है, तो उसे चलाएँ। फिर जाँचें कि यह काम कर गया।

अपने AI सहायक के साथ इंस्टॉल करें ​

इसे अपने AI चैट में पेस्ट करें:

text
Fetch https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/install.md and follow it.

या, अपने टर्मिनल में, इसे किसी CLI एजेंट में पाइप करें (Claude Code दिखाया गया है):

bash
curl -fsSL https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/install.md | claude

यह रेपो रूट पर install.md फ़ेच करता है, जो किसी भी ऐसे एजेंट के लिए लिखा गया प्रॉम्प्ट है जो shell कमांड चला सकता है (कुछ IDE इंटीग्रेशन नहीं चला सकते)। अपने सहायक से यह अपेक्षा करें:

  1. यदि CLI पहले से आपकी मशीन पर है तो इंस्टॉल छोड़ दें, और इसे उसी तरीके से अपडेट करने की पेशकश करें जिस तरीके से इसे इंस्टॉल किया गया था। यदि वह npm या Homebrew था, तो एक बार उल्लेख करें कि openspec install स्टैंडअलोन इंस्टॉल पर स्विच करता है, बिना उस पर दबाव डाले। अन्यथा, आपको ऊपर दिया गया इंस्टॉल कमांड दिखाएँ और उसे चलाने से पहले आपकी पुष्टि का इंतज़ार करें।
  2. npm का उपयोग केवल तभी करें जब आप इसके लिए कहें या इंस्टॉलर विफल हो जाए, और यदि आपका Node 22.12.0 से पुराना है तो रुक जाएँ।
  3. सत्यापित करें कि openspec आपके PATH पर है।
  4. जिस फ़ोल्डर को वह आपका इरादा समझता है, उसका नाम बताएँ, उस AI टूल का सुझाव दें जिससे आप पहले से बात कर रहे हैं, और पूछें कि आप किन अन्य टूल्स का उपयोग करते हैं, फिर वहाँ openspec init चलाएँ (प्रोजेक्ट सेटअप चरण)।
  5. रिपोर्ट करें कि init ने क्या बनाया और आपके टूल में OpenSpec को इनवोक करने की सटीक स्पेलिंग क्या है।

यह किसी भी विशेषाधिकार वाले काम से पहले रुक जाता है और कभी भी आपकी shell स्टार्टअप फ़ाइलों को संपादित नहीं करता। ऊपर दिया गया इंस्टॉल कमांड और नीचे दिए गए पैकेज मैनेजर ही सत्य के स्रोत हैं, और प्रॉम्प्ट उन्हें आपके लिए चलाता है।

यह इंस्टॉल विधि नई है और उपयोग किए गए मॉडल के आधार पर इसके परिणाम अलग-अलग हो सकते हैं। इसका उपयोग केवल तभी करें जब आप AI की गलतियों को सुधारने में सहज हों। अन्यथा, हम नीचे दी गई मानक विधि अपनाने की सलाह देते हैं।

पैकेज मैनेजर ​

ये OpenSpec को Node.js पैकेज के रूप में इंस्टॉल करते हैं, इसलिए इन्हें Node.js 22.12.0 या उससे नया चाहिए (Homebrew और Nix अपना खुद का Node लाते हैं)। अपने टर्मिनल में:

bash
node --version

यदि यह v22.12.0 या उससे अधिक प्रिंट करता है, तो npm से इंस्टॉल करें:

npm
npm install -g @fission-ai/openspec@latest

यदि नहीं, तो nodejs.org से या अपने वर्ज़न मैनेजर (nvm, fnm, asdf, volta) के माध्यम से नया Node इंस्टॉल करें, या इसके बजाय स्टैंडअलोन इंस्टॉल का उपयोग करें।

Homebrew ​

Homebrew macOS या Linux पर OpenSpec और उसकी Node.js निर्भरता इंस्टॉल करता है। अपने टर्मिनल में:

bash
brew install openspec

फ़ॉर्मूला homebrew-core में प्रकाशित है, इसलिए आपको टैप जोड़ने की ज़रूरत नहीं है।

Yarn ​

yarn global add केवल Yarn Classic (1.x) में है। आधुनिक Yarn ने ग्लोबल इंस्टॉल हटा दिए हैं, इसलिए इसके बजाय npm, pnpm या bun का उपयोग करें। एक ग्लोबल CLI का आपके प्रोजेक्ट के पैकेज मैनेजर से मेल खाना ज़रूरी नहीं है।

Bun ​

Bun OpenSpec इंस्टॉल करता है लेकिन उसे चलाता नहीं, इसलिए आपको अभी भी अपनी मशीन पर Node चाहिए (पैकेज मैनेजर देखें)। इसके बिना, हर कमांड env: node: No such file or directory के साथ विफल हो जाता है। Bun हर Node CLI के साथ ऐसा ही व्यवहार करता है।

Deno ​

Deno CLI को npm से इंस्टॉल करता है और स्पष्ट अनुमति फ़्लैग चाहता है। अपने टर्मिनल में:

bash
deno install --global \
  --allow-read --allow-write --allow-env --allow-sys=cpus,homedir --allow-net=edge.openspec.dev \
  npm:@fission-ai/openspec@latest

कुछ कमांड किसी अन्य प्रोग्राम को लॉन्च करते हैं: openspec config edit आपका एडिटर खोलता है। Deno हर रन पर अनुमति प्रॉम्प्ट के साथ उन्हें बाधित करता है। इसे पूछते रहने से रोकने के लिए, इंस्टॉल कमांड में एक स्कोप्ड --allow-run=<program> जोड़ें।

NOTE

यदि Deno @latest को रिज़ॉल्व नहीं कर सकता, तो इसके बजाय एक वर्ज़न रेंज पिन करें: npm:@fission-ai/openspec@^1.7.0.

Nix ​

OpenSpec रेपो में एक Nix flake शामिल है। इसे अपनी प्रोफ़ाइल में इंस्टॉल करें। अपने टर्मिनल में:

bash
nix profile install github:Fission-AI/OpenSpec

या इंस्टॉल किए बिना पहले एक बार चलने वाला कमांड चलाएँ:

bash
nix run github:Fission-AI/OpenSpec -- --version

यह आपके PATH पर कुछ नहीं छोड़ता, इसलिए बाद में जाँचने के लिए कोई इंस्टॉल नहीं होता।

इसके बजाय OpenSpec को किसी प्रोजेक्ट के dev shell में रखने के लिए, flake को इनपुट के रूप में जोड़ें और उसका डिफ़ॉल्ट पैकेज उपयोग करें; flake.nix आउटपुट की सूची देता है।

Nix पैकेज मानक स्थानों (share/bash-completion/completions, share/fish/vendor_completions.d, share/zsh/site-functions) पर Bash, Fish और Zsh कम्प्लीशन स्क्रिप्ट के साथ आता है, इसलिए वे पैकेज के साथ लोड हो जाती हैं और openspec completion install चलाने की आवश्यकता नहीं है।

जाँचें कि यह काम कर गया ​

आपने जो भी विधि उपयोग की हो, अपने टर्मिनल में:

bash
openspec --version

यदि यह वर्ज़न नंबर प्रिंट करता है, तो CLI आपके PATH पर है। यह प्रति मशीन एक बार इंस्टॉल होता है।

इसके बाद, अपना प्रोजेक्ट सेट अप करें। यदि आपके सहायक ने पहले ही init चला दिया है, तो वह पेज दिखाता है कि उसने क्या लिखा और इसे कैसे समायोजित करें।

इंस्टॉल विकल्प ​

वर्ज़न या फ़ोल्डर चुनने के लिए, sh से पहले एक वेरिएबल सेट करें:

bash
curl -fsSL https://openspec.dev/cli/install.sh | OPENSPEC_VERSION=v1.15.0 sh
  • OPENSPEC_VERSION: इंस्टॉल करने के लिए रिलीज़, जैसे v1.15.0। डिफ़ॉल्ट नवीनतम रिलीज़ है।
  • OPENSPEC_INSTALL_DIR: इंस्टॉल करने का फ़ोल्डर। डिफ़ॉल्ट ~/.local/bin है (Windows: %LOCALAPPDATA%\Programs\openspec)।

Windows पर, पहले वेरिएबल सेट करें:

powershell
$env:OPENSPEC_VERSION = 'v1.15.0'
irm https://openspec.dev/cli/install.ps1 | iex

Alpine Linux पर, इंस्टॉल करने से पहले apk add libstdc++ libgcc चलाएँ।

मैन्युअली डाउनलोड करें ​

प्रत्येक रिलीज़ में प्रति कंप्यूटर एक फ़ाइल होती है:

कंप्यूटरफ़ाइल
Mac, Apple siliconopenspec-darwin-arm64.tar.gz
Mac, Intelopenspec-darwin-x64.tar.gz
Linux, arm64openspec-linux-arm64.tar.gz
Linux, x64openspec-linux-x64.tar.gz
Alpine, arm64openspec-linux-arm64-musl.tar.gz
Alpine, x64openspec-linux-x64-musl.tar.gz
Windows, arm64openspec-windows-arm64.zip
Windows, x64openspec-windows-x64.zip
  1. अपनी फ़ाइल को नवीनतम रिलीज़ से डाउनलोड करें। रिलीज़ प्रकाशित होने के कुछ मिनट बाद फ़ाइलें अटैच की जाती हैं। यदि आपकी फ़ाइल अभी सूचीबद्ध नहीं है, तो प्रतीक्षा करें और रीलोड करें, या इसे पिछली रिलीज़ से लें।
  2. इसे अनपैक करें। अपने टर्मिनल में: tar -xzf openspec-darwin-arm64.tar.gz। Windows पर, .zip पर राइट-क्लिक करें और Extract All चुनें।
  3. macOS पर, जिस फ़ोल्डर में आपने अनपैक किया है उसमें xattr -d com.apple.quarantine openspec चलाएँ। macOS ब्राउज़र में डाउनलोड की गई फ़ाइलों को तब तक ब्लॉक करता है जब तक आप ऐसा नहीं करते।
  4. openspec को अपने PATH पर किसी फ़ोल्डर में ले जाएँ, जैसे ~/.local/bin। Windows पर, openspec.exe को अपने उपयोगकर्ता PATH पर किसी फ़ोल्डर में ले जाएँ, जैसे %LOCALAPPDATA%\Programs\openspec।

डाउनलोड सत्यापित करें ​

यह जाँचने के लिए कि कोई फ़ाइल OpenSpec रिलीज़ वर्कफ़्लो द्वारा बनाई गई थी, इसे GitHub CLI के साथ चलाएँ:

bash
gh attestation verify openspec-darwin-arm64.tar.gz --repo Fission-AI/OpenSpec

यदि वर्कफ़्लो ने फ़ाइल नहीं बनाई तो यह विफल हो जाता है। इंस्टॉल कमांड पहले से ही प्रत्येक डाउनलोड को रिलीज़ के SHA256SUMS के विरुद्ध जाँचता है, इसलिए यह चरण वैकल्पिक है।

npm से स्टैंडअलोन इंस्टॉल पर स्विच करें ​

स्विच करना वैकल्पिक है; npm काम करता रहता है। आपकी सेटिंग्स और आपके प्रोजेक्ट्स बने रहते हैं; केवल प्रोग्राम बदलता है।

1. स्टैंडअलोन कॉपी इंस्टॉल करें। अपने टर्मिनल में:

bash
openspec install

यह स्टैंडअलोन openspec इंस्टॉल करता है और वह कमांड प्रिंट करता है जो आपकी npm या Homebrew कॉपी को हटाता है।

2. पुरानी कॉपी हटाएँ। यह आमतौर पर आपके PATH पर पहले आती है, इसलिए जब तक यह नहीं हटती, यही चलती रहती है। चरण 1 में प्रिंट किया गया कमांड चलाएँ, उदाहरण के लिए:

npm
npm uninstall -g @fission-ai/openspec

3. जाँचें कि कौन-सी कॉपी चलती है। एक नया टर्मिनल खोलें:

bash
openspec version

यह OpenSpec <version> (standalone) प्रिंट करना चाहिए। यदि यह इसके बजाय किसी पैकेज मैनेजर का नाम दिखाता है, तो कोई अन्य कॉपी अभी भी आपके PATH पर है: which -a openspec (Windows: where.exe openspec) हर कॉपी की सूची देता है, इसलिए बाकी को हटा दें।

किसी प्रोजेक्ट को फिर से इनिशियलाइज़ करने की आवश्यकता नहीं है। वापस स्विच करने के लिए, फ़ाइल हटाएँ और npm इंस्टॉल फिर से चलाएँ।

अपडेट करना ​

अपने टर्मिनल में, प्रत्येक उस प्रोजेक्ट में जहाँ आपने init चलाया था:

bash
openspec update

जब कोई नया CLI आता है, तो openspec update इसकी सूचना देता है और इसे आपके लिए इंस्टॉल कर सकता है; वह अपग्रेड प्रति मशीन एक बार होता है। हर रन प्रोजेक्ट की जनरेट की गई स्किल्स और कमांड्स को रीफ़्रेश करता है, जो अपने आप कभी अपडेट नहीं होते। एक अप-टू-डेट प्रोजेक्ट ✓ All 2 tool(s) up to date (v1.7.0) प्रिंट करता है।

WARNING

स्टैंडअलोन इंस्टॉल के साथ, अपनी कॉपी को उसी जगह बदलने के लिए openspec install चलाएँ; openspec update बताता है कि कोई नया CLI कब आया है। Homebrew पर, brew upgrade openspec चलाएँ। Deno पर, Deno इंस्टॉल को -f के साथ फिर से चलाएँ; इसके बिना यह इंस्टॉल किए गए कमांड को ओवरराइट नहीं करेगा। Nix पर, nix profile upgrade openspec का उपयोग करें।

NOTE

एक ग्लोबल npm इंस्टॉल एक Node इंस्टॉलेशन से जुड़ा होता है। nvm से Node वर्ज़न बदलें तो openspec कमांड साथ नहीं आता, इसलिए नए वर्ज़न के अंतर्गत इसे फिर से इंस्टॉल करें।

अनइंस्टॉल करना ​

OpenSpec को अनइंस्टॉल करने के लिए, नीचे दिए गए चरणों से गुज़रें; इनमें से कोई भी आपके सोर्स कोड को नहीं छूता। आप अपने एजेंट को इस अनुभाग पर इंगित कर सकते हैं और उसे हटाने का काम संभालने दे सकते हैं।

1. shell कम्प्लीशन्स हटाएँ, यदि आपने उन्हें सेट किया है, जबकि CLI अभी भी ऐसा कर सकता है। अपने टर्मिनल में:

bash
openspec completion uninstall

2. CLI हटाएँ। स्टैंडअलोन इंस्टॉल के लिए, ~/.local/bin/openspec हटाएँ (Windows: %LOCALAPPDATA%\Programs\openspec, और उस फ़ोल्डर को अपने उपयोगकर्ता PATH से हटाएँ)। npm के लिए, अपने टर्मिनल में:

npm
npm uninstall -g @fission-ai/openspec

Homebrew पर: brew uninstall openspec। Deno पर: deno uninstall --global openspec। Nix पर: nix profile remove openspec। आपका shell अब openspec नहीं ढूँढ पाएगा।

3. जो बचा है उसे हटाएँ, या रखें।

  • जनरेट की गई एजेंट फ़ाइलें: प्रति प्रोजेक्ट .claude/ या .agents/ जैसी डायरेक्टरीज़ के अंतर्गत openspec-* स्किल्स और opsx कमांड्स। समर्थित टूल्स प्रत्येक टूल के पाथ की सूची देता है; MiniMax Code स्किल्स को ~/.minimax/skills में रखता है।
  • पुराने वर्ज़न के अवशेष: CLAUDE.md या AGENTS.md में मार्कर ब्लॉक्स (ब्लॉक हटाएँ, फ़ाइल रखें) और ~/.codex/prompts में opsx-*.md प्रॉम्प्ट्स।
  • openspec/ फ़ोल्डर: पहले रुककर सोचें। specs/ और changes/archive/ आपके सिस्टम का रिकॉर्ड हैं, सादा Markdown जिसे OpenSpec के बिना भी आसानी से पढ़ा जा सकता है।
  • प्रति-मशीन स्टेट: ~/.config/openspec/ में सेटिंग्स और टेलीमेट्री id; ~/.local/share/openspec/ में स्कीमा ओवरराइड्स, स्टोर रजिस्ट्रेशन्स, और स्टैंडअलोन इंस्टॉल के अंतर्निहित स्कीमाज़ (binary-schemas/) (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec)। रजिस्ट्रेशन्स पॉइंटर्स हैं; जिन स्टोर रेपोज़ की ओर वे इंगित करते हैं, वे अछूते रहते हैं।