CLI

يبدأ CLI الخاص بـ AicippY افتراضيا واجهة TUI عند تشغيله بدون أي معاملات.

aicippy-code

كما يدعم أيضا أوامر موثقة في هذه الصفحة، ما يتيح لك التفاعل مع AicippY برمجيا.

aicippy-code run "Explain how closures work in JavaScript"

---

tui

بدء واجهة المستخدم terminal (TUI) الخاصة بـ AicippY.

aicippy-code [project]

الخيارات

الخيار	المختصر	الوصف
--continue	-c	متابعة الجلسة الأخيرة
--session	-s	معرّف الجلسة للمتابعة
--fork		تفريع الجلسة عند المتابعة (يستخدم مع --continue أو --session)
--prompt		الموجّه المراد استخدامه
--model	-m	النموذج المراد استخدامه بصيغة provider/model
--agent		الوكيل المراد استخدامه
--port		المنفذ الذي يتم الاستماع عليه
--hostname		اسم المضيف الذي يتم الاستماع عليه

---

الأوامر

يتضمن CLI الخاص بـ AicippY أيضا الأوامر التالية.

---

agent

إدارة وكلاء AicippY.

aicippy-code agent [command]

---

attach

إرفاق terminal بخادم الواجهة الخلفية لـ AicippY قيد التشغيل بالفعل، والذي تم تشغيله عبر الأمرين serve أو web.

aicippy-code attach [url]

يتيح ذلك استخدام واجهة TUI مع واجهة خلفية لـ AicippY تعمل عن بعد. على سبيل المثال:

# ابدأ خادم الواجهة الخلفية للوصول عبر الويب/الجوال
aicippy-code web --port 4096 --hostname 0.0.0.0

# في محطة طرفية (terminal) أخرى، اربط TUI بالواجهة الخلفية قيد التشغيل
aicippy-code attach http://10.20.30.40:4096

الرايات

الراية	المختصر	الوصف
--dir		دليل العمل الذي ستبدأ منه واجهة TUI
--continue	-c	متابعة آخر جلسة
--session	-s	معرّف الجلسة للمتابعة
--fork		تفريع الجلسة عند المتابعة (استخدمه مع --continue أو --session)
--password	-p	كلمة مرور المصادقة الأساسية (الافتراضي AICIPPY_CODE_SERVER_PASSWORD)
--username	-u	اسم مستخدم المصادقة الأساسية (الافتراضي AICIPPY_CODE_SERVER_USERNAME أو aicippy-code)

---

create

إنشاء وكيل جديد بإعدادات مخصصة.

aicippy-code agent create

سيرشدك هذا الأمر خلال إنشاء وكيل جديد مع موجه نظام مخصص وإعدادات الأدوات.

---

list

عرض جميع الوكلاء المتاحين.

aicippy-code agent list

---

auth

أمر لإدارة بيانات الاعتماد وتسجيل الدخول لمزودي الخدمة.

aicippy-code auth [command]

---

login

يعتمد AicippY على قائمة المزودين في AicippY Models، لذا يمكنك استخدام aicippy-code auth login لتهيئة مفاتيح API لأي مزود ترغب باستخدامه. يتم حفظ ذلك في ~/.local/share/aicippy-code/auth.json.

aicippy-code auth login

عند تشغيل AicippY يقوم بتحميل المزودين من ملف بيانات الاعتماد، وكذلك أي مفاتيح معرّفة في متغيرات البيئة لديك أو في ملف .env ضمن مشروعك.

---

list

يسرد جميع المزودين الذين تم توثيقهم كما هم محفوظون في ملف بيانات الاعتماد.

aicippy-code auth list

أو النسخة المختصرة.

aicippy-code auth ls

---

logout

يسجلك خارج مزود عبر حذفه من ملف بيانات الاعتماد.

aicippy-code auth logout

---

github

إدارة وكيل GitHub لأتمتة المستودع.

aicippy-code github [command]

---

install

تثبيت وكيل GitHub في مستودعك.

aicippy-code github install

يقوم ذلك بإعداد سير عمل GitHub Actions اللازم ويرشدك خلال عملية التهيئة. اعرف المزيد.

---

run

تشغيل وكيل GitHub. يُستخدم هذا عادة ضمن GitHub Actions.

aicippy-code github run

الرايات

الراية	الوصف
--event	حدث GitHub مُحاكى لتشغيل الوكيل عليه
--token	رمز وصول شخصي لـ GitHub

---

mcp

إدارة خوادم Model Context Protocol.

aicippy-code mcp [command]

---

add

إضافة خادم MCP إلى تهيئتك.

aicippy-code mcp add

سيرشدك هذا الأمر خلال إضافة خادم MCP محلي أو بعيد.

