CLI

أوامر وخيارات CLI في HanuBees.

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

HanuBees

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

HanuBees run "Explain how closures work in JavaScript"

tui

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

HanuBees [project]

الخيارات

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

الأوامر

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

agent

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

HanuBees agent [command]

attach

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

HanuBees attach [url]

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

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

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

الرايات

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

create

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

HanuBees agent create

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

list

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

HanuBees agent list

auth

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

HanuBees auth [command]

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

HanuBees auth login

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

list

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

HanuBees auth list

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

HanuBees auth ls

logout

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

HanuBees auth logout

github

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

HanuBees github [command]

install

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

HanuBees github install

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

run

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

HanuBees github run

الرايات

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

mcp

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

HanuBees mcp [command]

add

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

HanuBees mcp add

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

list

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

HanuBees mcp list

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

HanuBees mcp ls

auth

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

HanuBees mcp auth [name]

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

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

HanuBees mcp auth list

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

HanuBees mcp auth ls

logout

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

HanuBees mcp logout [name]

debug

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

HanuBees mcp debug <name>

models

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

HanuBees models [provider]

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

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

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

HanuBees models anthropic

الرايات

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

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

HanuBees models --refresh

run

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

HanuBees run [message..]

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

HanuBees run Explain the use of context in Go

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

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

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

serve

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

HanuBees serve

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

الرايات

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

session

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

HanuBees session [command]

list

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

HanuBees session list

الرايات

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

stats

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

HanuBees stats

الرايات

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

export

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

HanuBees export [sessionID]

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

import

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

HanuBees import <file>

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

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

web

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

HanuBees web

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

الرايات

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

acp

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

HanuBees acp

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

الرايات

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

uninstall

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

HanuBees uninstall

الرايات

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

upgrade

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

HanuBees upgrade [target]

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

HanuBees upgrade

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

HanuBees upgrade v0.1.48

الرايات

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

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

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

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

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

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

المتغير	النوع	الوصف
`HanuBees_AUTO_SHARE`	boolean	مشاركة الجلسات تلقائيا
`HanuBees_GIT_BASH_PATH`	string	مسار ملف Git Bash التنفيذي على Windows
`HanuBees_CONFIG`	string	مسار ملف التهيئة
`HanuBees_CONFIG_DIR`	string	مسار دليل التهيئة
`HanuBees_CONFIG_CONTENT`	string	محتوى تهيئة JSON مُضمّن
`HanuBees_DISABLE_AUTOUPDATE`	boolean	تعطيل التحقق التلقائي من التحديثات
`HanuBees_DISABLE_PRUNE`	boolean	تعطيل تنقية البيانات القديمة
`HanuBees_DISABLE_TERMINAL_TITLE`	boolean	تعطيل تحديث عنوان terminal تلقائيا
`HanuBees_PERMISSION`	string	تهيئة أذونات JSON مُضمّنة
`HanuBees_DISABLE_DEFAULT_PLUGINS`	boolean	تعطيل الإضافات الافتراضية
`HanuBees_DISABLE_LSP_DOWNLOAD`	boolean	تعطيل تنزيل خوادم LSP تلقائيا
`HanuBees_ENABLE_EXPERIMENTAL_MODELS`	boolean	تفعيل النماذج التجريبية
`HanuBees_DISABLE_AUTOCOMPACT`	boolean	تعطيل ضغط السياق تلقائيا
`HanuBees_DISABLE_CLAUDE_CODE`	boolean	تعطيل القراءة من `.claude` (الموجه + المهارات)
`HanuBees_DISABLE_CLAUDE_CODE_PROMPT`	boolean	تعطيل قراءة `~/.claude/CLAUDE.md`
`HanuBees_DISABLE_CLAUDE_CODE_SKILLS`	boolean	تعطيل تحميل `.claude/skills`
`HanuBees_DISABLE_MODELS_FETCH`	boolean	تعطيل جلب النماذج من مصادر بعيدة
`HanuBees_FAKE_VCS`	string	مزود VCS وهمي لأغراض الاختبار
`HanuBees_CLIENT`	string	معرّف العميل (الافتراضي `cli`)
`HanuBees_ENABLE_EXA`	boolean	تفعيل أدوات بحث الويب من Exa
`HanuBees_SERVER_PASSWORD`	string	تفعيل المصادقة الأساسية لخادمي `serve`/`web`
`HanuBees_SERVER_USERNAME`	string	تجاوز اسم مستخدم المصادقة الأساسية (الافتراضي `HanuBees`)
`HanuBees_MODELS_URL`	string	رابط مخصص لجلب تهيئة النماذج

تجريبي

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

المتغير	النوع	الوصف
`HanuBees_EXPERIMENTAL`	boolean	تفعيل الميزات التجريبية الخاضعة للعلم الشامل
`HanuBees_EXPERIMENTAL_ICON_DISCOVERY`	boolean	تفعيل اكتشاف الأيقونات
`HanuBees_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	تعطيل النسخ عند التحديد في TUI
`HanuBees_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	المهلة الافتراضية لأوامر bash بالميلي ثانية
`HanuBees_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	الحد الأقصى لرموز المخرجات لاستجابات LLM
`HanuBees_EXPERIMENTAL_FILEWATCHER`	boolean	تفعيل مراقب الملفات لكامل الدليل
`HanuBees_EXPERIMENTAL_OXFMT`	boolean	تفعيل مُنسّق oxfmt
`HanuBees_EXPERIMENTAL_LSP_TOOL`	boolean	تفعيل أداة LSP تجريبية
`HanuBees_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	تعطيل مراقب الملفات
`HanuBees_EXPERIMENTAL_EXA`	boolean	تفعيل ميزات Exa التجريبية
`HanuBees_EXPERIMENTAL_LSP_TY`	boolean	تمكين TY LSP لملفات python
`HanuBees_EXPERIMENTAL_PLAN_MODE`	boolean	تفعيل وضع الخطة
`HanuBees_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolean	تفعيل مهام subagent في الخلفية
`HanuBees_EXPERIMENTAL_EVENT_SYSTEM`	boolean	تفعيل نظام الأحداث التجريبي
`HanuBees_EXPERIMENTAL_NATIVE_LLM`	boolean	تفعيل مسار طلبات LLM الأصلي
`HanuBees_EXPERIMENTAL_PARALLEL`	boolean	تفعيل تنفيذ بحث الويب بالتوازي
`HanuBees_EXPERIMENTAL_SCOUT`	boolean	تفعيل Scout subagent
`HanuBees_EXPERIMENTAL_WORKSPACES`	boolean	تفعيل دعم مساحات العمل