CLI

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

opencode

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

codetutor run "Explain how closures work in JavaScript"

---

tui

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

opencode [project]

الخيارات

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

---

الأوامر

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

---

agent

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

codetutor agent [command]

---

attach

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

codetutor attach [url]

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

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

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

الرايات

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

---

create

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

codetutor agent create

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

---

list

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

codetutor agent list

---

auth

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

codetutor auth [command]

---

login

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

codetutor auth login

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

---

list

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

codetutor auth list

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

codetutor auth ls

---

logout

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

codetutor auth logout

---

github

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

codetutor github [command]

---

install

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

codetutor github install

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

---

run

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

codetutor github run

الرايات

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

---

mcp

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

codetutor mcp [command]

---

add

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

codetutor mcp add

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

---

list

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

codetutor mcp list

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

codetutor mcp ls

---

auth

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

codetutor mcp auth [name]

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

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

codetutor mcp auth list

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

codetutor mcp auth ls

---

logout

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

codetutor mcp logout [name]

---

debug

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

codetutor mcp debug <name>

---

models

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

codetutor models [provider]

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

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

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

codetutor models anthropic

الرايات

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

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

codetutor models --refresh

---

run

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

codetutor run [message..]

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

codetutor run Explain the use of context in Go

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

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

# في محطة طرفية أخرى، شغّل الأوامر التي ترتبط به
codetutor 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		الإرفاق بخادم opencode قيد التشغيل (مثل http://localhost:4096)
--password	-p	كلمة مرور المصادقة الأساسية (الافتراضي CODETUTOR_SERVER_PASSWORD)
--username	-u	اسم مستخدم المصادقة الأساسية (الافتراضي CODETUTOR_SERVER_USERNAME أو codetutor)
--dir		دليل التشغيل، أو المسار على الخادم البعيد عند الإرفاق
--variant		متغير النموذج (جهد الاستدلال الخاص بالمزود)
--thinking		عرض كتل التفكير
--port		منفذ الخادم المحلي (الافتراضي منفذ عشوائي)

---

serve

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

codetutor serve

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

الرايات

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

---

session

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

codetutor session [command]

---

list

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

codetutor session list

الرايات

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

---

stats

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

codetutor stats

الرايات

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

---

export

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

codetutor export [sessionID]

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

---

import

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

codetutor import <file>

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

codetutor import session.json
codetutor import https://opncd.ai/s/abc123

---

web

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

codetutor web

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

الرايات

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

---

acp

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

codetutor acp

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

الرايات

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

---

uninstall

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

codetutor uninstall

الرايات

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

---

upgrade

تحديث opencode إلى أحدث إصدار أو إلى إصدار محدد.

codetutor upgrade [target]

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

codetutor upgrade

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

codetutor upgrade v0.1.48

الرايات

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

---

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

يدعم سطر أوامر opencode الخيارات العامة التالية.

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

---

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

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

المتغير	النوع	الوصف
CODETUTOR_AUTO_SHARE	boolean	مشاركة الجلسات تلقائيا
CODETUTOR_GIT_BASH_PATH	string	مسار ملف Git Bash التنفيذي على Windows
CODETUTOR_CONFIG	string	مسار ملف التهيئة
CODETUTOR_CONFIG_DIR	string	مسار دليل التهيئة
CODETUTOR_CONFIG_CONTENT	string	محتوى تهيئة JSON مُضمّن
CODETUTOR_DISABLE_AUTOUPDATE	boolean	تعطيل التحقق التلقائي من التحديثات
CODETUTOR_DISABLE_PRUNE	boolean	تعطيل تنقية البيانات القديمة
CODETUTOR_DISABLE_TERMINAL_TITLE	boolean	تعطيل تحديث عنوان terminal تلقائيا
CODETUTOR_PERMISSION	string	تهيئة أذونات JSON مُضمّنة
CODETUTOR_DISABLE_DEFAULT_PLUGINS	boolean	تعطيل الإضافات الافتراضية
CODETUTOR_DISABLE_LSP_DOWNLOAD	boolean	تعطيل تنزيل خوادم LSP تلقائيا
CODETUTOR_ENABLE_EXPERIMENTAL_MODELS	boolean	تفعيل النماذج التجريبية
CODETUTOR_DISABLE_AUTOCOMPACT	boolean	تعطيل ضغط السياق تلقائيا
CODETUTOR_DISABLE_CLAUDE_CODE	boolean	تعطيل القراءة من .claude (الموجه + المهارات)
CODETUTOR_DISABLE_CLAUDE_CODE_PROMPT	boolean	تعطيل قراءة ~/.claude/CLAUDE.md
CODETUTOR_DISABLE_CLAUDE_CODE_SKILLS	boolean	تعطيل تحميل .claude/skills
CODETUTOR_DISABLE_MODELS_FETCH	boolean	تعطيل جلب النماذج من مصادر بعيدة
CODETUTOR_FAKE_VCS	string	مزود VCS وهمي لأغراض الاختبار
CODETUTOR_CLIENT	string	معرّف العميل (الافتراضي cli)
CODETUTOR_ENABLE_EXA	boolean	تفعيل أدوات بحث الويب من Exa
CODETUTOR_SERVER_PASSWORD	string	تفعيل المصادقة الأساسية لخادمي serve/web
CODETUTOR_SERVER_USERNAME	string	تجاوز اسم مستخدم المصادقة الأساسية (الافتراضي codetutor)
CODETUTOR_MODELS_URL	string	رابط مخصص لجلب تهيئة النماذج

---

تجريبي

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

المتغير	النوع	الوصف
CODETUTOR_EXPERIMENTAL	boolean	تفعيل الميزات التجريبية الخاضعة للعلم الشامل
CODETUTOR_EXPERIMENTAL_ICON_DISCOVERY	boolean	تفعيل اكتشاف الأيقونات
CODETUTOR_EXPERIMENTAL_DISABLE_COPY_ON_SELECT	boolean	تعطيل النسخ عند التحديد في TUI
CODETUTOR_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS	number	المهلة الافتراضية لأوامر bash بالميلي ثانية
CODETUTOR_EXPERIMENTAL_OUTPUT_TOKEN_MAX	number	الحد الأقصى لرموز المخرجات لاستجابات LLM
CODETUTOR_EXPERIMENTAL_FILEWATCHER	boolean	تفعيل مراقب الملفات لكامل الدليل
CODETUTOR_EXPERIMENTAL_OXFMT	boolean	تفعيل مُنسّق oxfmt
CODETUTOR_EXPERIMENTAL_LSP_TOOL	boolean	تفعيل أداة LSP تجريبية
CODETUTOR_EXPERIMENTAL_DISABLE_FILEWATCHER	boolean	تعطيل مراقب الملفات
CODETUTOR_EXPERIMENTAL_EXA	boolean	تفعيل ميزات Exa التجريبية
CODETUTOR_EXPERIMENTAL_LSP_TY	boolean	تمكين TY LSP لملفات python
CODETUTOR_EXPERIMENTAL_PLAN_MODE	boolean	تفعيل وضع الخطة
CODETUTOR_EXPERIMENTAL_BACKGROUND_SUBAGENTS	boolean	تفعيل مهام subagent في الخلفية
CODETUTOR_EXPERIMENTAL_EVENT_SYSTEM	boolean	تفعيل نظام الأحداث التجريبي
CODETUTOR_EXPERIMENTAL_NATIVE_LLM	boolean	تفعيل مسار طلبات LLM الأصلي
CODETUTOR_EXPERIMENTAL_PARALLEL	boolean	تفعيل تنفيذ بحث الويب بالتوازي
CODETUTOR_EXPERIMENTAL_SCOUT	boolean	تفعيل Scout subagent
CODETUTOR_EXPERIMENTAL_WORKSPACES	boolean	تفعيل دعم مساحات العمل