التثبيت

قم بتثبيت واجهة سطر الأوامر openspec على جهازك، وتحديثها، وإلغاء تثبيتها.

التثبيت

على macOS أو Linux، في الطرفية:

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

على Windows، في PowerShell:

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

إذا طبع المثبّت سطر export PATH=...، قم بتنفيذه. ثم تحقق من نجاح التثبيت.

التثبيت بمساعدة مساعد الذكاء الاصطناعي

الصق هذا في محادثة الذكاء الاصطناعي الخاصة بك:

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

أو، في الطرفية، مرّره إلى وكيل سطر الأوامر (Claude Code موضّح):

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

هذا يجلب install.md في جذر المستودع، وهو موجّه مكتوب لأي وكيل يمكنه تشغيل أوامر shell (بعض تكاملات IDE لا يمكنها ذلك). توقّع من مساعدك أن:

1. يتخطى التثبيت إذا كانت واجهة سطر الأوامر موجودة بالفعل على جهازك، ويعرض تحديثها بالطريقة التي تم تثبيتها بها. إذا كان ذلك عبر npm أو Homebrew، اذكر مرة واحدة أن openspec install ينتقل إلى التثبيت المستقل، دون الضغط عليك. وإلا، أظهر لك أمر التثبيت أعلاه وانتظر تأكيدك قبل تنفيذه.
2. يستخدم npm بدلاً من ذلك فقط إذا طلبت ذلك أو فشل المثبّت، ويتوقف إذا كان Node لديك أقدم من 22.12.0.
3. يتحقق من أن openspec موجود على PATH.
4. يذكر المجلد الذي يعتقد أنك تقصده، ويقترح أداة الذكاء الاصطناعي التي تتحدث معها بالفعل، ويسألك عن الأدوات الأخرى التي تستخدمها، ثم ينفذ openspec init هناك (خطوة إعداد المشروع).
5. يبلّغك بما أنشأه init والصيغة الدقيقة لاستدعاء OpenSpec في أداتك.

يتوقف قبل أي شيء يتطلب صلاحيات ولا يعدّل ملفات بدء تشغيل shell الخاصة بك. أمر التثبيت أعلاه ومديرو الحزم أدناه هما المصدر الموثوق، والموجّه ينفذهما نيابة عنك.

طريقة التثبيت هذه جديدة وقد تعطي نتائج متفاوتة حسب النموذج المستخدم. استخدمها فقط إذا كنت مرتاحاً لتصحيح أخطاء الذكاء الاصطناعي. وإلا نوصي باتباع الطريقة القياسية أدناه.

مديرو الحزم

هذه تثبّت OpenSpec كحزمة Node.js، لذا تحتاج إلى Node.js 22.12.0 أو أحدث (Homebrew و Nix يجلبان معهما نسختهما الخاصة). في الطرفية:

node --version

إذا طبع ذلك v22.12.0 أو أعلى، ثبّت باستخدام npm:

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

إذا لم يكن كذلك، ثبّت نسخة أحدث من Node من nodejs.org أو عبر مدير الإصدارات الخاص بك (nvm, fnm, asdf, volta)، أو استخدم التثبيت المستقل بدلاً من ذلك.

Homebrew

يثبّت Homebrew و OpenSpec واعتماديته على Node.js على macOS أو Linux. في الطرفية:

brew install openspec

الوصفة منشورة في homebrew-core، لذا لا تحتاج إلى إضافة tap.

Yarn

yarn global add مخصص لـ Yarn Classic (1.x) فقط. Yarn الحديث أزال التثبيت العام، لذا استخدم npm أو pnpm أو bun بدلاً من ذلك. لا يشترط أن تشترك واجهة سطر الأوامر العامة مع مدير حزم مشروعك.

Bun

يثبّت Bun واجهة سطر الأوامر OpenSpec لكنه لا يشغّلها، لذا ما زلت بحاجة إلى Node على جهازك (انظر مديرو الحزم). بدونه، يفشل كل أمر مع env: node: No such file or directory. Bun يعامل كل واجهة سطر أوامر Node بهذه الطريقة.

Deno

يثبّت Deno واجهة سطر الأوامر من npm ويحتاج إلى أذونات صريحة. في الطرفية:

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 يوفّر flake لـ Nix. ثبّته في ملف التعريف الخاص بك. في الطرفية:

nix profile install github:Fission-AI/OpenSpec

أو شغّل أمراً لمرة واحدة أولاً دون تثبيت:

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

هذا لا يترك شيئاً على PATH، لذا لا يوجد تثبيت للتحقق منه لاحقاً.

لوضع OpenSpec في بيئة تطوير مشروع بدلاً من ذلك، أضف الـ flake كمدخل واستخدم حزمته الافتراضية؛ flake.nix يسرد المخرجات.

حزمة Nix توفّر سكربتات الإكمال لـ Bash و Fish و Zsh في المواقع القياسية (share/bash-completion/completions، share/fish/vendor_completions.d، share/zsh/site-functions)، لذا تُحمّل مع الحزمة ولا حاجة لتشغيل openspec completion install.

تحقق من نجاح التثبيت

مهما كانت الطريقة التي استخدمتها، في الطرفية:

openspec --version

إذا طبع ذلك رقم إصدار، فهذا يعني أن واجهة سطر الأوامر موجودة على PATH. تُثبّت مرة واحدة لكل جهاز.

بعد ذلك، قم بإعداد مشروعك. إذا كان مساعدك قد شغّل init بالفعل، تُظهر تلك الصفحة ما كتبه وكيفية تعديله.

خيارات التثبيت

لاختيار إصدار أو مجلد، عيّن متغيراً قبل sh:

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، عيّن المتغير أولاً:

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