---

list

عرض جميع خوادم MCP المُهيأة وحالة اتصالها.

aicippy-code mcp list

أو استخدم النسخة المختصرة.

aicippy-code mcp ls

---

auth

إجراء المصادقة مع خادم MCP يدعم OAuth.

aicippy-code mcp auth [name]

إذا لم تُحدِّد اسم خادم، فسيُطلب منك الاختيار من الخوادم المتاحة الداعمة لـ OAuth.

يمكنك أيضا عرض الخوادم الداعمة لـ OAuth وحالة المصادقة الخاصة بها.

aicippy-code mcp auth list

أو استخدم النسخة المختصرة.

aicippy-code mcp auth ls

---

logout

إزالة بيانات اعتماد OAuth لخادم MCP.

aicippy-code mcp logout [name]

---

debug

تشخيص مشاكل اتصال OAuth لخادم MCP.

aicippy-code mcp debug <name>

---

models

عرض جميع النماذج المتاحة من المزودين المُهيأين.

aicippy-code models [provider]

يعرض هذا الأمر جميع النماذج المتاحة عبر المزودين المُهيأين لديك بصيغة provider/model.

هذا مفيد لتحديد اسم النموذج الدقيق الذي ستستخدمه في تهيئتك.

يمكنك اختياريا تمرير معرّف مزود لتصفية النماذج حسب ذلك المزود.

aicippy-code models anthropic

الرايات

الراية	الوصف
--refresh	تحديث ذاكرة التخزين المؤقت للنماذج من models.aicippy.com
--verbose	استخدام مخرجات أكثر تفصيلا للنماذج (تشمل بيانات مثل التكاليف)

استخدم الراية --refresh لتحديث قائمة النماذج المخزنة مؤقتا. يفيد ذلك عند إضافة نماذج جديدة إلى مزود وتريد رؤيتها في AicippY.

aicippy-code models --refresh

---

run

تشغيل aicippy-code في وضع غير تفاعلي عبر تمرير موجه مباشرة.

aicippy-code run [message..]

هذا مفيد للبرمجة النصية والأتمتة، أو عندما تريد إجابة سريعة دون تشغيل واجهة TUI كاملة. على سبيل المثال.

aicippy-code run Explain the use of context in Go

يمكنك أيضا الإرفاق بمثيل aicippy-code serve قيد التشغيل لتجنّب زمن الإقلاع البارد لخوادم MCP في كل تشغيل:

# ابدأ خادمًا بلا واجهة في محطة طرفية واحدة
aicippy-code serve

# في محطة طرفية أخرى، شغّل الأوامر التي ترتبط به
aicippy-code run --attach http://localhost:4096 "Explain async/await in JavaScript"

الرايات

