Pi Agent: CLI Reference & Slash Commands

آخر تحديث: 2026-08-31

--- title: "مرجع CLI وأوامر الشرطة المائلة" description: "مرجع CLI الكامل لـ Pi Agent بما في ذلك جميع الأوامر والخيارات وأوامر الشرطة المائلة وأمثلة الاستخدام." order: 19 lang: ar

CLI هو "قمرة القيادة" لـ Pi Agent — اعرف أوامرك، تحكّم بكل شيء.


1. الخيارات العامة

BASH
pi-agent [options] [command]

Options:
  --version          عرض الإصدار
  --help             عرض المساعدة
  --config <path>    تحديد مسار ملف التكوين
  --verbose          إخراج مفصل
  --quiet            وضع صامت
  --debug            وضع التصحيح

2. الأوامر الأساسية

(1) chat - محادثة تفاعلية

BASH
pi-agent chat [options] [message]

Options:
  --provider <name>    تحديد مزوّد LLM
  --model <name>       تحديد النموذج
  --skill <name>       تحميل مهارة
  --system <prompt>    موجه النظام
  --session <name>     استعادة جلسة
  --context <file>     تحميل ملف سياق
  --sandbox            تفعيل وضع العزل

(2) run - تنفيذ غير تفاعلي

BASH
pi-agent run [options] <prompt>

Options:
  --input <file>       قراءة الإدخال من ملف
  --output <file>      الإخراج إلى ملف
  --format <type>      صيغة الإخراج (text|json|markdown)
  --skill <name>       استخدام مهارة
  --stream             إخراج متدفق
  --timeout <seconds>  مهلة

(3) config - إدارة التكوين

BASH
pi-agent config set <key> <value>
pi-agent config get <key>
pi-agent config list
pi-agent config validate

3. أوامر الأدوات والمهارات

(1) skills

BASH
pi-agent skills list
pi-agent skills show <name>
pi-agent skills create <name>
pi-agent skills install <package>
pi-agent skills remove <name>

(2) tools

BASH
pi-agent tools list
pi-agent tools show <name>
pi-agent tools test <name>

(3) ext

BASH
pi-agent ext list
pi-agent ext install <name>
pi-agent ext update <name>
pi-agent ext remove <name>
pi-agent ext create <name>
pi-agent ext publish <name>

4. أوامر الجلسات

BASH
pi-agent sessions list
pi-agent sessions show <name>
pi-agent sessions delete <name>
pi-agent sessions export <name>
pi-agent sessions search <query>

5. أوامر الحزم

BASH
pi-agent pkg search <query>
pi-agent pkg install <name>
pi-agent pkg update [name]
pi-agent pkg remove <name>
pi-agent pkg list
pi-agent pkg info <name>
pi-agent pkg build <name>
pi-agent pkg validate <name>
pi-agent pkg publish <name>

6. أوامر الشرطة المائلة (الوضع التفاعلي)

الأمر الوصف مثال
/help عرض المساعدة /help
/exit الخروج /exit
/clear مسح المحادثة /clear
/model تبديل النموذج /model deepseek-reasoner
/provider تبديل المزوّد /provider openai
/tools سرد الأدوات /tools
/use تفعيل أداة /use shell
/unuse تعطيل أداة /unuse search
/skill تحميل مهارة /skill code_review
/save حفظ الجلسة /save session.json
/load تحميل الجلسة /load session.json
/context عرض السياق /context
/history عرض السجل /history
/retry إعادة التوليد /retry
/edit تعديل آخر رسالة /edit
/theme تبديل السمة /theme dark
/trust تعيين الثقة /trust readonly
/cost إحصائيات التكلفة /cost
/branch إنشاء فرع /branch experiment

7. أمثلة تركيبات شائعة

مثال 1: سير عمل مراجعة الكود (الصعوبة: ⭐)

BASH
pi-agent chat --skill code_review --system "You are a Python expert"
# في الوضع التفاعلي:
# /use file_reader
# /use search
# Review main.py code quality
# /save review_20260828.json
# /exit

مثال 2: معالجة دفعات عبر الأنابيب (الصعوبة: ⭐⭐)

BASH
find . -name "*.py" -exec echo {} \; | pi-agent run --skill code_review "Review file list"

❓ أسئلة شائعة

س أوامر كثيرة لا يمكن حفظها؟
ج اكتب /help في الوضع التفاعلي لأوامر الشرطة المائلة. استخدم pi-agent --help للأوامر العامة.
س اختصارات الأوامر؟
ج بعض الأوامر تدعم الاختصارات: pi-agent c = pi-agent chat، pi-agent r = pi-agent run.
س إخراج JSON للسكريبتات؟
ج أضف --format json: pi-agent run "سؤال" --format json.

📖 ملخص


📝 تمارين

  1. أساسي (الصعوبة: ⭐): أتمم: إنشاء جلسة ← محادثة 3 جولات ← حفظ ← إعادة تحميل.
  2. متوسط (الصعوبة: ⭐⭐): استخدم pi-agent run مع الأنابيب لمراجعة دفعية لملفات Python.
  3. متقدم (الصعوبة: ⭐⭐⭐): اكتب سكريبت shell يغلف مجموعات أوامر Pi Agent الشائعة لمراجعة+إصلاح+اختبار بنقرة واحدة.
Web-Tutorial.com

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

100%