واجهة الأوامر

عميل أوامر للتحكم عن بعد بتطبيق Aura Work من الطرفية — أتمتة، CI/CD، وسير عمل قابل للبرمجة.

أداة aura CLI تتصل بتطبيق Aura Work المكتبي عبر جسر Bridge. تسمح بإنشاء المهام، متابعة الحالة، وإدارة المشاريع — كل ذلك من الطرفية. CLI مثالي للأتمتة، خطوط CI/CD، والمطورين الذين يفضلون سير العمل عبر الطرفية.

التثبيت

ثبّت CLI عبر npm:

npm install -g @aura-work/cli

أو استخدمها مباشرة مع npx:

npx @aura-work/cli status

📋 مرجع الأوامر الكامل

الأمر	الوصف	مثال
`aura status`	فحص حالة الجسر والاتصال	`aura status`
`aura pair --code <code>`	ربط CLI بالتطبيق المكتبي	`aura pair --code ABC123`
`aura projects`	عرض جميع المشاريع	`aura projects`
`aura task create`	إنشاء وبدء مهمة	`aura task create --prompt "أضف مصادقة"`
`aura task get <id>`	تفاصيل المهمة وحالتها	`aura task get task_abc123`
`aura task logs <id>`	بث سجلات تنفيذ المهمة	`aura task logs task_abc123`
`aura open task <id>`	فتح المهمة في التطبيق المكتبي	`aura open task task_abc123`

🔐 عملية الاقتران

تتصل CLI بالتطبيق المكتبي عبر جسر Bridge. إليك طريقة الإعداد:

1. افتح التطبيق المكتبي واذهب إلى الإضافات → ربط جهاز جديد
2. سيظهر رمز اقتران (صالح لمدة 10 دقائق)
3. شغّل aura pair --code <code> في الطرفية
4. CLI تحفظ رمز الجلسة في ~/.aura/config.json
5. جميع الأوامر اللاحقة تستخدم هذا الرمز للمصادقة

الاقتران ينشئ جلسة آمنة. يمكنك إلغاء الوصول في أي وقت من التطبيق المكتبي تحت الإضافات → الأجهزة المرتبطة.

🔄 أمثلة استخدام

إنشاء مهمة من الطرفية

# إنشاء مهمة في المشروع الحالي
aura task create --prompt "أصلح خطأ تسجيل الدخول في auth.ts"

# إنشاء مهمة في مشروع محدد
aura task create --project my-web-app --prompt "أضف صفحة الملف الشخصي"

# إنشاء مهمة بأذونات محددة
aura task create --prompt "أعد هيكلة قاعدة البيانات" --permissions "file,shell"

متابعة تقدم المهمة

# حالة المهمة
aura task get task_abc123

# بث مباشر للسجلات
aura task logs task_abc123

# فتح المهمة في التطبيق المكتبي للمراقبة البصرية
aura open task task_abc123

سكريبت أتمتة

#!/bin/bash
# تشغيل مهمة وانتظار اكتمالها
TASK_ID=$(aura task create --prompt "شغّل الاختبارات" --json | jq -r '.id')
echo "تم إنشاء المهمة: $TASK_ID"

# استطلاع حتى الاكتمال
while true; do
  STATUS=$(aura task get $TASK_ID --json | jq -r '.status')
  if [ "$STATUS" = "completed" ]; then
    echo "اكتملت المهمة!"
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "فشلت المهمة!"
    exit 1
  fi
  sleep 5
done

🔒 نموذج الأمان

تتصل CLI عبر جسر Bridge المحلي (المنفذ 47826). مميزات الأمان الرئيسية:

مصادقة بالجلسة — كل جلسة CLI لها رمز فريد
احترام الأذونات — CLI لا يمكنها تجاوز أي إذن، تتبع نفس ملفات الأذونات مثل التطبيق المكتبي
محلي فقط — Bridge يستمع فقط على localhost، لا وصول عن بعد
إلغاء الرمز — يمكنك إلغاء وصول CLI في أي وقت من التطبيق المكتبي
سجل التدقيق — جميع إجراءات CLI مسجلة في سجل التدقيق

⚡ التكامل مع CI/CD

استخدم CLI في خطوط الأتمتة:

# مثال GitHub Actions
name: تشغيل مهمة AI
on: push
jobs:
  ai-task:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20' }
      - run: npm install -g @aura-work/cli
      - run: aura pair --code ${{ secrets.AURA_PAIR_CODE }}
      - run: aura task create --prompt "راجع تغييرات الكود" --wait

خزّن رمز الاقتران كـ GitHub secret. العلم --wait يمنع الاستمرار حتى اكتمال المهمة.

🛠️ الإعدادات

CLI تخزّن إعداداتها في ~/.aura/config.json:

{
  "sessionToken": "abc123...",
  "bridgeHost": "localhost",
  "bridgePort": 47826,
  "defaultProject": "my-project",
  "outputFormat": "text"  // أو "json"
}

اضبط outputFormat إلى json للإخراج المقروء آلياً في السكريبتات.

أوامر متقدمة

إدارة متقدمة عبر CLI

📋 إدارة الجلسات

aura session list          # عرض الجلسات النشطة
aura session resume <id>  # استئناف جلسة سابقة
aura session kill <id>    # إنهاء جلسة

⭐ إدارة المهارات

aura skill list            # عرض المهارات المثبتة
aura skill install <name>  # تثبيت مهارة من marketplace
aura skill create          # إنشاء مهارة جديدة

🔌 إدارة MCP

aura mcp list              # عرض خوادم MCP
aura mcp add <name>        # إضافة خادم MCP
aura mcp remove <name>     # إزالة خادم MCP

☁ المزامنة

aura sync push             # رفع التغييرات للسحابة
aura sync pull              # تنزيل التغييرات من السحابة
aura sync status            # حالة المزامنة

⚙️ التكوين

aura config list           # عرض جميع الإعدادات
aura config set <k> <v>    # تعيين إعداد
aura config reset           # إعادة للإعدادات الافتراضية

📦 المشاريع

aura projects list         # عرض المشاريع
aura projects create <name> # إنشاء مشروع جديد
aura projects delete <name> # حذف مشروع