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.📖 ملخص
- أوامر CLI الأساسية: chat، run، config
- الإدارة: skills، tools، ext، sessions، pkg
- 20+ أمر شرطة مائلة للوضع التفاعلي
- إخراج JSON مدعوم لتكامل السكريبتات
📝 تمارين
- أساسي (الصعوبة: ⭐): أتمم: إنشاء جلسة ← محادثة 3 جولات ← حفظ ← إعادة تحميل.
- متوسط (الصعوبة: ⭐⭐): استخدم
pi-agent runمع الأنابيب لمراجعة دفعية لملفات Python. - متقدم (الصعوبة: ⭐⭐⭐): اكتب سكريبت shell يغلف مجموعات أوامر Pi Agent الشائعة لمراجعة+إصلاح+اختبار بنقرة واحدة.