مرجع CLI

المرجع الكامل لأداة سطر أوامر squads.

npm install -g squads

squads add <sources...>

ثبّت فرقاً في مشروعك من مصادر متعددة في وقت واحد — مستودعات GitHub أو مجلدات محلية أو سجل squads.sh. يتم تحميل الفرق والتحقق منها ووضعها في مجلد squads في مشروعك.

الاستخدام
squads add <sources...> [options]
الخيارات
--skill <name>Specify which squad to install when repo has multiple squads
-a, --agent <name>Install a specific agent from the squad
-g, --globalInstall globally instead of in the current project
-y, --yesSkip confirmation prompts
--aios <mode>AIOS integration mode: new (create project) or existing (use current)
--aios-path <path>Path to the AIOS project (for existing mode)
أمثلة

Install from GitHub

squads add owner/repo

Install from local directory

squads add ./my-squad

Install from registry

squads add design-system

Install multiple squads at once

squads add slug1 slug2 slug3

Install into a new AIOS project

squads add my-squad --aios new

Install into an existing AIOS project

squads add my-squad --aios existing

Install a specific agent

squads add my-squad --agent designer

squads find [query]

ابحث في السوق عن فرق بالكلمة المفتاحية. يُرجع قائمة بالفرق المطابقة مع عدد التثبيتات والتقييمات.

الاستخدام
squads find [query] [options]
الخيارات
-l, --limit <n>Maximum number of results (default: 20)
أمثلة

Search by keyword

squads find "design system"

List all squads

squads find

squads list (ls)

اعرض جميع الفرق المثبتة في المشروع الحالي. يعرض الاسم والإصدار وعدد الوكلاء ومسار التثبيت.

الاستخدام
squads list [options]
الخيارات
-g, --globalList globally installed squads
أمثلة

List installed squads

squads list

List globally installed squads

squads list --global

squads check

تحقق من جميع الفرق المثبتة. يفحص السلامة الهيكلية والملفات المفقودة والمراجع التبادلية المعطلة.

الاستخدام
squads check
أمثلة

Check installed squads

squads check

squads update [squad]

حدّث فريقاً واحداً أو جميع الفرق المثبتة إلى أحدث إصدار. بدون اسم فريق، يحدّث الجميع.

الاستخدام
squads update [squad] [options]
الخيارات
-y, --yesSkip confirmation prompts
أمثلة

Update all squads

squads update

Update a specific squad

squads update design-system-squad

squads remove (rm) <squad>

أزل فريقاً مثبتاً من مشروعك. ينظّف مجلد الفريق وأي أوامر slash متزامنة.

الاستخدام
squads remove <squad> [options]
الخيارات
-y, --yesSkip confirmation prompts
أمثلة

Remove a squad

squads remove old-squad

Remove without confirmation

squads remove old-squad -y

squads init [name]

أنشئ مشروع فريق جديد مع الهيكل الأساسي. ينشئ بنية المجلدات وsquad.yaml وملفات البداية للوكلاء/المهام/سير العمل.

الاستخدام
squads init [name] [options]
الخيارات
-y, --yesSkip confirmation prompts and use defaults
أمثلة

Create a new squad

squads init my-squad

Create with defaults

squads init my-squad -y

squads validate [path]

شغّل تحققاً عميقاً على مجلد الفريق. يفحص 6 فئات مرجّحة (البيان، الهيكل، الوكلاء، المهام، سير العمل، المراجع المتقاطعة) وينتج درجة من 0 إلى 100.

الاستخدام
squads validate [path] [options]
الخيارات
--jsonإخراج تقرير JSON خام
--fixإصلاح المشكلات الشائعة تلقائياً قبل التحقق
أمثلة

Validate current directory

squads validate

Validate a specific squad

squads validate ./squads/my-squad

JSON output

squads validate --json

Auto-fix then validate

squads validate --fix

squads fix [path]

إصلاح مشكلات التحقق الشائعة تلقائياً في الفريق. يصلح تنسيق frontmatter وarchetypes والأنواع والنبرة ومستويات التحية. استخدم --dry-run لمعاينة التغييرات بدون تعديل الملفات.

الاستخدام
squads fix [path] [options]
الخيارات
--dry-runإظهار ما سيتم إصلاحه بدون تعديل الملفات
أمثلة

Auto-fix current squad

squads fix

Fix a specific squad

squads fix ./squads/my-squad

Preview fixes

squads fix --dry-run

squads publish [squad-name]

انشر فرقاً في سوق squads.sh. حدد عدة فرق في وقت واحد واختر المستودع الهدف.

الاستخدام
squads publish [squad-name] [options]
الخيارات
--dry-runالتحقق بدون نشر فعلي
--strictفشل إذا لم تكن حالة التحقق SAFE
--price <cents>تحديد السعر بالسنتات (مثال: 2990 لـ $29.90، 0 للمجاني)
أمثلة

اختيار متعدد من الفرق المحلية

squads publish

نشر فريق بالاسم

squads publish my-squad

النشر من مسار محدد

squads publish ./squads/my-squad

Dry run للتحقق قبل النشر

squads publish --dry-run

الوضع الصارم (يتطلب حالة SAFE)

squads publish my-squad --strict

نشر بسعر ($29.90)

squads publish --price 2990

نشر مجاناً

squads publish --price 0

squads login

قم بالمصادقة مع squads.sh باستخدام GitHub device flow. مطلوب قبل نشر الفرق.

الاستخدام
squads login
أمثلة

Authenticate via GitHub

squads login
مرجع CLI — SQUADS