الراية	المختصر	الوصف
--command		الأمر المراد تشغيله؛ استخدم الرسالة كوسائط
--continue	-c	متابعة الجلسة الأخيرة
--session	-s	معرّف الجلسة للمتابعة
--fork		تفريع الجلسة عند المتابعة (يستخدم مع --continue أو --session)
--share		مشاركة الجلسة
--model	-m	النموذج المراد استخدامه بصيغة provider/model
--agent		الوكيل المراد استخدامه
--file	-f	ملف/ملفات لإرفاقها بالرسالة
--format		التنسيق: default (منسق) أو json (أحداث JSON خام)
--title		عنوان للجلسة (يستخدم موجهًا مقتطعًا إن لم تُحدَّد قيمة)
--attach		الإرفاق بخادم aicippy-code قيد التشغيل (مثل http://localhost:4096)
--password	-p	كلمة مرور المصادقة الأساسية (الافتراضي AICIPPY_CODE_SERVER_PASSWORD)
--username	-u	اسم مستخدم المصادقة الأساسية (الافتراضي AICIPPY_CODE_SERVER_USERNAME أو aicippy-code)
--dir		دليل التشغيل، أو المسار على الخادم البعيد عند الإرفاق
--variant		متغير النموذج (جهد الاستدلال الخاص بالمزود)
--thinking		عرض كتل التفكير
--port		منفذ الخادم المحلي (الافتراضي منفذ عشوائي)

---

serve

بدء خادم AicippY بدون واجهة للوصول عبر API. راجع توثيق الخادم لواجهة HTTP الكاملة.

aicippy-code serve

يشغّل هذا خادم HTTP يوفّر وصولا عبر API لوظائف aicippy-code دون واجهة TUI. اضبط AICIPPY_CODE_SERVER_PASSWORD لتفعيل مصادقة HTTP الأساسية (اسم المستخدم الافتراضي aicippy-code).

الرايات

الراية	الوصف
--port	المنفذ الذي يتم الاستماع عليه
--hostname	اسم المضيف الذي يتم الاستماع عليه
--mdns	تفعيل اكتشاف mDNS
--cors	أصول/منشأات إضافية للمتصفح للسماح بـ CORS

---

session

إدارة جلسات AicippY.

aicippy-code session [command]

---

list

عرض جميع جلسات AicippY.

aicippy-code session list

الرايات

الراية	المختصر	الوصف
--max-count	-n	حصر النتائج في أحدث N جلسات
--format		تنسيق المخرجات: table أو json (table)

---

stats

عرض إحصاءات استخدام الرموز والتكلفة لجلسات AicippY لديك.

aicippy-code stats

الرايات

الراية	الوصف
--days	عرض الإحصاءات لآخر N يومًا (الافتراضي: كل الوقت)
--tools	عدد الأدوات المطلوب عرضها (الافتراضي: الكل)
--models	عرض تفصيل استخدام النماذج (مخفي افتراضيا). مرّر رقمًا لعرض أعلى N
--project	التصفية حسب المشروع (الافتراضي: كل المشاريع، سلسلة فارغة: المشروع الحالي)

---

export

تصدير بيانات الجلسة بصيغة JSON.

aicippy-code export [sessionID]

إذا لم تُقدّم معرّف جلسة، فسيُطلب منك الاختيار من الجلسات المتاحة.

---

import

استيراد بيانات الجلسة من ملف JSON أو رابط مشاركة AicippY.

aicippy-code import <file>

يمكنك الاستيراد من ملف محلي أو من رابط مشاركة AicippY.

aicippy-code import session.json
aicippy-code import https://opncd.ai/s/abc123

---

web

بدء خادم AicippY بدون واجهة مع واجهة ويب.

aicippy-code web

يشغّل هذا خادم HTTP ويفتح متصفح ويب للوصول إلى AicippY عبر واجهة ويب. اضبط AICIPPY_CODE_SERVER_PASSWORD لتفعيل مصادقة HTTP الأساسية (اسم المستخدم الافتراضي aicippy-code).

الرايات

الراية	الوصف
--port	المنفذ الذي يتم الاستماع عليه
--hostname	اسم المضيف الذي يتم الاستماع عليه
--mdns	تفعيل اكتشاف mDNS
--cors	أصول/منشأات إضافية للمتصفح للسماح بـ CORS

---

acp

بدء خادم ACP (Agent Client Protocol).

aicippy-code acp

يشغّل هذا الأمر خادم ACP يتواصل عبر stdin/stdout باستخدام nd-JSON.

الرايات

الراية	الوصف
--cwd	دليل العمل
--port	المنفذ الذي يتم الاستماع عليه
--hostname	اسم المضيف الذي يتم الاستماع عليه

---

uninstall

إلغاء تثبيت AicippY وإزالة جميع الملفات ذات الصلة.

aicippy-code uninstall

الرايات

الراية	المختصر	الوصف
--keep-config	-c	الإبقاء على ملفات التهيئة
--keep-data	-d	الإبقاء على بيانات الجلسات واللقطات
--dry-run		عرض ما سيتم حذفه دون تنفيذ الحذف
--force	-f	تخطي مطالبات التأكيد

---

upgrade

تحديث aicippy-code إلى أحدث إصدار أو إلى إصدار محدد.

aicippy-code upgrade [target]

للترقية إلى أحدث إصدار.

aicippy-code upgrade

للترقية إلى إصدار محدد.

aicippy-code upgrade v0.1.48

الرايات

الراية	المختصر	الوصف
--method	-m	طريقة التثبيت المستخدمة: curl أو npm أو pnpm أو bun أو brew

---

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

يدعم سطر أوامر aicippy-code الخيارات العامة التالية.

الراية	المختصر	الوصف
--help	-h	عرض المساعدة
--version	-v	طباعة رقم الإصدار
--print-logs		طباعة السجلات إلى stderr
--log-level		مستوى السجل (DEBUG, INFO, WARN, ERROR)

---

متغيرات البيئة

يمكن تهيئة AicippY باستخدام متغيرات البيئة.

المتغير	النوع	الوصف
AICIPPY_CODE_AUTO_SHARE	boolean	مشاركة الجلسات تلقائيا
AICIPPY_CODE_GIT_BASH_PATH	string	مسار ملف Git Bash التنفيذي على Windows
AICIPPY_CODE_CONFIG	string	مسار ملف التهيئة
AICIPPY_CODE_CONFIG_DIR	string	مسار دليل التهيئة
AICIPPY_CODE_CONFIG_CONTENT	string	محتوى تهيئة JSON مُضمّن
AICIPPY_CODE_DISABLE_AUTOUPDATE	boolean	تعطيل التحقق التلقائي من التحديثات
AICIPPY_CODE_DISABLE_PRUNE	boolean	تعطيل تنقية البيانات القديمة
AICIPPY_CODE_DISABLE_TERMINAL_TITLE	boolean	تعطيل تحديث عنوان terminal تلقائيا
AICIPPY_CODE_PERMISSION	string	تهيئة أذونات JSON مُضمّنة
AICIPPY_CODE_DISABLE_DEFAULT_PLUGINS	boolean	تعطيل الإضافات الافتراضية
AICIPPY_CODE_DISABLE_LSP_DOWNLOAD	boolean	تعطيل تنزيل خوادم LSP تلقائيا
AICIPPY_CODE_ENABLE_EXPERIMENTAL_MODELS	boolean	تفعيل النماذج التجريبية
AICIPPY_CODE_DISABLE_AUTOCOMPACT	boolean	تعطيل ضغط السياق تلقائيا
AICIPPY_CODE_DISABLE_CLAUDE_CODE	boolean	تعطيل القراءة من .claude (الموجه + المهارات)
AICIPPY_CODE_DISABLE_CLAUDE_CODE_PROMPT	boolean	تعطيل قراءة ~/.claude/CLAUDE.md
AICIPPY_CODE_DISABLE_CLAUDE_CODE_SKILLS	boolean	تعطيل تحميل .claude/skills
AICIPPY_CODE_DISABLE_MODELS_FETCH	boolean	تعطيل جلب النماذج من مصادر بعيدة
AICIPPY_CODE_FAKE_VCS	string	مزود VCS وهمي لأغراض الاختبار
AICIPPY_CODE_CLIENT	string	معرّف العميل (الافتراضي cli)
AICIPPY_CODE_ENABLE_EXA	boolean	تفعيل أدوات بحث الويب من Exa
AICIPPY_CODE_SERVER_PASSWORD	string	تفعيل المصادقة الأساسية لخادمي serve/web
AICIPPY_CODE_SERVER_USERNAME	string	تجاوز اسم مستخدم المصادقة الأساسية (الافتراضي aicippy-code)
AICIPPY_CODE_MODELS_URL	string	رابط مخصص لجلب تهيئة النماذج

---

تجريبي

تقوم متغيرات البيئة التالية بتفعيل ميزات تجريبية قد تتغير أو تتم إزالتها.

المتغير	النوع	الوصف
AICIPPY_CODE_EXPERIMENTAL	boolean	تفعيل الميزات التجريبية الخاضعة للعلم الشامل
AICIPPY_CODE_EXPERIMENTAL_ICON_DISCOVERY	boolean	تفعيل اكتشاف الأيقونات
AICIPPY_CODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	boolean	تعطيل النسخ عند التحديد في TUI
AICIPPY_CODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	number	المهلة الافتراضية لأوامر bash بالميلي ثانية
AICIPPY_CODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX	number	الحد الأقصى لرموز المخرجات لاستجابات LLM
AICIPPY_CODE_EXPERIMENTAL_FILEWATCHER	boolean	تفعيل مراقب الملفات لكامل الدليل
AICIPPY_CODE_EXPERIMENTAL_OXFMT	boolean	تفعيل مُنسّق oxfmt
AICIPPY_CODE_EXPERIMENTAL_LSP_TOOL	boolean	تفعيل أداة LSP تجريبية
AICIPPY_CODE_EXPERIMENTAL_DISABLE_FILEWATCHER	boolean	تعطيل مراقب الملفات
AICIPPY_CODE_EXPERIMENTAL_EXA	boolean	تفعيل ميزات Exa التجريبية
AICIPPY_CODE_EXPERIMENTAL_LSP_TY	boolean	تمكين TY LSP لملفات python
AICIPPY_CODE_EXPERIMENTAL_PLAN_MODE	boolean	تفعيل وضع الخطة
AICIPPY_CODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS	boolean	تفعيل مهام subagent في الخلفية
AICIPPY_CODE_EXPERIMENTAL_EVENT_SYSTEM	boolean	تفعيل نظام الأحداث التجريبي
AICIPPY_CODE_EXPERIMENTAL_NATIVE_LLM	boolean	تفعيل مسار طلبات LLM الأصلي
AICIPPY_CODE_EXPERIMENTAL_PARALLEL	boolean	تفعيل تنفيذ بحث الويب بالتوازي
AICIPPY_CODE_EXPERIMENTAL_SCOUT	boolean	تفعيل Scout subagent
AICIPPY_CODE_EXPERIMENTAL_WORKSPACES	boolean	تفعيل دعم مساحات العمل