على Alpine Linux، شغّل apk add libstdc++ libgcc قبل التثبيت.

التنزيل اليدوي

كل إصدار يحتوي على ملف واحد لكل نوع جهاز:

الجهاز	الملف
Mac، Apple silicon	openspec-darwin-arm64.tar.gz
Mac، Intel	openspec-darwin-x64.tar.gz
Linux، arm64	openspec-linux-arm64.tar.gz
Linux، x64	openspec-linux-x64.tar.gz
Alpine، arm64	openspec-linux-arm64-musl.tar.gz
Alpine، x64	openspec-linux-x64-musl.tar.gz
Windows، arm64	openspec-windows-arm64.zip
Windows، x64	openspec-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:

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

يفشل إذا لم يبنِ مسار العمل الملف. أمر التثبيت يتحقق بالفعل من كل تنزيل مقابل SHA256SUMS الخاص بالإصدار، لذا هذه الخطوة اختيارية.

الانتقال من npm إلى التثبيت المستقل

الانتقال اختياري؛ npm يواصل العمل. إعداداتك ومشاريعك تبقى كما هي؛ فقط البرنامج يتغير.

1. ثبّت النسخة المستقلة. في الطرفية:

openspec install

يثبّت openspec المستقل ويطبع الأمر الذي يزيل نسختك من npm أو Homebrew.

2. أزل النسخة القديمة. عادة ما تكون الأولى على PATH الخاص بك، لذا حتى يتم حذفها تظل تعمل بدلاً منها. شغّل الأمر الذي طبعته الخطوة 1، على سبيل المثال:

npm uninstall -g @fission-ai/openspec

3. تحقق من أي نسخة تعمل. افتح طرفية جديدة:

openspec version

يجب أن يطبع OpenSpec <version> (standalone). إذا كان يذكر مدير حزم بدلاً من ذلك، فهناك نسخة أخرى لا تزال على PATH: which -a openspec (Windows: where.exe openspec) يسرد كل النسخ، لذا احذف الأخرى.

لا يحتاج أي مشروع إلى إعادة تهيئة. للعودة، احذف الملف وشغّل تثبيت npm مرة أخرى.

التحديث

في الطرفية، في كل مشروع شغّلت فيه init:

openspec update

عند صدور واجهة سطر أوامر أحدث، openspec update يخبرك بذلك ويمكنه تثبيتها لك؛ هذا الترقية تتم مرة واحدة لكل جهاز. كل تشغيل يحدّث المهارات والأوامر المولّدة للمشروع، والتي لا تتحدث من تلقاء نفسها. المشروع المحدّث يطبع ✓ All 2 tool(s) up to date (v1.7.0).

WARNING

مع التثبيت المستقل، شغّل openspec install لاستبدال نسختك في مكانها؛ openspec update يخبرك عند صدور نسخة أحدث. على Homebrew، شغّل brew upgrade openspec. على Deno، أعد تشغيل تثبيت Deno مع -f؛ لن يستبدل الأمر المثبّت بدونه. على Nix، استخدم nix profile upgrade openspec.

NOTE

التثبيت العام عبر npm ينتمي إلى تثبيت Node واحد. عند تبديل إصدارات Node باستخدام nvm، لا يأتي أمر openspec معك، لذا ثبّته مرة أخرى تحت الإصدار الجديد.

إلغاء التثبيت

لإلغاء تثبيت OpenSpec، اتبع الخطوات أدناه؛ لا شيء منها يمس الكود المصدري الخاص بك. يمكنك أيضاً توجيه وكيل الذكاء الاصطناعي الخاص بك إلى هذا القسم ليتولى عملية الإزالة.

1. أزل إكمالات shell، إذا كنت قد أعددتها، بينما لا تزال واجهة سطر الأوامر قادرة على فعل ذلك. في الطرفية:

openspec completion uninstall

2. أزل واجهة سطر الأوامر. بالنسبة للتثبيت المستقل، احذف ~/.local/bin/openspec (Windows: %LOCALAPPDATA%\Programs\openspec، واحذف هذا المجلد من PATH المستخدم الخاص بك). بالنسبة لـ npm، في الطرفية:

npm uninstall -g @fission-ai/openspec

على Homebrew: brew uninstall openspec. على Deno: deno uninstall --global openspec. على Nix: nix profile remove openspec. يجب ألا يعود shell الخاص بك يعثر على openspec.

3. احذف ما تبقى، أو احتفظ به.

• ملفات وكيل الذكاء الاصطناعي المولّدة: مهارات openspec-* وأوامر opsx تحت مجلدات مثل .claude/ أو .agents/، لكل مشروع. الأدوات المدعومة تسرد مسارات كل أداة؛ MiniMax Code يحتفظ بالمهارات في ~/.minimax/skills.
• بقايا من إصدارات أقدم: كتل مميزة في CLAUDE.md أو AGENTS.md (احذف الكتلة، واحتفظ بالملف) وموجّهات opsx-*.md في ~/.codex/prompts.
• مجلد openspec/: توقف أولاً. specs/ و changes/archive/ هما سجلك للنظام، Markdown عادي يُقرأ بشكل جيد بدون OpenSpec.
• حالة كل جهاز: الإعدادات ومعرّف القياس عن بُعد في ~/.config/openspec/؛ تجاوزات المخطط وتسجيلات المتجر والمخططات المضمّنة في التثبيت المستقل (binary-schemas/) في ~/.local/share/openspec/ (Windows: %APPDATA%\openspec, %LOCALAPPDATA%\openspec). التسجيلات هي مؤشرات؛ مستودعات المتجر التي تشير إليها لا تُمس.